API Reference

Find a postal code

Recover the SAT-registered postal code from an RFC + name pair without running the cert lookup.

POST /v1/rfc/find-zip

Recover the SAT-registered postal code for an RFC + name pair via SAT's massive consultation endpoint. Skips the cert lookup, so callers must provide a clean name. Completes in ~10-15s. Webhook supported.

Use this when an invoicing flow needs the zip code but the customer name is already on file. Skipping the cert lookup saves the ~1-3s profile step.

Request body

Field Type Required Description
rfc string Yes The RFC to look up.
name string Yes SAT-registered taxpayer name. See Name formatting.
webhook_url string No Optional URL for async delivery.

Try it

POST /v1/rfc/find-zip
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/find-zip \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc": "ACME010101AAA", "name": "ACME CONSULTORES"}'

Response (200)

200 OK json
{
  "rfc": "ACME010101AAA",
  "valid": true,
  "zip": "06600",
  "message": "RFC vĂ¡lido, y susceptible de recibir facturas"
}