Referencia de la API

# Verifica una cédula profesional con la SEP

Encuentra las cédulas profesionales que la SEP tiene registradas por número de cédula, CURP o nombre: la profesión, la institución y las fechas de cada una.

POST

`/v1/cedula/search`

Encuentra las cédulas profesionales que la SEP tiene registradas, por número de cédula, por CURP o por nombre. Cada resultado es una cédula con su titular, la profesión, la institución que otorgó el título y cuándo se expidió. Responde el Registro Nacional de Profesionistas de la SEP (cedulaprofesional.sep.gob.mx) en alrededor de un segundo.

Úsalo antes de contratar a un médico, abogado, contador, ingeniero o cualquier otro profesionista: confirma que la cédula que te da es real y está registrada a su nombre, o encuentra las cédulas que tiene una persona.

**Precios:** 5 créditos por cada búsqueda que la SEP responde, encuentre una cédula o no: $0.075 en pago por uso, y menos con un plan, cuyos créditos cuestan menos. No se cobra nada cuando no se puede consultar a la SEP.

## ¿Qué es una cédula profesional?

La cédula profesional es la autorización en México para ejercer una profesión. La Dirección General de Profesiones de la SEP la expide al registrar el título de una persona, y por ley tiene efectos de patente para ejercer esa profesión. Médicos, abogados, enfermeras, contadores, ingenieros y arquitectos tienen una.

- Cada título tiene su propia cédula, con su propio número de 7 u 8 dígitos: un médico con licenciatura en medicina y especialidad en cardiología tiene dos.
- Desde 2018 la SEP expide las cédulas nuevas en formato electrónico en lugar de la credencial impresa, así que puede llegarte como PDF o como foto de una credencial antigua. En cualquier caso, lo que prueba que es real es el registro de la SEP.
- No es una identificación. En muchos países de Latinoamérica "cédula" es el documento nacional de identidad, pero en México la cédula profesional prueba un título, no quién la presenta. Compara su CURP con la de la persona, o valida su credencial para votar, para saber que es su titular.

## Cuerpo de la solicitud

Busca de una forma a la vez: envía cedula, o curp, o names con paternal_surname (y mothers_maiden_name si lo tienes). Campos de dos formas en una misma solicitud regresan 422.


| Campo | Tipo | Descripción |
| --- | --- | --- |
| `cedula` | cadena o entero | El número de cédula, de hasta 8 dígitos. La SEP guarda las cédulas antiguas con 7 dígitos y ceros a la izquierda, así que un número más corto se completa: 878820 se busca como 0878820. |
| `curp` | string | La CURP de 18 caracteres del titular. La SEP liga CURP solo a cédulas recientes: una cédula antigua no tiene CURP en la SEP y se encuentra por número o por nombre. |
| `names` | string | El nombre o los nombres del titular. Obligatorio en una búsqueda por nombre. |
| `paternal_surname` | string | El primer apellido. Obligatorio en una búsqueda por nombre. |
| `mothers_maiden_name` | string | El segundo apellido. Opcional, pero acota mucho la búsqueda de un nombre común. |
| `include_pdf` | boolean | Ponlo en true para incluir la Constancia de Situación Profesional de la SEP como pdf_base64. Funciona con cualquiera de las tres formas de búsqueda. Por omisión es false. |


## Búsqueda por nombre

Un resultado se conserva cuando cada palabra que envías aparece en el campo en que la enviaste, sin importar acentos ni mayúsculas: "juan" en names encuentra a JUAN y a JUAN CARLOS, y "Peña" encuentra a PEÑA. La búsqueda de la propia SEP también regresa a cualquiera que comparta solo uno de los nombres; esos se dejan fuera.

Se regresan hasta 100 resultados, y truncated indica cuando coincidieron más. Con un nombre común la SEP puede tardar varios segundos, y los nombres más amplios nunca terminan: agrega el segundo apellido.

## La constancia de la SEP

Con include_pdf en true, una búsqueda que encuentra cédulas también regresa pdf_base64: la Constancia de Situación Profesional que la SEP expide para el titular, un PDF firmado con sus cédulas, colegios de profesionistas y cualquier sanción. No se cobran créditos adicionales. La SEP la genera al momento, así que la búsqueda tarda 4 a 5 segundos.

La SEP expide la constancia por CURP. Una cédula sin CURP en la SEP, o resultados que pertenecen a más de una persona, regresan sin pdf_base64, y message explica por qué. Si la SEP no puede expedirla en ese momento, found es null y la solicitud no se cobra; vuelve a intentarlo más tarde.

## Solicitud de ejemplo: por número de cédula

curl

```bash
curl -X POST https://mexcheck.com/v1/cedula/search \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"cedula": "0000001"}'
```

## Solicitud de ejemplo: por CURP

curl

```bash
curl -X POST https://mexcheck.com/v1/cedula/search \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"curp": "PUDJ800101HDFRMN06", "include_pdf": true}'
```

## Solicitud de ejemplo: por nombre

curl

```bash
curl -X POST https://mexcheck.com/v1/cedula/search \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"names": "Juan", "paternal_surname": "Prueba", "mothers_maiden_name": "Demo"}'
```

## Respuesta (200)

200 OK

```json
{
  "found": true,
  "message": "SEP has 1 cédula profesional registered.",
  "count": 1,
  "truncated": false,
  "results": [
    {
      "cedula": "0000001",
      "type": "C1",
      "names": "JUAN",
      "paternal_surname": "PRUEBA",
      "mothers_maiden_name": "DEMO",
      "sex": "H",
      "curp": "PUDJ800101HDFRMN06",
      "profession": "LICENCIATURA EN DERECHO",
      "institution": "UNIVERSIDAD DEMO",
      "institution_state": "CIUDAD DE MÉXICO",
      "education_level": "LICENCIATURA",
      "issue_date": "2004-08-16",
      "graduation_date": "2004-06-25",
      "registration_year": 2004
    }
  ]
}
```


| Campo | Descripción |
| --- | --- |
| `found` | true cuando la SEP tiene al menos una cédula que coincide; false cuando no tiene ninguna, lo que se cobra como cualquier otra respuesta; null cuando no se pudo consultar a la SEP, lo que no se cobra (reintenta más tarde). |
| `message` | Qué significa la respuesta, en una oración. |
| `count` | Cuántos resultados trae esta respuesta. |
| `truncated` | true cuando coincidieron más de 100 cédulas. Agrega el segundo apellido para acotarla. |
| `pdf_base64` | La Constancia de Situación Profesional de la SEP, codificada en base64. Solo aparece cuando include_pdf es true y la SEP expidió una. |
| `results` | Las cédulas que coinciden, en el orden de la SEP. Una persona con varios títulos (una licenciatura y luego una maestría) tiene una cédula por cada uno. |


## Cada resultado

Un campo para el que la SEP no tiene valor es null.


| Campo | Descripción |
| --- | --- |
| `cedula` | El número de cédula como lo guarda la SEP, de 7 u 8 dígitos. |
| `type` | El código de la SEP para el tipo de cédula, como C1. |
| `names`, `paternal_surname`, `mothers_maiden_name` | El nombre del titular, como lo registró la SEP. |
| `sex` | H (hombre) o M (mujer), como en una CURP. |
| `curp` | La CURP del titular. null en cédulas antiguas, que la SEP nunca ligó a una. |
| `profession` | El título para el que se expidió la cédula (LICENCIATURA EN DERECHO). |
| `institution`, `institution_state` | La escuela que otorgó el título, y su estado. |
| `education_level` | El nivel de estudios, cuando la SEP lo registra. |
| `issue_date` | Cuándo expidió la SEP la cédula, AAAA-MM-DD. |
| `graduation_date` | Cuándo obtuvo el titular el título, AAAA-MM-DD. |
| `registration_year` | El año en que la SEP registró la cédula, como número entero. |


## Errores

Una búsqueda que no se puede ejecutar regresa 422 con error invalid_fields y los campos con problema, y no se cobra: nada por qué buscar, campos de más de una forma, una cédula que no es de hasta 8 dígitos, una CURP mal formada, o una búsqueda por nombre sin names o paternal_surname. Consulta la página de errores para los códigos que comparten todos los endpoints.