Referencia de la API

# Referencia del API

Siete endpoints acotados a lo que ya conoces. Elige el que coincida con los datos que tienes.

URL base: `https://rfccheck.com/v1`. Todos los endpoints son POST, aceptan JSON y requieren el encabezado x-api-key. Elige el que se ajuste a lo que ya conoces.


| Endpoint | Entradas | Latencia | Costo | Webhook |
| --- | --- | --- | --- | --- |
| [`/rfc/validate`](/docs/endpoints/validate) | rfc | ~30s | 10 créditos | opcional |
| [`/rfc/profile`](/docs/endpoints/profile) | rfc | ~1-3s | 3 créditos | no |
| [`/rfc/find-zip`](/docs/endpoints/find-zip) | rfc, name | ~10-15s | 5 créditos | opcional |
| [`/rfc/verify`](/docs/endpoints/verify) | rfc, optionally name + zip | ~1-2s | 1 crédito | no |
| [`/rfc/sat-lists`](/docs/endpoints/sat-lists) | rfc | ~ms | Gratis bajo planes | no |
| [`/rfc/verify-batch`](/docs/endpoints/verify-batch) | hasta 5,000 registros | ~10-15s | 1 × N créditos | requerido |
| [`/rfc/commerce-registry`](/docs/endpoints/commerce-registry) Beta | rfc, optionally name | ~20-60s | 100 créditos | opcional |
| [`/cfdi/verify`](/docs/endpoints/cfdi-verify) | uuid + rfc_emisor + rfc_receptor, or xml | ~3s | 2 créditos | no |


## Cómo elegir

- **¿Solo conoces el RFC?** Usa verify para una consulta rápida de existencia (~1-2 s, 1 crédito), profile si necesitas el nombre registrado ante el SAT, la CURP y el correo de contacto (~1-3 s, 3 créditos), o validate si también quieres el código postal y las listas del SAT (~30 s, 10 créditos).
- **¿Conoces el RFC y el nombre?** Usa find-zip para recuperar el código postal (~10-15s, 5 créditos), o envía name a validate para reducir su latencia a la mitad.
- **¿Ya tienes RFC + nombre + CP?** Usa verify (modo completo) para una verificación de combinación rápida, o verify-batch si tienes muchos registros.
- **¿Evaluando una empresa?** Usa commerce-registry para obtener sus registros en el Registro Público de Comercio: régimen jurídico, socios y actos inscritos (~20-60s, 100 créditos).
- **¿Recibiste una factura?** Usa cfdi/verify para preguntarle al SAT si el CFDI está registrado, sigue vigente o fue cancelado (~3s, 5 créditos).