Skip to main content
POST
Phone Lookup

Authentication

Requires an API key in the Authorization header.

Request

query
string
required
The phone number to look up. Include the country code (e.g. +14155552671).

Example request

Response

query
string
The original query submitted.
phone
string
The normalized phone number.
valid
boolean
Whether the phone number is valid.
format
object
Phone number formats.
country
object
Country and location details.
type
string
Line type: mobile, landline, voip, toll_free, etc.
carrier
object
Carrier information.
messaging
object
SMS gateway information.
validation
object
Validation and activity signals.
registration
object
Registration information.
risk
object
Risk assessment.
breaches
object
Breach exposure data.
credits
integer
Credits consumed (always 1).

Example response

200 OK

Notes

  • This endpoint costs 1 credit per lookup.
  • Include the country code for best results (e.g. +1 for US, +44 for UK).
  • All sections (messaging, validation, registration, risk, breaches) are returned when available from the upstream provider.