API service

Identify valid numbers and available line information

Phone Number Identify validates an international number and returns normalized phone, type, carrier, location, and country information when available.

GET /services/phonenumber

View API documentation Create account

How it works

Normalize and understand submitted phone data

The service parses an international number, validates it for its detected region, normalizes the display format, and returns the available line type, carrier, location, and country code metadata.

Carrier and location metadata are not available for every valid number. A valid result can therefore contain UNDETECT or an empty location without making the number invalid.

Response fieldsGET /services/phonenumber

isValidShows whether the number is valid for its detected region

typeLine category such as MOBILE, FIXED_LINE, VOIP, or another supported type

carrierCarrier name when metadata is available

locationGeographic description when metadata is available

countryCodeDetected two-letter region code for the number

Integration examples

Identify a phone number from your stack

Submit an international number in E.164 format and parse its validity, normalized number, line type, carrier, location, and country code.

Replace the sample number and allow for a valid result where carrier or location metadata is unavailable. Read the complete Phone Number Identify documentation.

Mobile phone interface with information panels

Core capabilities

What Phone Number Identify provides

International validation

Parses numbers supplied in an international format and validates them against regional numbering rules.

Normalized output

Returns a consistently formatted international phone number for valid input.

Line classification

Identifies supported line categories including mobile, fixed line, toll-free, premium-rate, VoIP, and others.

Available metadata

Returns carrier, location, and country code information when the underlying numbering metadata provides it.

Use cases

Where Phone Number Identify fits

Account onboarding

Validate and normalize a number before it is stored on a customer profile.

Checkout forms

Catch invalid number input while retaining a consistent international format.

Contact analysis

Use line type, carrier, and region information as context in your own workflow.

Start using Phone Number Identify

Create an account, configure the service in the Stopbot panel, and follow the integration documentation for your application.

Create account Compare plans