← Catálogo
SEP1 tokenPOST

Cédula profesional por número

Consulta los datos completos de una cédula profesional en el registro de la SEP a partir de su número. Devuelve la profesión, carrera, institución, titulación y datos del titular. Útil para validar credenciales académicas en procesos de contratación o compliance.

Endpoint

POSThttps://api.datosnonstop.com/v1/sep/cedula-numero

Parámetros

json
{
  "numeroCedula": "6345078"
}
ParámetroTipoRequeridoDescripción
numeroCedulastringNúmero de cédula profesional a consultar (solo dígitos)

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl
curl -X POST https://api.datosnonstop.com/v1/sep/cedula-numero \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"numeroCedula":"6345078"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON
200 OK
{
  "id": "9c5d012a6f0b3e7c1b49d265",
  "status": "found",
  "numeroCedula": "6345078",
  "tipoCedula": "C1",
  "nombre": "SAC - NICTE FLORES ROJAS",
  "primerApellido": "FLORES",
  "segundoApellido": "ROJAS",
  "genero": "Mujer",
  "curp": "FORS850312MDFLJC08",
  "profesion": "LICENCIATURA EN DERECHO",
  "carrera": "DERECHO",
  "nivelEducativo": "LICENCIATURA",
  "areaConocimiento": "CIENCIAS SOCIALES Y ADMINISTRATIVAS",
  "subareaConocimiento": "DERECHO",
  "institucion": "UNIVERSIDAD NACIONAL AUTONOMA DE MEXICO",
  "entidadInstitucion": "CIUDAD DE MEXICO",
  "anioExpedicion": 2010,
  "fechaExpedicion": "2010-05-14",
  "fechaTitulacion": "2009-11-20",
  "fechaNacimiento": "1985-03-12",
  "entidadNacimiento": "CIUDAD DE MEXICO",
  "sostenimiento": "PUBLICO",
  "libro": "123",
  "numero": "4567",
  "foja": "89"
}

Respuestas en error

JSON
400 Bad Request
[
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "numeroCedula"
  }
]

Campos

Campos de entrada

CampoTipoDescripción
numeroCedulastringNúmero de la cédula profesional a consultar. Solo dígitos.

Campos de respuesta

CampoTipoDescripción
idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.
statusstringResultado de la consulta de la cédula por número en la SEP. Ver catálogo Status.
numeroCedulastringNúmero de cédula profesional consultado.
messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found.
tipoCedulastringTipo de cédula profesional emitida por la SEP.
nombrestringNombre completo del profesionista tal como aparece en el registro de la SEP.
primerApellidostringPrimer apellido del profesionista.
segundoApellidostringSegundo apellido del profesionista.
generostringGénero del profesionista registrado en la SEP. Ver catálogo Género.
curpstringCURP del profesionista asociada a la cédula.
profesionstringProfesión asociada a la cédula profesional.
carrerastringCarrera cursada por el profesionista.
nivelEducativostringNivel educativo de la cédula (licenciatura, maestría, doctorado, etc.).
areaConocimientostringÁrea de conocimiento a la que pertenece la profesión.
subareaConocimientostringSubárea de conocimiento a la que pertenece la profesión.
institucionstringInstitución educativa que expidió el título.
entidadInstitucionstringEntidad federativa donde se ubica la institución educativa.
anioExpedicionnumberAño de expedición de la cédula profesional.
fechaExpedicionstringFecha de expedición de la cédula en formato ISO YYYY-MM-DD.
fechaTitulacionstringFecha de titulación del profesionista en formato ISO YYYY-MM-DD.
fechaNacimientostringFecha de nacimiento del profesionista en formato ISO YYYY-MM-DD.
entidadNacimientostringEntidad federativa de nacimiento del profesionista.
sostenimientostringTipo de sostenimiento de la institución educativa (público o privado).
librostringLibro donde se asentó el registro de la cédula.
numerostringNúmero de registro de la cédula.
fojastringFoja donde se asentó el registro de la cédula.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción
foundSe localizó la cédula profesional en la SEP. La respuesta incluye los datos del titular.
not_foundLa cédula profesional no fue encontrada en el registro de la SEP. La respuesta incluye el campo message con el detalle.

Género

Valores posibles del campo genero.

ValorDescripción
HombreProfesionista registrado como hombre.
MujerProfesionista registrada como mujer.

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/sep/cedula-numero

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl
curl -X POST https://sandbox.api.datosnonstop.com/v1/sep/cedula-numero \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"numeroCedula":"6345078"}'

Casos de prueba

Si envías un valor de Número de cédula que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de 6345078.

CasoNúmero de cédula
Caso exitoso — Encontrado6345078
Caso exitoso — No encontrado9999999
Sin tokens4020000
Error interno5000000
Unavailable service5030000