Quickstart

This guide uses synthetic numbers and placeholder credentials. Replace them only inside your own controlled backend or terminal.

Prerequisites

An active DNC LATAM organization.
A country entitlement for mx or ar.
A live API key created in the DNC LATAM dashboard.
A secure server-side environment. Do not call the API from browser code.

Store the API key securely

Keep the key in your secret manager or a local environment variable. Never commit it, paste it into AI chat, or expose it to a browser.

export DNC_LATAM_API_KEY="dnc_live_YOUR_KEY"

Generate an idempotency key

Create one random UUID for this logical request. Reuse it only if you retry the exact same country and phone array.

export DNC_LATAM_IDEMPOTENCY_KEY="$(uuidgen)"

Submit a synthetic batch

The example deliberately contains one invalid value so the complete response shape is visible.

curl https://api.dnclatam.com/v1/scrub \
  -X POST \
  -H "Authorization: Bearer ${DNC_LATAM_API_KEY}" \
  -H "Idempotency-Key: ${DNC_LATAM_IDEMPOTENCY_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "mx",
    "phones": ["+52 55 1234 5678", "55 8765 4321", "abc"]
  }'

Interpret the response

A successful request returns HTTP 200:

{
  "prohibited_numbers_to_call": ["+52 55 1234 5678"],
  "safe_numbers_to_call": ["55 8765 4321"],
  "invalid_numbers": [
    {
      "input": "abc",
      "reason": "unparseable"
    }
  ],
  "summary": {
    "total_checked": 3,
    "prohibited_numbers": 1,
    "safe_numbers": 1,
    "invalid_numbers": 1
  }
}

summary.total_checked includes every submitted input, including duplicates and invalid values.

safe_numbers_to_call means that the number was not found in the selected DNC registry at the time of this check. It does not prove consent or compliance with every other calling rule.

Example phone numbers are illustrative. Their sample classification explains the response format and is not a statement about the live registry.

Verify zero data retention

Every API response includes:

x-retention: zero

Customer phone numbers exist only in request memory. DNC LATAM persists aggregate usage counts, not the request body, phone numbers, or response.

Next steps

Authentication

Store and send Bearer API keys safely.

Idempotency

Implement exact retries without double-counting usage.

Error handling

Handle quotas, rate limits, conflicts, and temporary capacity.

Response dictionary

Review field-by-field semantics and invariants.

Getting started

Core concepts

Reliability and privacy

Use with AI

API reference

Prerequisites

Verify zero data retention

Next steps

Authentication

Idempotency

Error handling

Response dictionary

​Prerequisites

​Verify zero data retention

​Next steps

Authentication

Idempotency

Error handling

Response dictionary

Prerequisites

Verify zero data retention

Next steps