Lookup iMessage support

GET/api/evaluate-service

Check iMessage support for a phone number or email address. A successful result does not guarantee delivery. For email addresses, SMS means iMessage was not detected; it does not mean the address can receive SMS. The from_number query parameter does not select a sending line for this endpoint. Email results indicating no iMessage support are not cached. An inconclusive lookup returns a retryable error. Limit retries and use backoff after an inconclusive response. A lookup does not guarantee that upstream availability data was freshly refreshed.

Query ParametersExpand Collapse

number: string

The phone number in E.164 format or email address to evaluate

ReturnsExpand Collapse

number: optional string

The normalized phone number or email address evaluated

service: optional "iMessage" or "SMS"

Whether iMessage support was detected

One of the following:

"iMessage"

"SMS"

Lookup iMessage support

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"

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

Returns Examples

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