Cédulas Profesionales — API

API para la verificación e inspección en tiempo real de Cédulas Profesionales mexicanas directamente desde el Registro Nacional de Profesionistas (SEP). Publicada a través del gateway de idoo.dev: la autenticación, cuotas, planes y control de tasa (rate limiting) se gestionan de forma centralizada.

Facturación Deducible (CFDI 4.0): Todos los consumos contratados a través de idoo.dev cuentan con comprobante fiscal local para empresas en México.

Autenticación

Todas las solicitudes deben autenticarse enviando tu API key de idoo.dev en el encabezado HTTP Authorization:

Authorization: Bearer {tu_api_key}

Las peticiones se dirigen a la URL base asignada por el gateway:

POST https://api.idoo.dev/v1/consultar-cedula-profesional/

🔒 Buenas prácticas de seguridad: Mantén siempre tu API key resguardada en variables de entorno en el servidor (.env). Nunca realices peticiones directas desde el navegador o aplicaciones móviles (frontend) que puedan exponer tu clave.

Endpoints

Consultar por número de cédula

Consulta el registro oficial de la SEP para validar la legitimidad de un profesional y extraer sus datos académicos.

POST /

Encabezados obligatorios (Headers)

Cuerpo de la Petición (Request Body)

La API requiere un objeto JSON en el cuerpo de la solicitud HTTP (especificado mediante -d o --data en llamadas cURL):

{
  "cedula": "7739476"
}

Esquema del JSON (Body Schema)

Ejemplos de integración

Copiar y pegar directamente en tu entorno de desarrollo:

cURL (Terminal / Bash)

curl -X POST "https://api.idoo.dev/v1/consultar-cedula-profesional/" \
  -H "Authorization: Bearer {tu_api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "cedula": "7739476"
  }'

Python (Requests)

import requests

url = "https://api.idoo.dev/v1/consultar-cedula-profesional/"
headers = {
    "Authorization": "Bearer {tu_api_key}",
    "Content-Type": "application/json"
}
payload = {
    "cedula": "7739476"
}

try:
    response = requests.post(url, json=payload, headers=headers, timeout=10)
    data = response.json()
    
    if response.status_code == 200 and data.get("valid"):
        profesionista = data["data"]["items"][0]
        print(f"Nombre: {profesionista['nombre']} {profesionista['paterno']} {profesionista['materno']}")
        print(f"Carrera: {profesionista['titulo']}")
        print(f"Institución: {profesionista['desseccion']}")
    else:
        print(f"Error ({data.get('status')}): {data.get('message')}")

except requests.exceptions.RequestException as e:
    print(f"Error de red o conexión: {e}")

JavaScript / Node.js (Fetch API)

const API_KEY = 'tu_api_key';
const URL = 'https://api.idoo.dev/v1/consultar-cedula-profesional/';

async function consultarCedula(cedula) {
  try {
    const response = await fetch(URL, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ cedula })
    });

    const result = await response.json();

    if (response.ok && result.valid) {
      console.log('Información oficial:', result.data.items[0]);
    } else {
      console.error(`Error (${result.status}):`, result.message);
    }
  } catch (error) {
    console.error('Error de red:', error);
  }
}

consultarCedula('7739476');

PHP (cURL nativo)

<?php

$apiKey = 'tu_api_key';
$url = 'https://api.idoo.dev/v1/consultar-cedula-profesional/';

$payload = json_encode([
    'cedula' => '7739476'
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json'
    ],
    CURLOPT_TIMEOUT        => 10
]);

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

$data = json_decode($response, true);

if ($httpCode === 200 && isset($data['valid']) && $data['valid']) {
    $profesionista = $data['data']['items'][0];
    echo "Profesionista: " . $profesionista['nombre'] . " " . $profesionista['paterno'] . "\n";
    echo "Título: " . $profesionista['titulo'] . "\n";
} else {
    echo "Error " . $httpCode . ": " . ($data['message'] ?? 'Falló la consulta');
}

Respuestas

La API devuelve un envoltorio JSON estandarizado para facilitar la validación en código.

Respuesta exitosa (200 OK)

Se retorna cuando la cédula existe en la base de datos oficial.

{
  "valid": true,
  "status": 200,
  "message": "Consulta exitosa",
  "data": {
    "items": [
      {
        "idProfesionista": "7739476",
        "nombre": "JUAN",
        "paterno": "PEREZ",
        "materno": "GARCIA",
        "titulo": "LICENCIATURA EN DERECHO",
        "desseccion": "UNIVERSIDAD NACIONAL AUTÓNOMA DE MÉXICO",
        "anio": "2012"
      }
    ]
  },
  "timestamp": "2026-07-26T22:30:00.000Z"
}

Respuesta cuando no se encuentra registro (404 Not Found)

Se retorna cuando el número digitado no tiene un registro asociado en el Registro Nacional de Profesionistas.

{
  "valid": false,
  "status": 404,
  "message": "La cédula consultada no se encuentra registrada en la SEP",
  "data": null,
  "timestamp": "2026-07-26T22:30:00.000Z"
}

Códigos de error

Códigos de respuesta estándar emitidos por la API o por el gateway de idoo.dev: