Referencia de la API

Consultar el perfil de un contribuyente

Devuelve los datos personales registrados en el SAT: nombre y CURP (personas físicas), razón social y representante legal (empresas), además del correo de contacto en archivo.

POST /v1/rfc/profile

Consulta los datos personales que el SAT tiene registrados para un contribuyente. Para persona física: el nombre legal y la CURP, además del correo de contacto en archivo. Para persona moral: la razón social, el RFC + CURP del representante legal y el correo de contacto registrado por la empresa. Los datos vienen embebidos en los certificados digitales (CSD/FIEL) que el SAT publica, pero los recibes ya parseados como campos directos. Se completa en aproximadamente 1-3 segundos.

Útil para verificaciones KYC, pre-llenado de registros de clientes y cualquier flujo que necesite los datos personales registrados en el SAT sin tener que capturarlos a mano.

Cuerpo de la solicitud

Si no hay certificados o su portal no está disponible, este endpoint verifica la inscripción en el padrón del SAT. En ese caso, source es sat_registry, name es null y certs está vacío; una verificación respondida cuesta 1 crédito. Un perfil completo con certificados cuesta 3 créditos. Si tampoco se puede verificar la inscripción, found es null y no se cobran créditos.

Campo Tipo Requerido Descripción
rfc string Sí El RFC a consultar (12 o 13 caracteres).

Pruébalo

POST /v1/rfc/profile
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/profile \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc": "ACME010101AAA"}'

Respuesta (200)

200 OK json
{
  "rfc": "ACME010101AAA",
  "found": true,
  "name": "ACME CONSULTORES",
  "message": "Registered taxpayer profile retrieved from SAT",
  "email": "[email protected]",
  "legal_representative_rfc": "UIOJ750110R13",
  "legal_representative_curp": "UIOJ750110HDFRRN09",
  "certs": [
    {
      "serial": "00001000000500000001",
      "status": "Activo",
      "type": "FIEL",
      "valid_from_utc": "2020-01-15T00:00:00Z",
      "valid_to_utc": "2024-01-15T00:00:00Z",
      "email": "[email protected]",
      "legal_representative_rfc": "UIOJ750110R13",
      "legal_representative_curp": "UIOJ750110HDFRRN09",
      "cer_base64": "MIIF..."
    }
  ]
}

found es true (el SAT devolvió un contribuyente registrado), false (el SAT no tiene registro) o null (SAT no disponible, reintenta).