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