Referencia de la API

# Referencia del API

Todos los endpoints de MexCheck por registro: el SAT para RFC y facturas, RENAPO para CURP y el INE para credenciales para votar. Elige el que se ajuste a lo que ya conoces.

URL base: `https://mexcheck.com/v1`. Todos los endpoints son POST, aceptan JSON y requieren el encabezado x-api-key. La referencia completa de cada endpoint está en el sitio del producto que lo documenta.

## RFC y CFDI (SAT)


| Endpoint | Entradas | Latencia | Costo |
| --- | --- | --- | --- |
| [`/rfc/validate`](https://rfccheck.com/es/docs/endpoints/validate) | rfc | 7–11 s | 10 créditos |
| [`/rfc/profile`](https://rfccheck.com/es/docs/endpoints/profile) | rfc | 1–3 s | 3 créditos |
| [`/rfc/find-zip`](https://rfccheck.com/es/docs/endpoints/find-zip) | rfc, name | 7–9 s | 5 créditos |
| [`/rfc/verify`](https://rfccheck.com/es/docs/endpoints/verify) | rfc, optionally name + zip | 1–2 s | 1 crédito |
| [`/rfc/sat-lists`](https://rfccheck.com/es/docs/endpoints/sat-lists) | rfc | ~ms | Gratis bajo planes |
| [`/rfc/verify-batch`](https://rfccheck.com/es/docs/endpoints/verify-batch) | hasta 5,000 registros | 10–15 s | 1 × N créditos |
| [`/cfdi/verify`](https://rfccheck.com/es/docs/endpoints/cfdi-verify) | uuid + rfc_emisor + rfc_receptor, or xml | ~3 s | 5 créditos |
| [`/csf/verify`](https://rfccheck.com/es/docs/endpoints/csf-verify) | file, qr, or rfc + id_cif | ~2 s | 5 créditos |


## CURP (RENAPO)


| Endpoint | Entradas | Latencia | Costo |
| --- | --- | --- | --- |
| [`/curp/lookup`](https://curpcheck.com/es/docs/endpoints/curp-lookup) | curp | ~2 s | 5 créditos |
| [`/curp/search`](https://curpcheck.com/es/docs/endpoints/curp-search) | names, paternal_surname, birthdate, sex, state | ~2 s | 5 créditos |


## Credencial para votar (INE)


| Endpoint | Entradas | Latencia | Costo |
| --- | --- | --- | --- |
| [`/ine/verify`](https://inecheck.com/es/docs/endpoints/ine-verify) | cic, id_ciudadano o ocr | 4–15 s | 10 créditos |


## Comprobante de domicilio (CFE)

Respondido por CFE: si un recibo de luz es suyo, con el domicilio de su propia copia. Documentado aquí en MexCheck.


| Endpoint | Entradas | Latencia | Costo |
| --- | --- | --- | --- |
| [`/cfe/verify`](/es/docs/endpoints/cfe-verify) | file o service_number, name, total | 2–10 s | 50 créditos |


## Geografía

Se responden desde nuestra copia del catálogo de códigos postales de Correos de México, actualizada a diario. Estos dos se documentan aquí, en MexCheck.


| Endpoint | Entradas | Latencia | Costo |
| --- | --- | --- | --- |
| [`/geo/zip`](/es/docs/endpoints/geo-zip) | zip | ~ms | Gratis bajo planes |
| [`/geo/zip-search`](/es/docs/endpoints/geo-zip-search) | state, municipality, settlement, zip | ~ms | Gratis bajo planes |


## Cómo elegir

- **¿Das de alta a una empresa?** Valida su RFC para conocer su registro y su representante legal, y confirma que no aparezca en las listas del SAT.
- **¿Das de alta a una persona?** Confirma su CURP con RENAPO y su credencial para votar con el INE, y su RFC con el SAT si factura.
- **¿Vas a pagar o deducir una factura?** Revisa el estatus de su CFDI antes de hacerlo.
- **¿Recibiste una Constancia de Situación Fiscal?** Envía el PDF a csf/verify: lee el domicilio fiscal, los regímenes, las actividades económicas y las obligaciones fiscales, y el SAT confirma la fecha de emisión y los datos vigentes.
- **¿Recibes un comprobante de domicilio?** Envía el recibo de CFE a cfe/verify: CFE confirma que es suyo, y su copia da el domicilio aunque el archivo haya sido editado.
- **¿Llenando o revisando una dirección?** Envía el código postal a geo/zip para obtener su estado, municipio y colonias, o busca por lugar en geo/zip-search cuando lo que falta es el código postal.