Phone inputs

The request body contains one registry country and an array of phone-number strings:

{
  "country": "mx",
  "phones": ["+52 55 1234 5678", "55 8765 4321"]
}

Registry country

Value	Registry
`mx`	Mexico — REPEP
`ar`	Argentina — Registro Nacional No Llame

All inputs in one request are interpreted against the selected country. Split mixed-country data into separate requests with separate idempotency keys.

Accepted formats

The API accepts supported local and international formats and normalizes them before performing an exact match against the selected registry. Examples of supported Mexico representations:

+52 55 1234 5678
55 1234 5678
(55) 1234-5678

Examples of supported Argentina representations:

+54 9 11 1234-5678
011 15-1234-5678
11 1234 5678

The API returns the original string in the corresponding response array. It does not replace your input with the internal canonical representation.

Structural validation

Validation determines whether an input can be normalized for matching. It does not verify that a number is assigned, active, reachable, or owned by a specific person.

Reason	Meaning
`empty`	The input is empty or contains only phone-number separators.
`unparseable`	The input cannot be interpreted as a phone number.
`wrong_country`	An explicit country code does not match the requested registry country.
`too_short`	The normalized national number has too few digits.
`too_long`	The normalized national number has too many digits.

Invalid inputs are returned per item and do not fail the rest of the batch:

{
  "input": "abc",
  "reason": "unparseable"
}

Duplicates

Every submitted array element counts as one checked input. If the same number appears three times, it is counted and returned three times. The service may deduplicate normalized values internally for lookup efficiency, but the response preserves occurrences and relative order within each response category.

Getting started

Core concepts

Reliability and privacy

Use with AI

API reference

Registry country

Accepted formats

Structural validation

Duplicates

​Registry country

​Accepted formats

​Structural validation

​Duplicates

Registry country

Accepted formats

Structural validation

Duplicates