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 ParametersExpand Collapse

number: string

The number you want to evaluate in E.164 format

ReturnsExpand Collapse

number: optional string

The number you evaluated in E.164 format

service: optional "iMessage" or "SMS"

The service the number supports

Accepts one of the following:

"iMessage"

"SMS"

Lookup a phone number

http

• http
• typescript
• python

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"
}

Returns Examples

200 example

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