Skip to main content
POST
/
numbers
/
lookup
/
batch
Batch lookup phone numbers
curl --request POST \
  --url https://api-message.nativehub.live/api/v1/numbers/lookup/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "numbers": [
    "+8801712345678",
    "+8801812345679",
    "+8801912345680"
  ]
}
'
[
  {
    "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
​
numbers
string[]
required

Response

200 - application/json

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