Endpoint: cédula profesional (México)

Consulta una cédula profesional mexicana por su número en el Registro Nacional de Profesionistas. Devuelve la cédula, la profesión, la carrera, la institución y el año de registro; no publica nombre, CURP, fecha de nacimiento, género, libro ni foja. Una cédula que no figura es un hallazgo negativo y cobra; una fuente caída o un captcha no resuelto no cobra.

POST/api/cedula-profesional-mx1 crédito

Consulta una cédula profesional mexicana por su número en el Registro Nacional de Profesionistas de la SEP. Devuelve los registros exactos con cedula, profesion, carrera, institucion y anioRegistro. Por minimización de PII NO publica nombre, CURP, fechas personales, género, libro ni foja; cobertura declara esas exclusiones. El número se valida antes de reservar crédito: exactamente 7 u 8 dígitos, sin espacios ni guiones; una entrada imposible responde 400 sin cobrar y sin gastar captcha. Una cédula bien formada que no figura responde 404 no_encontrado y reembolsa. La consulta requiere salida mexicana y reCAPTCHA v3; un fallo de la SEP, del proxy o del solver también reembolsa, nunca se convierte en negativa. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)

{
  "documento": "0000000"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
documentoobligatorio	string	Número de cédula profesional de 7 u 8 dígitos. Alias aceptados: `cedula`, `numCedula`, `docNumber` y `documentNumber`.
refresh	boolean	Ignora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL

curl -X POST 'https://placapi.com/api/cedula-profesional-mx' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"documento":"0000000"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/cedula-profesional-mx", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"documento":"0000000"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/cedula-profesional-mx",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"documento":"0000000"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "source": "cedulaProfesionalMx",
  "status": "ok",
  "data": {
    "cedula": "0000000",
    "total": 1,
    "registros": [
      {
        "cedula": "0000000",
        "profesion": "LICENCIATURA EN DERECHO",
        "carrera": "DERECHO",
        "institucion": "UNIVERSIDAD DE EJEMPLO",
        "anioRegistro": 2001
      }
    ],
    "cobertura": {
      "profesion": true,
      "carrera": true,
      "institucion": true,
      "anioRegistro": true,
      "nombre": false,
      "curp": false,
      "fechasPersonales": false,
      "genero": false,
      "libro": false,
      "foja": false
    }
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 30 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.