> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dnclatam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Phone inputs

> Choose the registry country and understand accepted phone formats and invalid reason codes.

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

```json theme={null}
{
  "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:

```text theme={null}
+52 55 1234 5678
55 1234 5678
(55) 1234-5678
```

Examples of supported Argentina representations:

```text theme={null}
+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:

```json theme={null}
{
  "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.