Lookup Number

API Reference

Lookups

Lookup a phone number

client.lookups.lookupNumber(LookupLookupNumberParams { number } query, RequestOptionsoptions?): LookupLookupNumberResponse { number, service }

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

query: LookupLookupNumberParams { number }

number: string

The number you want to evaluate in E.164 format

ReturnsExpand Collapse

LookupLookupNumberResponse { number, service }

number?: string

The number you evaluated in E.164 format

service?: "iMessage" | "SMS"

The service the number supports

Accepts one of the following:

"iMessage"

"SMS"

Lookup a phone number

typescript

• http
• typescript
• python

import SendblueAPI from 'sendblue';

const client = new SendblueAPI({
  apiKey: 'My API Key',
  apiSecret: 'My API Secret',
});

const response = await client.lookups.lookupNumber({ number: '+19999999999' });

console.log(response.number);

200 example

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

Returns Examples

200 example

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