Skip to main content
POST
/
numbers
/
lookup
Lookup phone number
curl --request POST \
  --url https://api-message.nativehub.live/api/v1/numbers/lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "+8801712345678"
}
'
{
  "id": "d6e7f8a9-b0c1-2345-de67-890123456789",
  "phone": "+8801712345678",
  "country_code": "BD",
  "country_name": "Bangladesh",
  "carrier": "Grameenphone",
  "is_ported": false,
  "is_mobile": true,
  "mcc": "470",
  "mnc": "01",
  "created_at": "2026-02-14T10:30:00Z"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
phone
string
required

Response

Number lookup successful

id
string<uuid>
phone
string
country_code
string
country_name
string
carrier
string
is_ported
boolean
is_mobile
boolean
mcc
string
mnc
string
created_at
string<date-time>