API Reference

# Look up a taxpayer profile

Return the SAT-registered personal data: name and CURP (individuals), company name and legal representative (companies), plus the contact email on file.

POST

`/v1/rfc/profile`

Look up the registered taxpayer's personal data from SAT. For persona física: the legal name and CURP, plus the contact email on file. For persona moral: the company name, legal representative's RFC + CURP, and the company's registered contact email. The data ships embedded in the digital certificates (CSD/FIEL) that SAT publishes, but you get the parsed fields directly. Completes in 1 to 3 seconds.

Use for KYC checks, pre-filling customer records, and any flow that needs SAT-registered personal data without typing it in by hand.

## Request body

If certificates are missing or their portal is unavailable, this endpoint verifies registration using SAT's registry. The fallback sets source to sat_registry, leaves name null and certs empty, and costs 1 credit when answered. A complete certificate profile costs 3 credits. If registration cannot be checked either, found is null and no credits are charged.


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `rfc` | string | Yes | The RFC to look up (12 or 13 characters). |


## Example request

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"}'
```

## Response (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 is true (SAT returned a registered taxpayer), false (SAT has no record), or null (SAT unreachable, retry).