current_carrier

current_carrier tells you which mobile operator serves the phone number today. If the number was ported, this is the operator it was ported to, not the one that issued it. Use issuing_carrier for the original operator and porting_timestamp to know whether and when the number was ported.

Request

Send the number and current_carrier in commands. No other input is needed.

{
  "number": "+12025550143",
  "commands": ["current_carrier"]
}

Response

{
  "status": 0,
  "status_message": "Response from one supplier",
  "current_carrier": {
    "lrn": "2025550000",
    "mcc": "310",
    "mnc": "012",
    "name": "Verizon Wireless",
    "spid": "6006",
    "ocn": "6006"
  },
  "version": "..."
}

Field	Type	Meaning
`name`	string	The commercial name of the operator serving the number.
`mcc`	string	Mobile Country Code of that operator.
`mnc`	string	Mobile Network Code of that operator. Read it as a string: leading zeros matter (`012` is not `12`).
`spid`	string	Service Provider ID, the identifier of the operator in the North American number portability system.
`lrn`	string	Location Routing Number, used to route calls to a ported number in North America.
`ocn`	string	Operating Company Number of the operator, used in North America.

Only the fields the source holds are returned: the others are left out, never sent as null. spid, lrn and ocn are North American identifiers and are usually absent for numbers elsewhere. mcc and mnc can be absent for a fixed line.

When there is no current_carrier block

If the source holds no network for the number or could not be reached, the response has no current_carrier block. The status is 4, and the status_message names current_carrier among the commands that returned no data. If the number's country is not covered, the status is 2, or 4 when other commands were served.

Billing

A response with a current_carrier block is charged. A response without it is not charged.

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

Response (ported)

{
  "number": "+19177777777",
  "current_carrier": {
    "mcc": "310",
    "mnc": "410",
    "name": "Cingular Wireless/2",
    "spid": "152006",
    "ocn": "6214"
  },
  "ported": true,
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=4] [{current_carrier=SUPPLIER0 : Success}]",
  "version": "1.0.2-20260608095239"
}

Response (not ported)

{
  "number": "+12025550171",
  "current_carrier": {
    "lrn": "2025550100",
    "mcc": "311",
    "mnc": "480",
    "name": "Verizon Wireless",
    "spid": "6697",
    "ocn": "5461"
  },
  "ported": false,
  "status": 0,
  "status_message": "Response from one supplier - This response is for demo purpose only [cmd_enc=4] [{current_carrier=SUPPLIER0 : Success}]",
  "version": "1.0.2-20260608095239"
}