Referencia de la API

# Referencia del API

Todos los endpoints de RFCCheck y cuándo usar cada uno: validación de RFC, perfil, código postal, listas 69-B, verificación masiva, CFDI y Constancia de Situación Fiscal.

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`](/es/docs/endpoints/validate) | rfc | 7–11 s | 10 créditos | opcional |
| [`/rfc/profile`](/es/docs/endpoints/profile) | rfc | 1–3 s | 3 créditos | no |
| [`/rfc/find-zip`](/es/docs/endpoints/find-zip) | rfc, name | 7–9 s | 5 créditos | opcional |
| [`/rfc/verify`](/es/docs/endpoints/verify) | rfc, optionally name + zip | 1–2 s | 1 crédito | no |
| [`/rfc/sat-lists`](/es/docs/endpoints/sat-lists) | rfc | ~ms | Gratis bajo planes | no |
| [`/rfc/verify-batch`](/es/docs/endpoints/verify-batch) | hasta 5,000 registros | 10–15 s | 1 × N créditos | requerido |
| [`/rfc/commerce-registry`](/es/docs/endpoints/commerce-registry) Beta | rfc, optionally name | 20–60 s | 100 créditos | opcional |
| [`/cfdi/verify`](/es/docs/endpoints/cfdi-verify) | uuid + rfc_emisor + rfc_receptor, or xml | ~3 s | 5 créditos | no |
| [`/csf/verify`](/es/docs/endpoints/csf-verify) | file, qr, or rfc + id_cif | ~2 s | 5 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 (7–11 s, 10 créditos).
- **¿Conoces el RFC y el nombre?** Usa find-zip para recuperar el código postal (7–9 s, 5 créditos), o envía name a validate para que responda más rápido.
- **¿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–60 s, 100 créditos).
- **¿Recibiste una factura?** Usa cfdi/verify para preguntarle al SAT si el CFDI está registrado, sigue vigente o fue cancelado (~3 s, 5 créditos).
- **¿Recibiste una Constancia de Situación Fiscal?** Usa csf/verify para leer su domicilio fiscal, regímenes, actividades económicas y obligaciones fiscales, y para que el SAT confirme cuándo se emitió y qué está vigente (~2 s, 5 créditos).