Number Lookup
AI-generatedSummary
Validates and enriches a phone number through the Sinch Number Intelligence API, returning selected carrier, country, line type, porting, and risk details.
Inputs
- phoneNumber (required) — The phone number to lookup. E.164 format recommended. Before the API call, all characters except digits and '+' are removed.
- lookupType — The type of lookup to perform: Standard (basic validation and carrier info) or Enhanced (detailed information including porting status).
- returnFields — Which fields to include in the response: carrier, country, lineType, porting, or riskScore. Defaults to carrier, lineType, and country.
Output shape
phoneNumber, countryCode, numberType, valid, validation { valid, formatted }, plus any selected optional fields: carrier, lineType, country, riskScore, ported.
One output item per input item. Fields omitted by Return Fields are not present in the output.
Examples
Example 1: Validate a phone number before sending SMS in a customer onboarding flow.
Looks up a phone number and returns carrier, line type, and country.