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 rfc 7–11 s 10 créditos opcional
/rfc/profile rfc 1–3 s 3 créditos no
/rfc/find-zip rfc, name 7–9 s 5 créditos opcional
/rfc/verify rfc, optionally name + zip 1–2 s 1 crédito no
/rfc/sat-lists rfc ~ms Gratis bajo planes no
/rfc/verify-batch hasta 5,000 registros 10–15 s 1 × N créditos requerido
/rfc/commerce-registry Beta rfc, optionally name 20–60 s 100 créditos opcional
/cfdi/verify uuid + rfc_emisor + rfc_receptor, or xml ~3 s 5 créditos no
/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).