Skip to main content
GET
Look up a phone number
Requires the number_intelligence entitlement.
The path parameter must be an E.164 number.
By default this returns carrier, CNAM, and porting data. imessage and facetime are null unless you set those query flags to true. The two flags are independent. contiguity_risk_scoring_beta=true requires both imessage=true and facetime=true. Otherwise the request fails with 400. When risk scoring is returned, imessage and facetime are booleans (never null). Score and confidence both range from 0.00 to 0.99. Useful in conjunction with other fraud signals to determine if a user is risky.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

number
string
required

Phone number in E.164 format.

Example:

"+13129457420"

Query Parameters

imessage
enum<string> | null
default:false

Set to true to include iMessage availability. Independent of facetime. Required (with facetime=true) for contiguity_risk_scoring_beta.

Available options:
true,
false
Example:

"false"

facetime
enum<string> | null
default:false

Set to true to include FaceTime availability. Independent of imessage. Required (with imessage=true) for contiguity_risk_scoring_beta.

Available options:
true,
false
Example:

"false"

contiguity_risk_scoring_beta
enum<string> | null
default:false

Set to true to include Contiguity risk scoring. Requires imessage=true and facetime=true; otherwise the request fails with 400. When this is returned, imessage and facetime are never null.

Available options:
true,
false
Example:

"false"

Response

Returns carrier, CNAM, and porting data for an E.164 number. Optional query flags add iMessage availability, FaceTime availability, and Contiguity risk scoring. Risk scoring requires both availability flags; when it is returned, imessage and facetime are booleans (never null). Requires the number_intelligence entitlement. Rate limited to 6 requests per minute.

id
string
required
Example:

"req_xxxxxxxxxxxxxxxx"

timestamp
number
required
Example:

1790546990555

api_version
string
required
Example:

"v2026.9.27"

object
string
required
Example:

"response"

data
Without risk scoring · object
required

Carrier lookup. imessage and facetime are booleans only when those query flags are true; otherwise null. contiguity_risk_scoring_beta is always null.

Example: