api

Validación SAT / RFC

Valida que un RFC tenga formato estructural correcto y dígito verificador (homoclave) válido. La validación se hace localmente sin consultar al SAT — útil para validar antes de enviar a otros servicios.

¿Necesitas verificar contra SAT 69-B?

Para consultar la lista negra de personas morales del SAT (Artículo 69-B), usa el endpoint de Listas PLD / AML con services.sat.sat69b: true.


Endpoint

POST/api/v1/government/mx/rfc/validate

Valida formato y dígito verificador de un RFC

Headers

HeaderValorRequerido
AuthorizationBearer <api-key-jwt>
Content-Typeapplication/json

Body

NombreTipoRequeridoDescripcion
rfcstringRFC a validar. Personas físicas: 13 caracteres (4 letras + 6 dígitos fecha + 3 alfanum). Personas morales: 12 caracteres (3 letras + 6 dígitos fecha + 3 alfanum).

Ejemplo

curl -X POST https://services.api.jaak.ai/api/v1/government/mx/rfc/validate \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"rfc": "PEGJ800115QJ8"}'

Respuesta exitosa (200 OK)

{
  "eventId": "evt_789xyz",
  "requestId": "req_012abc",
  "timestamp": "2026-04-25T10:30:00Z",
  "rfc": "PEGJ800115QJ8",
  "valid": true,
  "type": "RFC"
}
CampoDescripción
validtrue si el formato + dígito verificador son correctos.
type"RFC" para físicas, "RFC_MORAL" para morales.

Respuesta de RFC inválido (200 OK)

{
  "eventId": "evt_789xyz",
  "requestId": "req_012abc",
  "timestamp": "2026-04-25T10:30:00Z",
  "rfc": "INVALIDO123",
  "valid": false,
  "type": "RFC"
}

Errores

HTTPerrorCodeDescripción
400GOV_RFC_002Formato del RFC inválido (longitud o caracteres ilegales)
401API Key inválida
500GOV_RFC_001Error interno