# Latamref Tax ID Validator

> Latamref Tax ID Validator is a paid API for AI agents from latamref.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Validates Latin American tax IDs and VAT numbers using official format rules and check-digit algorithms, returning validity, normalised form, ID type, and failure reason

## Facts

- Endpoint: GET https://latamref.dev/v1/taxid/validate?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/latamref-tax-id-validator-bbc127a9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RCqiqy0auInkDUqxYw2qV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability latamref-tax-id-validator-bbc127a9
```

Example prompt: Can you check if the Brazilian CNPJ 11.222.333/0001-81 is valid and give me its normalised form?

## When to prefer this

Choose this endpoint when you need fast, offline algorithmic validation of Latin American tax IDs (CPF, CNPJ, RUT, NIT, RFC, RUC, CUIT, etc.) with check-digit verification cited to official sources. Prefer it over generic VAT validators that lack LatAm-specific rules, and over registry-lookup services when you only need format/algorithm correctness rather than live registration status. Ideal for KYC pipelines, invoice validation, and data cleansing where sub-second latency and no PII transmission to a registry is important.

## Known failure modes

- Unsupported country code returns an error indicating the country is not in coverage
- Malformed or empty id parameter returns a 400-level error
- Country code not matching a supported LatAm jurisdiction returns an unsupported country error
- Non-tax-ID strings (random text) return invalid with a format-mismatch failure reason
- Network or server errors return 5xx responses

## How this service works

Tax-ID / VAT-number validation for Latin American countries: valid/invalid, normalised form, id type and the reason it failed. Format plus the official check-digit algorithm where the tax authority publishes one; every rule cited to an official source with its date. Pure algorithmic, no registry lookup

## Output

Returns a JSON object indicating whether the tax ID is valid or invalid, the normalised (canonical) form of the ID, the ID type (e.g. CPF, CNPJ, RUT, NIT, RFC), and if invalid, the specific reason for failure (e.g. check-digit mismatch, wrong length, invalid characters). All rules are algorithmically applied per official tax authority specifications with cited sources — no live registry lookup is performed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country",
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "The tax ID / VAT number as written (spaces, dots, dashes and the VAT country prefix are accepted)"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 country code on this brand (see GET /v1/taxid/coverage)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/latamref-tax-id-validator-bbc127a9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from latamref.dev](https://www.zero.xyz/host/latamref.dev/llms.txt)