Skip to main content
GET
/
numbers
/
lookup
/
{phone}
Get number lookup by phone
curl --request GET \
  --url https://api-message.nativehub.live/api/v1/numbers/lookup/{phone} \
  --header 'Authorization: Bearer <token>'
{
  "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.

Path Parameters

​
phone
string
required

Phone number in E.164 format

Response

Number lookup retrieved successfully

​
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>