← Catálogo
SEP1 tokenPOST

Cédula profesional por Datos Generales

Consulta las cédulas profesionales registradas en la SEP a partir del nombre completo de una persona. La búsqueda por nombre puede coincidir con varias personas, por lo que la respuesta devuelve un arreglo de resultados. Útil para validar credenciales académicas en procesos de contratación o compliance.

Endpoint

POSThttps://api.datosnonstop.com/v1/sep/cedula-datos-generales

Parámetros

json
{
  "nombres": "SAC - NICTE",
  "primerApellido": "FLORES",
  "segundoApellido": "ROJAS"
}
ParámetroTipoRequeridoDescripción
nombresstringSíNombres de pila de la persona a consultar
primerApellidostringSíPrimer apellido de la persona a consultar
segundoApellidostringNoSegundo apellido de la persona. Opcional cuando la persona no tiene segundo apellido.

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-datos-generales \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"nombres":"SAC - NICTE","primerApellido":"FLORES","segundoApellido":"ROJAS"}'

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": "9c5d012a6f0b3e7c1b49d263",
  "status": "found",
  "nombres": "SAC - NICTE",
  "primerApellido": "FLORES",
  "segundoApellido": "ROJAS",
  "resultados": [
    {
      "numeroCedula": "6345078",
      "tipoCedula": "C1",
      "nombre": "SAC - NICTE FLORES ROJAS",
      "genero": "Mujer",
      "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",
      "curp": "FORS850312MDFLJC08",
      "primerApellido": "FLORES",
      "segundoApellido": "ROJAS"
    },
    {
      "numeroCedula": "8123456",
      "tipoCedula": "C1",
      "nombre": "JOSE MANUEL FLORES ROJAS",
      "genero": "Hombre",
      "profesion": "LICENCIATURA EN CONTADURIA",
      "carrera": "CONTADURIA",
      "nivelEducativo": "LICENCIATURA",
      "areaConocimiento": "CIENCIAS SOCIALES Y ADMINISTRATIVAS",
      "subareaConocimiento": "ADMINISTRACION Y CONTADURIA",
      "institucion": "INSTITUTO POLITECNICO NACIONAL",
      "entidadInstitucion": "CIUDAD DE MEXICO",
      "anioExpedicion": 2015,
      "fechaExpedicion": "2015-08-03",
      "fechaTitulacion": "2015-02-27",
      "curp": "FORJ900707HDFLJS02",
      "primerApellido": "FLORES",
      "segundoApellido": "ROJAS"
    }
  ]
}

Respuestas en error

JSON
400 Bad Request
[
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "nombres"
  },
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "primerApellido"
  }
]

Campos

Campos de entrada

CampoTipoDescripción
nombresstringNombres de pila de la persona tal como aparecen en su registro académico.
primerApellidostringPrimer apellido de la persona a consultar.
segundoApellidostringSegundo apellido de la persona. Opcional cuando la persona no tiene segundo apellido.

Campos de respuesta

CampoTipoDescripción
idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.
statusstringResultado de la consulta de cédulas por datos generales en la SEP. Ver catálogo Status.
nombresstringNombres de pila enviados en la consulta.
primerApellidostringPrimer apellido enviado en la consulta.
segundoApellidostringSegundo apellido enviado en la consulta.
messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found.
resultadosarrayLista de cédulas profesionales que coinciden con el nombre consultado. Un mismo nombre puede coincidir con varias personas. Solo está presente cuando status es found.
resultados[].numeroCedulastringNúmero de la cédula profesional registrada en la SEP.
resultados[].tipoCedulastringTipo de cédula profesional emitida por la SEP.
resultados[].nombrestringNombre completo del profesionista tal como aparece en el registro de la SEP.
resultados[].generostringGénero del profesionista registrado en la SEP. Ver catálogo Género.
resultados[].profesionstringProfesión asociada a la cédula profesional.
resultados[].carrerastringCarrera cursada por el profesionista.
resultados[].nivelEducativostringNivel educativo de la cédula (licenciatura, maestría, doctorado, etc.).
resultados[].areaConocimientostringÁrea de conocimiento a la que pertenece la profesión.
resultados[].subareaConocimientostringSubárea de conocimiento a la que pertenece la profesión.
resultados[].institucionstringInstitución educativa que expidió el título.
resultados[].entidadInstitucionstringEntidad federativa donde se ubica la institución educativa.
resultados[].anioExpedicionnumberAño de expedición de la cédula profesional.
resultados[].fechaExpedicionstringFecha de expedición de la cédula en formato ISO YYYY-MM-DD.
resultados[].fechaTitulacionstringFecha de titulación del profesionista en formato ISO YYYY-MM-DD.
resultados[].curpstringCURP del profesionista asociada a la cédula.
resultados[].primerApellidostringPrimer apellido del profesionista.
resultados[].segundoApellidostringSegundo apellido del profesionista.

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 localizaron cédulas que coinciden con el nombre consultado en la SEP. La respuesta incluye el arreglo resultados.
not_foundNo se encontraron cédulas que coincidan con el nombre consultado. 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-datos-generales

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-datos-generales \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"nombres":"SAC - NICTE","primerApellido":"FLORES","segundoApellido":"ROJAS"}'

Casos de prueba

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

CasoCampoPrimer apellido
Caso exitoso — EncontradoprimerApellidoFLORES
Caso exitoso — No encontradoprimerApellidoNOEXISTE
Sin tokensprimerApellidoSINTOKENS
Error internoprimerApellidoERRORINTERNO
Unavailable serviceprimerApellidoNODISPONIBLE
Empezar gratis →