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

Try it

POST /v1/rfc/profile
Try it

Sign in to send a real request from this page.

New accounts get a $5 USD signup credit, no card required.

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