> ## 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.

# Country coverage

> Public country catalog and country-independent API behavior. Mexico, Argentina, and Colombia are live. Spain, Australia, and Singapore are coming end of September 2026.

The API has one public contract for every country. Select the country with the
`country` field and send the same array shape to v1 or v2. The integration
method, government credentials, retries, provider cost, and internal capacity
are never chosen or exposed by the client.

## Catalog

| Code | Coverage                                      | Public behavior                                                                                                                                                        |
| ---- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mx` | Mexico — REPEP / PROFECO                      | Snapshot-backed coverage. It does not require DNC LATAM to buy query credits.                                                                                          |
| `ar` | Argentina — Registro Nacional No Llame / AAIP | Free coverage for DNC LATAM. It uses the same quota and error contract as every country.                                                                               |
| `co` | Colombia — RNE / CRC                          | Enabled government API-backed coverage. A successful payment activates synchronous v1, durable v2, and panel CSV access immediately; no manual activation is required. |
| `es` | Spain, Lista Robinson / ADIGITAL              | Coming end of September 2026 (not live yet). Prepaid capacity and activation stay internal until catalog and runtime release together.                                 |
| `au` | Australia, Do Not Call Register / ACMA        | Coming end of September 2026 (not live yet). SOAP/SFTP and government details stay internal until catalog and runtime release together.                                |
| `sg` | Singapore, Do Not Call Registry / PDPC        | Coming end of September 2026 (not live yet). On-Behalf access, throttling, and cost controls stay internal until catalog and runtime release together.                 |

The current commercial catalog is `mx`, `ar`, and `co`. Spain, Australia, and
Singapore are coming end of September 2026 (not live yet). The `es`, `au`,
and `sg` codes remain in the technical API contract for forward-compatible
schema documentation. The catalog is not an entitlement or
availability promise: a country must be included in the organization's
Country Purchase and operationally available at admission. Colombia is
currently sellable and operational; its Country Purchase becomes active as
soon as the initial invoice is paid, without an approval or activation step.
A paid prepaid
country that is not manually activated returns
`503 country_service_temporarily_unavailable`; the API never exposes
`pending_activation`, Registry Capacity, provider balances, or the reason for
the operational block. Colombia requests still fail closed during a provider
outage or an operator maintenance window, without exposing provider details.

## Shared semantics

* v1 returns one complete result synchronously for at most 10,000 inputs and
  25 MiB of JSON body, whichever limit is reached first.
* v2 accepts at most 500,000 inputs and 25 MiB of JSON body, whichever limit is
  reached first, and returns a durable job.
* A country maintenance window returns
  `country_service_maintenance`; other temporary failures return
  `country_service_temporarily_unavailable`.
* Country service failures never produce partial results and do not consume
  Customer Quota.
* `customer_quota_exceeded` is a commercial quota error, distinct from a
  country service failure.

Country-specific operational dossiers are maintained internally for
[Colombia](https://github.com/MatiSolina/dnclatam/blob/main/docs/operations/colombia-contract.md),
[Spain](https://github.com/MatiSolina/dnclatam/blob/main/docs/operations/spain-contract.md),
[Australia](https://github.com/MatiSolina/dnclatam/blob/main/docs/operations/australia-contract.md),
and [Singapore](https://github.com/MatiSolina/dnclatam/blob/main/docs/operations/singapore-contract.md).
Those documents describe implementation gates; they do not change this public
API contract.
