API Reference

API Reference

Every MexCheck endpoint by registry: SAT for RFCs and invoices, RENAPO for CURPs, INE for voter IDs. Pick the one scoped to what you already know.

Base URL: https://mexcheck.com/v1. All endpoints are POST, accept JSON, and require the x-api-key header. Each endpoint's full reference lives on the product site that documents it.

RFC and CFDI (SAT)

Endpoint Inputs Latency Cost
/rfc/validate rfc 7–11 s 10 credits
/rfc/profile rfc 1–3 s 3 credits
/rfc/find-zip rfc, name 7–9 s 5 credits
/rfc/verify rfc, optionally name + zip 1–2 s 1 credit
/rfc/sat-lists rfc ~ms Free under plans
/rfc/verify-batch up to 5,000 records 10–15 s 1 × N credits
/cfdi/verify uuid + rfc_emisor + rfc_receptor, or xml ~3 s 5 credits
/csf/verify file, qr, or rfc + id_cif ~2 s 5 credits

CURP (RENAPO)

Endpoint Inputs Latency Cost
/curp/lookup curp ~2 s 5 credits
/curp/search names, paternal_surname, birthdate, sex, state ~2 s 5 credits

Voter ID (INE)

Endpoint Inputs Latency Cost
/ine/verify cic, id_ciudadano or ocr 4–15 s 10 credits

Proof of address (CFE)

Answered by CFE: whether an electricity receipt is its own, with the address on its own copy. Documented here on MexCheck.

Endpoint Inputs Latency Cost
/cfe/verify file or service_number, name, total 2–10 s 50 credits

Geography

Answered from our copy of Correos de México's zip code catalogue, refreshed daily. These two are documented here on MexCheck.

Endpoint Inputs Latency Cost
/geo/zip zip ~ms Free under plans
/geo/zip-search state, municipality, settlement, zip ~ms Free under plans

How to choose

  • Onboarding a company? Validate its RFC for its registration and legal representative, and check that it is not on the SAT lists.
  • Onboarding a person? Confirm their CURP with RENAPO and their voter ID with INE, and their RFC with SAT if they invoice.
  • Paying or deducting an invoice? Check its CFDI status before you do.
  • Received a Constancia de Situación Fiscal? Send the PDF to csf/verify: it reads the fiscal address, regimes, economic activities, and tax obligations, and SAT confirms the issue date and the current data.
  • Taking a proof of address? Send the CFE receipt to cfe/verify: CFE confirms it is its own, and its copy gives the address even when the file was edited.
  • Filling in or checking an address? Send the zip code to geo/zip for its state, municipality, and colonias, or search geo/zip-search by place when the zip code is what is missing.