Referencia de la API

Encontrar un código postal

Recupera el código postal registrado en el SAT a partir de un par RFC + nombre sin correr la consulta de certificados.

POST /v1/rfc/find-zip

Recupera el código postal registrado en el SAT para un par RFC + nombre vía el endpoint de consulta masiva del SAT. Omite la consulta de certificados, así que quien llama debe enviar un nombre limpio. Se completa en ~10-15s. Soporta webhook.

Útil cuando un flujo de facturación necesita el código postal pero el nombre del cliente ya está en archivo. Omitir la consulta de certificados ahorra el paso de perfil de ~1-3s.

Cuerpo de la solicitud

Campo Tipo Requerido Descripción
rfc string Sí El RFC a consultar.
name string Sí Nombre del contribuyente registrado en el SAT. Ver Formato del nombre.
webhook_url string No URL opcional para entrega asíncrona.

Pruébalo

POST /v1/rfc/find-zip
Pruébalo

Inicia sesión para enviar una solicitud real desde esta página.

Las cuentas nuevas reciben $5 USD de crédito al registrarse, sin tarjeta.

Solicitud de ejemplo

curl bash
curl -X POST https://rfccheck.com/v1/rfc/find-zip \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc": "ACME010101AAA", "name": "ACME CONSULTORES"}'

Respuesta (200)

200 OK json
{
  "rfc": "ACME010101AAA",
  "valid": true,
  "zip": "06600",
  "message": "RFC válido, y susceptible de recibir facturas"
}