API Reference

# API Reference

Every RFCCheck endpoint and when to use it: full RFC validation, taxpayer profile, postal code, SAT 69-B lists, batch verification, CFDI status, and Constancia de Situación Fiscal.

Base URL: `https://rfccheck.com/v1`. All endpoints are POST, accept JSON, and require the x-api-key header. Pick the one scoped to what you already know.


| Endpoint | Inputs | Latency | Cost | Webhook |
| --- | --- | --- | --- | --- |
| [`/rfc/validate`](/docs/endpoints/validate) | rfc | 7–11 s | 10 credits | optional |
| [`/rfc/profile`](/docs/endpoints/profile) | rfc | 1–3 s | 3 credits | no |
| [`/rfc/find-zip`](/docs/endpoints/find-zip) | rfc, name | 7–9 s | 5 credits | optional |
| [`/rfc/verify`](/docs/endpoints/verify) | rfc, optionally name + zip | 1–2 s | 1 credit | no |
| [`/rfc/sat-lists`](/docs/endpoints/sat-lists) | rfc | ~ms | Free under plans | no |
| [`/rfc/verify-batch`](/docs/endpoints/verify-batch) | up to 5,000 records | 10–15 s | 1 × N credits | required |
| [`/rfc/commerce-registry`](/docs/endpoints/commerce-registry) Beta | rfc, optionally name | 20–60 s | 100 credits | optional |
| [`/cfdi/verify`](/docs/endpoints/cfdi-verify) | uuid + rfc_emisor + rfc_receptor, or xml | ~3 s | 5 credits | no |
| [`/csf/verify`](/docs/endpoints/csf-verify) | file, qr, or rfc + id_cif | ~2 s | 5 credits | no |


## How to choose

- **Know only the RFC?** Use verify for a fast existence check (1–2 s, 1 credit), profile if you need the SAT-registered name, CURP, and contact email (1–3 s, 3 credits), or validate if you also want the zip and SAT lists (7–11 s, 10 credits).
- **Know the RFC and the name?** Use find-zip to recover the postal code (7–9 s, 5 credits), or pass name to validate to make it faster.
- **Have RFC + name + zip already?** Use verify (full mode) for a fast combo check, or verify-batch if you have many records.
- **Vetting a company?** Use commerce-registry for its Registro Público de Comercio records: legal regime, shareholders, and registered acts (20–60 s, 100 credits).
- **Received a factura?** Use cfdi/verify to ask SAT whether the CFDI is registered, still current, or cancelled (~3 s, 5 credits).
- **Received a Constancia de Situación Fiscal?** Use csf/verify to read its fiscal address, regimes, economic activities, and tax obligations, and have SAT confirm when it was issued and what is current (~2 s, 5 credits).