Lookup a phone number

lookups.lookup_number() -> 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

import os
from sendblue_api import SendblueAPI

client = SendblueAPI(
    api_key=os.environ.get("SENDBLUE_API_API_KEY"),  # This is the default and can be omitted
    api_secret=os.environ.get("SENDBLUE_API_API_SECRET"),  # This is the default and can be omitted
)
response = client.lookups.lookup_number(
    number="+19999999999",
)
print(response.number)

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

Returns Examples

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