Uso del token

El token se pasa como parámetro GET en todas las peticiones:

?token={tu_token}

Ejemplo

curl "https://api.valida-curp.com.mx/curp/validar?token=tu_token&curp=XAXX010101XAXAXA00"

El parámetro token puede ir en cualquier posición de la query string.

En cada lenguaje

Python

import requests
 
TOKEN = "tu_token"
BASE_URL = "https://api.valida-curp.com.mx/curp"
 
response = requests.get(
    f"{BASE_URL}/validar",
    params={"token": TOKEN, "curp": "XAXX010101XAXAXA00"}
)
data = response.json()

Node.js

const TOKEN = process.env.VALIDA_CURP_TOKEN;
const BASE_URL = "https://api.valida-curp.com.mx/curp";
 
const response = await fetch(
  `${BASE_URL}/validar?token=${TOKEN}&curp=XAXX010101XAXAXA00`
);
const data = await response.json();

PHP

$token = getenv('VALIDA_CURP_TOKEN');
$baseUrl = 'https://api.valida-curp.com.mx/curp';
 
$url = "{$baseUrl}/validar?" . http_build_query([
    'token' => $token,
    'curp'  => 'XAXX010101XAXAXA00',
]);
 
$response = file_get_contents($url);
$data = json_decode($response, true);

Errores de autenticación

Si el token es inválido o está bloqueado, la API responde con error: true y uno de estos códigos:

Código	Descripción
`1`	IP o token bloqueado por incumplimiento de términos
`2`	Token inválido
`3`	Proyecto suspendido
`4`	Consultas agotadas en el plan actual

{
  "error": true,
  "code_error": 2,
  "error_message": "Token del proyecto inválido",
  "response": null
}