Lookup Number

API Reference

Lookups

Lookup a phone number

get/api/evaluate-service

Determine if a phone number supports iMessage or SMS. Useful for checking if a number is an iPhone, if it is real, or which provider to use.

Query Parameters

numberstring

The number you want to evaluate in E.164 format

Returns

numberstring

optional

The number you evaluated in E.164 format

serviceenum

optional

"iMessage" OR "SMS"

The service the number supports

Hide ParametersShow Parameters

"iMessage"

"SMS"

HTTPTypeScript

curl https://api.sendblue.co/api/evaluate-service \
    -H "sb-api-key-id: $SENDBLUE_API_API_KEY" \
    -H "sb-api-secret-key: $SENDBLUE_API_API_SECRET" \
    -d '{}'

200 Example

{
  "number": "+19999999999",
  "service": "iMessage"
}