/v1/cedula/search
Finds the cédulas profesionales SEP has registered, by cédula number, by CURP, or by name. Each result is one cédula with its holder, the profession, the institution that awarded it, and when it was issued. Answered by SEP's Registro Nacional de Profesionistas (cedulaprofesional.sep.gob.mx) in about a second.
Use it before hiring or contracting a doctor, lawyer, accountant, engineer, or any other professional: confirm that the cédula they give you is real and registered to them, or find the cédulas a person holds.
Pricing: 5 credits per search SEP answers, whether it finds a cédula or not: $0.075 pay-as-you-go, and less under a plan, whose credits cost less. Nothing is charged when SEP cannot be asked.
What is a cédula profesional?
A cédula profesional is Mexico's license to practice a profession. SEP's Dirección General de Profesiones issues it when it registers a person's degree (título), and by law it serves as the license to practice that profession. Doctors, lawyers, nurses, accountants, engineers, and architects all hold one.
- Each degree gets its own cédula, with its own 7- or 8-digit number: a doctor with a licenciatura in medicine and a specialty in cardiology holds two.
- Since 2018 SEP issues new cédulas in electronic form instead of the printed card, so one may reach you as a PDF or as a photo of an old card. Either way, SEP's registry is what proves it is real.
- It is not an identity card. In many Latin American countries "cédula" means the national ID, but in Mexico a cédula profesional proves a degree, not who is holding it. Compare its CURP with the person's, or check their voter ID, to know they are its holder.
Request body
Search one way at a time: send cedula, or curp, or names with paternal_surname (and mothers_maiden_name if you have it). Fields from two ways in one request return 422.
| Field | Type | Description |
|---|---|---|
cedula |
string or integer | The cédula number, up to 8 digits. SEP keeps older cédulas as 7 digits with leading zeros, so a shorter number is padded: 878820 is searched as 0878820. |
curp |
string | The holder's 18-character CURP. SEP links CURPs to recent cédulas only: an older cédula carries no CURP at SEP and is found by number or name instead. |
names |
string | The holder's given names. Required in a name search. |
paternal_surname |
string | The first surname. Required in a name search. |
mothers_maiden_name |
string | The second surname. Optional, but it narrows a search for a common name a great deal. |
include_pdf |
boolean | Set to true to include SEP's Constancia de Situación Profesional as pdf_base64. Works with any of the three ways in. Defaults to false. |
Searching by name
A result is kept when every word you send appears in the field you sent it in, whatever its accents and capitals: "juan" in names finds JUAN and JUAN CARLOS, and "Peña" finds PEÑA. SEP's own search also returns anyone who shares just one of the given names; those are left out.
Up to 100 results are returned, and truncated says when more matched. For a common name SEP can take several seconds, and the broadest names never finish: add the second surname.
SEP's constancia
With include_pdf set to true, a search that finds cédulas also returns pdf_base64: the Constancia de Situación Profesional SEP issues for the holder, a signed PDF listing their cédulas, professional associations (colegios), and any sanctions. No extra credits are charged. SEP generates it on request, so the search takes 4 to 5 seconds.
SEP issues the constancia by CURP. A cédula with no CURP at SEP, or results that belong to more than one person, come back without pdf_base64, and message says why. If SEP cannot issue it right now, found is null and the request is not charged; retry later.
Try it
/v1/cedula/search
Sign in to send a real request from this page.
New accounts get a $5 USD signup credit, no card required.
Example request: by cédula number
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"}'
Example request: by CURP
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}'
Example request: by name
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"}'
Response (200)
{
"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
}
]
}
| Field | Description |
|---|---|
found |
true when SEP has at least one matching cédula; false when it has none, which is charged like any other answer; null when SEP could not be reached, which is not charged (retry later). |
message |
What the answer means, in one sentence. |
count |
How many results this response carries. |
truncated |
true when more than 100 cédulas matched. Add the second surname to narrow it. |
pdf_base64 |
SEP's Constancia de Situación Profesional, base64-encoded. Present only when include_pdf is true and SEP issued one. |
results |
The matching cédulas, in SEP's order. A person with several degrees (a licenciatura, then a master's) has one cédula for each. |
Each result
A field SEP has no value for is null.
| Field | Description |
|---|---|
cedula |
The cédula number as SEP keeps it, 7 or 8 digits. |
type |
SEP's code for the kind of cédula, such as C1. |
names, paternal_surname, mothers_maiden_name
|
The holder's name, as SEP registered it. |
sex |
H (male) or M (female), as in a CURP. |
curp |
The holder's CURP. null for older cédulas, which SEP never linked to one. |
profession |
The degree the cédula was issued for (LICENCIATURA EN DERECHO). |
institution, institution_state |
The school that awarded the degree, and its state. |
education_level |
The level of studies, when SEP records it. |
issue_date |
When SEP issued the cédula, YYYY-MM-DD. |
graduation_date |
When the holder obtained the degree, YYYY-MM-DD. |
registration_year |
The year SEP registered the cédula, as an integer. |
Errors
A search it cannot run returns 422 with error invalid_fields and the fields at fault, and is not charged: nothing to search by, fields from more than one way, a cédula that is not up to 8 digits, a CURP that is not well formed, or a name search without names or paternal_surname. See the errors page for the codes every endpoint shares.