Lookup Number

API Reference

Lookups

Lookup a phone number

lookups.lookup_number(LookupLookupNumberParams**kwargs) -> LookupLookupNumberResponse

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.

ParametersExpand Collapse

number: str

The number you want to evaluate in E.164 format

ReturnsExpand Collapse

class LookupLookupNumberResponse: …

number: Optional[str]

The number you evaluated in E.164 format

service: Optional[Literal["iMessage", "SMS"]]

The service the number supports

Accepts one of the following:

"iMessage"

"SMS"

Lookup a phone number

python

• http
• typescript
• python

from sendblue_api import SendblueAPI

client = SendblueAPI(
    api_key="My API Key",
    api_secret="My API Secret",
)
response = client.lookups.lookup_number(
    number="+19999999999",
)
print(response.number)

200 example

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

Returns Examples

200 example

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