tenure_period

The tenure_period command verifies whether an MNO contract was signed more than a specified number of days ago.

Response Reference

Field Name Data Type Output Values Description

Field Name	Data Type	Output Values	Description
tenure	Signed Integer	0, 1, -1, -2, omitted	0 → The account has NOT been active for the PERIOD provided. 1 → The account has been ACTIVE at least as long as the PERIOD provided. -1 → Not available -2 → Not allowed. omitted → if the service returns "Status": 1 or 2
status_message	String	tenure AUTH FAILED	tenure AUTH FAILED → this message is returned where only the tenure is requested, and it is not authorized by the MNO.

tenure

Signed Integer

0, 1, -1, -2, omitted

0 → The account has NOT been active for the PERIOD provided.

1 → The account has been ACTIVE at least as long as the PERIOD provided.

-1 → Not available

-2 → Not allowed.

omitted → if the service returns "Status": 1 or 2

status_message String tenure AUTH FAILED tenure AUTH FAILED → this message is returned where only the tenure is requested, and it is not authorized by the MNO.

Summary Table

Command	Description	Response Values
`tenure_period`	Verifies the longevity of the mobile account by checking if the subscription has been active for a minimum specified period.	0: Account active for less than the requested period 1: Account active for at least the requested period -1 / -2: Data unavailable or authorization denied

API reference

Request

curl -X POST "https://api.connect.plumma.it/services/api" \
-H "Content-Type: application/json" \
-H "x-plumma-connect-api-key: YOUR_API_KEY_HERE" \
-H "x-plumma-connect-app-id: YOUR_APP_ID_HERE" \
-d '{
  "number": "+16469817679",
  "commands": [
    "tenure_period"
  ],
  "tenure_period": 5
}'

Response (active for period)

{
  "number": "+12125550142",
  "tenure": 1,
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=131072] [{tenure_period=SUPPLIER0 : Success}]",
  "version": "1.0.2-20260608095239"
}

Response (not active for period)

{
  "number": "+447700900456",
  "tenure": 0,
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=131072] [{tenure_period=SUPPLIER0 : Success}]",
  "version": "1.0.2-20260608095239"
}

Response (not available)

{
  "number": "+34611222333",
  "tenure": -1,
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=131072] [{tenure_period=SUPPLIER0 : Success}]",
  "version": "1.0.2-20260608095239"
}

Response (not allowed)

{
  "number": "+393273339145",
  "tenure": -2,
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=131072] [{tenure_period=SUPPLIER0 : Success}]",
  "version": "1.0.2-20260608095239"
}

Response (unauthorized)

{
  "number": "+390612345678",
  "status": 2,
  "status_message": "tenure AUTH FAILED",
  "version": "1.0.2-20260608095239"
}

Read this in the portal, with search and the reference beside it: Tenure Period