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). |


## 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": "contacto@empresa-ejemplo.com",
  "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": "contacto@empresa-ejemplo.com",
      "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).