Skip to main content
GET
/
lookup
/
phone
cURL
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

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