Skip to main content

​
1. Request access

While our self-serve portal is in development, email support@origoid.com with:
  • Legal name and RFC
  • Use case
  • Estimated monthly volume
You will receive your API key by a secure channel. Store it safely; it is shown only once and cannot be recovered.

​
2. Your first call — validate a CURP

curl -X POST https://api.origoid.com/mex/renapo/v1/curp-validations \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "curp": "PELJ900101HDFRRN09"
  }'

​
3. Expected response

Every endpoint returns the same envelope: 
{
  "status": "OK",
  "type": "SUCCESS",
  "message": "CURP found and validated",
  "data": {
    "personalInfo": {
      "curp": "PELJ900101HDFRRN09",
      "givenNames": "JUAN",
      "firstSurname": "PEREZ",
      "secondSurname": "LOPEZ",
      "gender": "H",
      "dateOfBirth": "1990-01-01",
      "birthState": "DISTRITO FEDERAL"
    },
    "documentDetails": { "curpStatus": "AN", "probatoryDocumentCode": 1 }
  },
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "processedAt": "2026-03-15T12:35:00-06:00",
  "billable": true
}

​
Build with AI

Using Claude, ChatGPT, Gemini, Cursor, Windsurf, or any other MCP-compatible client? Install our MCP server and your AI assistant gains 26 tools — 7 for reading our spec (free, no API key needed) and 19 for calling the API. 
claude mcp add origoid \
  --env ORIGOID_API_KEY=your_api_key \
  -- npx -y @origoid/mcp-server
The 7 docs tools work without an API key, so the assistant can scaffold a full integration before you have an account. When you say “now run it”, the assistant calls the real API.

​
Next steps

Understand the envelope

One shape across every endpoint.

Handle errors gracefully

Stable type codes and how to act on them.

Reference catalogs

CURP status codes, IMSS modalities, SAT lists, and more.

Credits and plans

How usage counts against your plan.