network_presence

The network_presence command identifies whether the queried mobile number is currently assigned to an active subscriber by its serving network operator. This information is retrieved in real-time via a live query into the global mobile signaling network.

It is important to note that the connectivity required to fetch network_presence data and the resulting coverage is not universal. Availability varies by country and even by specific operators within the same region.

For the most current coverage list of countries and operators supported by Plumma® CONNECT, please contact your account manager.

Response Reference

Value (String)	Meaning	Description
yes	Present	The number is allocated to a subscriber by the mobile network operator and has recently connected to or interacted with that operator.
no	Absent	The number is either unallocated or has been allocated to a subscriber who has not recently connected to or interacted with that operator.
destination not covered	Unknown	The number belongs to an operator or country not covered by the `network_presence` datapoint, or the signaling network experienced congestion and could not resolve the request.
Omitted	Field Not Provided	The field will be omitted from the response if the Plumma® CONNECT service returns "Status": 1 or 2.

Summary Table

Command	Description	Response Values
`network_presence`	Confirms if the mobile number is currently registered and active on the network.	yes: Subscriber is present/active no: Subscriber is absent/inactive destination not covered: Status is unknown or out of coverage

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": "+393330000001",
  "commands": [
    "network_presence"
  ]
}'

Response (subscriber present, data active)

{
  "number": "+393330000001",
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=1024] [{network_presence=SUPPLIER0 : Success}]",
  "present": "yes",
  "connectivity_status": "CONNECTED_DATA",
  "version": "1.0.2-20260608095239"
}

Response (subscriber present, sms only)

{
  "number": "+393330000002",
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=1024] [{network_presence=SUPPLIER0 : Success}]",
  "present": "yes",
  "connectivity_status": "CONNECTED_SMS",
  "version": "1.0.2-20260608095239"
}

Response (subscriber absent)

{
  "number": "+393330000003",
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=1024] [{network_presence=SUPPLIER0 : Success}]",
  "present": "no",
  "connectivity_status": "NOT_CONNECTED",
  "version": "1.0.2-20260608095239"
}

Response (destination not covered)

{
  "number": "+260970000001",
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=1024] [{network_presence=SUPPLIER0 : OK}]",
  "present": "destination not covered",
  "version": "1.0.2-20260608095239"
}

Read this in the portal, with search and the reference beside it: Network Presence