GET
/
lookup
/
phone
curl --request GET \
  --url https://api.simpu.co/lookup/phone \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "phone": "2348089672786"
}'
{
  "msisdn": "2348089672786",
  "operator": "MTN",
  "country": "Nigeria",
  "ported": false,
  "dnd": false
}

Authorizations

​
Authorization
string
header
required

An API key to authenticate requests

Body

application/json
Lookup phone object
​
phone
string
required

The phone number to be looked up

Example:

"2348089672786"

Response

200
application/json
Lookup phone response
​
msisdn
string
required

The phone number looked up

Example:

"2348089672786"

​
operator
string

The carrier of the phone number

Example:

"MTN"

​
country
string

The country of the phone number

Example:

"Nigeria"

​
ported
boolean

The ported status of the phone number

Example:

false

​
dnd
boolean

The DND status of the phone number

Example:

false

Send SMSSMS Final Status Codes