API Reference

Bulk verify

Verify up to 5,000 RFC + name + zip records in a single SAT round-trip. Webhook required.

POST /v1/rfc/verify-batch

Bulk-verify up to 5,000 RFC + name + zip records in a single SAT round-trip. ~10-15s for the whole batch, so the per-record cost is tiny when amortized. Webhook required: there is no synchronous mode.

Request body

Field Type Required Description
records array Yes Up to 5,000 objects. Each must contain rfc, name, and zip.
webhook_url string Yes URL the batch result is POSTed to once SAT replies.

Try it

POST /v1/rfc/verify-batch
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/verify-batch \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {"rfc": "ACME010101AAA", "name": "ACME CONSULTORES", "zip": "06600"},
      {"rfc": "JUPL850101AAA", "name": "JUAN PEREZ LOPEZ", "zip": "11000"}
    ],
    "webhook_url": "https://example.com/webhooks/rfc"
  }'

Response (202)

202 Accepted json
{
  "status": "processing",
  "message": "Batch verification in progress"
}

Webhook payload

POST to your webhook_url json
{
  "status": 200,
  "body": {
    "count": 2,
    "results": [
      {"rfc": "ACME010101AAA", "name": "ACME CONSULTORES", "zip": "06600", "valid": true, "message": "..."},
      {"rfc": "JUPL850101AAA", "name": "JUAN PEREZ LOPEZ", "zip": "11000", "valid": false, "message": "..."}
    ]
  }
}