RENAPO

Retrieve CURP via Demographics

Credits: 2 per call.

Reconstructs a CURP from the four official input fields: given names, first surname, second surname, gender, date of birth, and birth state code. Calls RENAPO and returns the matching CURP plus the full personal record (same shape as validateCurp).

Use this endpoint when your KYC form collects names and date of birth but not the CURP, and you need the CURP to file a financial product or report to regulators. The lookup uses RENAPO’s strict matching — if any field is misspelled, no match is returned (CURP_NOT_FOUND).

cURL

curl -X POST https://api.origoid.com/mex/renapo/v1/curp-lookups \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"givenNames": "JUAN", "firstSurname": "PEREZ", "secondSurname": "LOPEZ", "dateOfBirth": "1990-01-01", "gender": "H", "birthStateCode": "DF", "generateRfc": true}'

const response = await fetch("https://api.origoid.com/mex/renapo/v1/curp-lookups", {
  method: "POST",
  headers: {
    "x-api-key": process.env.ORIGOID_API_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
      "givenNames": "JUAN",
      "firstSurname": "PEREZ",
      "secondSurname": "LOPEZ",
      "dateOfBirth": "1990-01-01",
      "gender": "H",
      "birthStateCode": "DF",
      "generateRfc": true
  }),
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const result = await response.json();
console.log(result);

import os
import requests

response = requests.post(
    "https://api.origoid.com/mex/renapo/v1/curp-lookups",
    headers={
        "x-api-key": os.environ["ORIGOID_API_KEY"],
        "content-type": "application/json",
    },
    json={
            "givenNames": "JUAN",
            "firstSurname": "PEREZ",
            "secondSurname": "LOPEZ",
            "dateOfBirth": "1990-01-01",
            "gender": "H",
            "birthStateCode": "DF",
            "generateRfc": True
    },
    timeout=30,
)
response.raise_for_status()
result = response.json()
print(result)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class Example {
    public static void main(String[] args) throws Exception {
        String payload = "{\"givenNames\": \"JUAN\", \"firstSurname\": \"PEREZ\", \"secondSurname\": \"LOPEZ\", \"dateOfBirth\": \"1990-01-01\", \"gender\": \"H\", \"birthStateCode\": \"DF\", \"generateRfc\": true}";

        HttpClient client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.origoid.com/mex/renapo/v1/curp-lookups"))
            .header("x-api-key", System.getenv("ORIGOID_API_KEY"))
            .header("content-type", "application/json")
            .timeout(Duration.ofSeconds(30))
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(
            request, HttpResponse.BodyHandlers.ofString()
        );

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

<?php
$payload = '{"givenNames": "JUAN", "firstSurname": "PEREZ", "secondSurname": "LOPEZ", "dateOfBirth": "1990-01-01", "gender": "H", "birthStateCode": "DF", "generateRfc": true}';

$ch = curl_init('https://api.origoid.com/mex/renapo/v1/curp-lookups');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'x-api-key: ' . getenv('ORIGOID_API_KEY'),
        'content-type: application/json',
    ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception("HTTP $status");
}

$result = json_decode($response, true);
print_r($result);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"os"
	"time"
)

func main() {
	payload := []byte(`{"givenNames": "JUAN", "firstSurname": "PEREZ", "secondSurname": "LOPEZ", "dateOfBirth": "1990-01-01", "gender": "H", "birthStateCode": "DF", "generateRfc": true}`)
	req, err := http.NewRequest("POST", "https://api.origoid.com/mex/renapo/v1/curp-lookups", bytes.NewBuffer(payload))
	if err != nil { log.Fatal(err) }
	req.Header.Set("x-api-key", os.Getenv("ORIGOID_API_KEY"))
	req.Header.Set("content-type", "application/json")

	client := &http.Client{Timeout: 30 * time.Second}
	resp, err := client.Do(req)
	if err != nil { log.Fatal(err) }
	defer resp.Body.Close()

	var result map[string]any
	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
		log.Fatal(err)
	}
	fmt.Println(result)
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
        client.DefaultRequestHeaders.Add("x-api-key",
            Environment.GetEnvironmentVariable("ORIGOID_API_KEY"));

        var payload = "{\"givenNames\": \"JUAN\", \"firstSurname\": \"PEREZ\", \"secondSurname\": \"LOPEZ\", \"dateOfBirth\": \"1990-01-01\", \"gender\": \"H\", \"birthStateCode\": \"DF\", \"generateRfc\": true}";
        var content = new StringContent(payload, Encoding.UTF8, "application/json");

        var response = await client.PostAsync("https://api.origoid.com/mex/renapo/v1/curp-lookups", content);
        response.EnsureSuccessStatusCode();

        var body = await response.Content.ReadAsStringAsync();
        Console.WriteLine(body);
    }
}

{
  "status": "OK",
  "type": "SUCCESS",
  "message": "CURP found and validated",
  "data": {
    "personalInfo": {
      "curp": "TEST900101HDFRRN09",
      "rfc": null,
      "givenNames": "JUAN",
      "firstSurname": "PEREZ",
      "secondSurname": "LOPEZ",
      "gender": "H",
      "dateOfBirth": "1990-01-01",
      "birthState": "DISTRITO FEDERAL",
      "birthStateCode": "DF",
      "nationality": "MEXICO"
    },
    "documentDetails": {
      "curpStatus": "AN",
      "probatoryDocumentCode": 1
    },
    "registrationDetails": {
      "state": "DISTRITO FEDERAL",
      "stateCode": "09",
      "municipality": "CUAUHTEMOC",
      "municipalityCode": "015",
      "year": "1990",
      "foreignNumber": ""
    }
  },
  "transactionId": "550e8400-e29b-41d4-a716-446655440020",
  "processedAt": "2026-03-15T12:35:00-06:00",
  "billable": true
}

Autorizaciones

x-api-key

string

header

requerido

Cuerpo

application/json

givenNames

string

requerido

Ejemplo:

"JUAN"

firstSurname

string

requerido

Ejemplo:

"PEREZ"

dateOfBirth

string

requerido

Format YYYY-MM-DD

Ejemplo:

"1990-01-01"

gender

enum<string>

requerido

Opciones disponibles:

H,

M,

X

Ejemplo:

"H"

birthStateCode

string

requerido

Ejemplo:

"DF"

secondSurname

string

Ejemplo:

"LOPEZ"

generateRfc

boolean

Ejemplo:

true

Respuesta

Business Responses (Strict Envelope Pattern).

status

enum<string>

requerido

High-level outcome. OK means the request was successfully processed (regardless of business result). ERROR means the request was rejected or could not be processed.

Opciones disponibles:

OK,

ERROR

type

string

requerido

Stable result type code. Includes generic codes (SUCCESS, INVALID_REQUEST, UNAUTHORIZED, SERVICE_UNAVAILABLE, INTERNAL_ERROR, RATE_LIMIT_EXCEEDED) plus endpoint-specific result codes — see this endpoint's response examples.

message

string

requerido

Human-readable summary of the result. Always in English (per Language Conventions in the API overview).

transactionId

string<uuid>

requerido

Unique identifier of this request, generated by the API Gateway. Propagated end-to-end for traceability.

processedAt

string<date-time>

requerido

ISO 8601 datetime with Mexico City offset (-06:00). Always set by the API Gateway when the response leaves the system.

billable

boolean

requerido

Whether this request will be charged against the client's plan. Typically true for successful business results and false for validation errors or system errors that prevented processing.

data

object | null

Response payload. null on error responses. Shape depends on the endpoint — see each operation's response schema.

errors

object[]

Per-field error details. Present only on INVALID_REQUEST responses.

Show child attributes

cURL

curl -X POST https://api.origoid.com/mex/renapo/v1/curp-lookups \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"givenNames": "JUAN", "firstSurname": "PEREZ", "secondSurname": "LOPEZ", "dateOfBirth": "1990-01-01", "gender": "H", "birthStateCode": "DF", "generateRfc": true}'

const response = await fetch("https://api.origoid.com/mex/renapo/v1/curp-lookups", {
  method: "POST",
  headers: {
    "x-api-key": process.env.ORIGOID_API_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
      "givenNames": "JUAN",
      "firstSurname": "PEREZ",
      "secondSurname": "LOPEZ",
      "dateOfBirth": "1990-01-01",
      "gender": "H",
      "birthStateCode": "DF",
      "generateRfc": true
  }),
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const result = await response.json();
console.log(result);

import os
import requests

response = requests.post(
    "https://api.origoid.com/mex/renapo/v1/curp-lookups",
    headers={
        "x-api-key": os.environ["ORIGOID_API_KEY"],
        "content-type": "application/json",
    },
    json={
            "givenNames": "JUAN",
            "firstSurname": "PEREZ",
            "secondSurname": "LOPEZ",
            "dateOfBirth": "1990-01-01",
            "gender": "H",
            "birthStateCode": "DF",
            "generateRfc": True
    },
    timeout=30,
)
response.raise_for_status()
result = response.json()
print(result)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class Example {
    public static void main(String[] args) throws Exception {
        String payload = "{\"givenNames\": \"JUAN\", \"firstSurname\": \"PEREZ\", \"secondSurname\": \"LOPEZ\", \"dateOfBirth\": \"1990-01-01\", \"gender\": \"H\", \"birthStateCode\": \"DF\", \"generateRfc\": true}";

        HttpClient client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.origoid.com/mex/renapo/v1/curp-lookups"))
            .header("x-api-key", System.getenv("ORIGOID_API_KEY"))
            .header("content-type", "application/json")
            .timeout(Duration.ofSeconds(30))
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(
            request, HttpResponse.BodyHandlers.ofString()
        );

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

<?php
$payload = '{"givenNames": "JUAN", "firstSurname": "PEREZ", "secondSurname": "LOPEZ", "dateOfBirth": "1990-01-01", "gender": "H", "birthStateCode": "DF", "generateRfc": true}';

$ch = curl_init('https://api.origoid.com/mex/renapo/v1/curp-lookups');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'x-api-key: ' . getenv('ORIGOID_API_KEY'),
        'content-type: application/json',
    ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception("HTTP $status");
}

$result = json_decode($response, true);
print_r($result);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"os"
	"time"
)

func main() {
	payload := []byte(`{"givenNames": "JUAN", "firstSurname": "PEREZ", "secondSurname": "LOPEZ", "dateOfBirth": "1990-01-01", "gender": "H", "birthStateCode": "DF", "generateRfc": true}`)
	req, err := http.NewRequest("POST", "https://api.origoid.com/mex/renapo/v1/curp-lookups", bytes.NewBuffer(payload))
	if err != nil { log.Fatal(err) }
	req.Header.Set("x-api-key", os.Getenv("ORIGOID_API_KEY"))
	req.Header.Set("content-type", "application/json")

	client := &http.Client{Timeout: 30 * time.Second}
	resp, err := client.Do(req)
	if err != nil { log.Fatal(err) }
	defer resp.Body.Close()

	var result map[string]any
	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
		log.Fatal(err)
	}
	fmt.Println(result)
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
        client.DefaultRequestHeaders.Add("x-api-key",
            Environment.GetEnvironmentVariable("ORIGOID_API_KEY"));

        var payload = "{\"givenNames\": \"JUAN\", \"firstSurname\": \"PEREZ\", \"secondSurname\": \"LOPEZ\", \"dateOfBirth\": \"1990-01-01\", \"gender\": \"H\", \"birthStateCode\": \"DF\", \"generateRfc\": true}";
        var content = new StringContent(payload, Encoding.UTF8, "application/json");

        var response = await client.PostAsync("https://api.origoid.com/mex/renapo/v1/curp-lookups", content);
        response.EnsureSuccessStatusCode();

        var body = await response.Content.ReadAsStringAsync();
        Console.WriteLine(body);
    }
}

{
  "status": "OK",
  "type": "SUCCESS",
  "message": "CURP found and validated",
  "data": {
    "personalInfo": {
      "curp": "TEST900101HDFRRN09",
      "rfc": null,
      "givenNames": "JUAN",
      "firstSurname": "PEREZ",
      "secondSurname": "LOPEZ",
      "gender": "H",
      "dateOfBirth": "1990-01-01",
      "birthState": "DISTRITO FEDERAL",
      "birthStateCode": "DF",
      "nationality": "MEXICO"
    },
    "documentDetails": {
      "curpStatus": "AN",
      "probatoryDocumentCode": 1
    },
    "registrationDetails": {
      "state": "DISTRITO FEDERAL",
      "stateCode": "09",
      "municipality": "CUAUHTEMOC",
      "municipalityCode": "015",
      "year": "1990",
      "foreignNumber": ""
    }
  },
  "transactionId": "550e8400-e29b-41d4-a716-446655440020",
  "processedAt": "2026-03-15T12:35:00-06:00",
  "billable": true
}

Authentication

RENAPO

Social Security

INE

Biometrics

Compliance

Email

Proof of Address

Fiscal

Banking

Retrieve CURP via Demographics

Autorizaciones

Cuerpo

Respuesta