Welcome

VerifyMX is a production-grade identity verification API built for the Mexican market. It is a drop-in replacement for MetaMap (Mati) with full API compatibility for common flows, plus native support for Mexican government documents (INE, CURP, RFC, passport).

Documentation Index

Available today — integrate against the REST API directly:

Document	Description
Getting Started	Create an account, get a token, run your first verification in minutes
API Reference	Complete endpoint reference with request/response schemas and curl examples
Webhooks	Event types, payload format, signature verification, retry schedule
Mexican Documents	INE, CURP, RFC, passport — field maps, validation rules, MRZ format
Security	Auth model, encryption, data privacy, rate limits, audit logging
Node.js SDK	Official typed wrapper for Node.js / TypeScript backends (@verifymx/sdk-node)

Próximamente — described but not yet released. Use the REST API in the meantime:

Document	Status	Description
Web SDK	🚧 Coming soon	Drop-in verification widget for browsers (CDN + npm)

Base URL

https://api.verifymx.xyz

All endpoints are versioned under /v1. The OpenAPI spec is available at:

GET /v1/openapi.json

An interactive Swagger UI is served at /docs.

Quick Example

# 1. Register
curl -s -X POST https://api.verifymx.xyz/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"orgName":"Acme Corp","email":"dev@acme.mx","password":"supersecretpass123"}' \
  | jq '.apiKey.key'

# 2. Get a bearer token using your API key
TOKEN=$(curl -s -X POST https://api.verifymx.xyz/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"client_credentials","client_id":"<orgId>","client_secret":"<apiKey>"}' \
  | jq -r '.access_token')

# 3. Create a workflow
curl -s -X POST https://api.verifymx.xyz/v1/workflows \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"INE + Selfie","steps":[{"type":"DOCUMENT_OCR","order":0},{"type":"FACE_MATCH","order":1}]}'

# 4. Create a verification
curl -s -X POST https://api.verifymx.xyz/v1/verifications \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"workflowId":"<workflowId>"}'

Support

• OpenAPI spec: GET /v1/openapi.json
• Swagger UI: /docs
• Rate limit: 10 requests/second per org (burst allowed)