Employment history

Intro

This API allows you to find out the employment history of a person who has worked for the Instituto de Seguridad y Servicios Sociales de los Trabajadores del Estado (ISSSTE).

Important points

Required parameter

The curp field in the request body are required.

curp

Is the Clave Única de Registro de Población (CURP for its acronym in Spanish), must be an 18-character alphanumeric data.

fieldtyperequiredlengthDescription
curpAlphanumericYes18Provide a valid CURP according to the CURP rules

If you are not sure how to obtain this field and you have your client's personal data, we suggest you visit the CURP validate by data service to apply a validation and recover the CURP.

Successful response

To know the fields of a successful response you should see our example called success in the response section.

Inside the response structure you will get the next fields.

field Namesubfield namesubfield nameDescription
clinicaObject to indicate the ISSSTE clinic where the user is registered.
claveISSSTE clinic key
delegacionIssstename of the Issste delegation
domicilioaddress of the Issste delegation
nombrename of the Issste delegation
telefonoclinic phone
tipotype of the Issste delegation:
-CAF: Consultorio de Atención Familiar
-CE: Clínica de Especialidades
-CH: Clínica Hospital
-CMCT: Consultorio Médico en Centro de Trabajo
-CMF: Clinica de Medicina Familiar
-CMFE: Clinica de Medicina Familiar con especialidades
-CMN: Centro Médico Nacional
-HAE: Hospital de Alta Especialidad
-HG: Hospital General
-HR: Hospital Regional
-UMF: Unidad de Medicina Familiar
curpCURP of the requested person.
datosLaboralesArray of one element that will return the last work record of the person consulted
fechaAltaDate on which the last job was registered in yyyy-mm-dd format
modalidadThe benefits that the person has from the ISSSTE
pagaduriaInstitution that pays the salary
ramoBranch or role played at work.
remuneracionTotalsalary earned in employment
salarioBaseCotizacionquoted base salary
tipoPensiontype of pension:
-CONFIANZA
-BASE
domicilioMost recent registered address
calleStreet
coloniaColony
cpPostal Code
delegacionMunicipiomunicipality
estadoState
numeroExteriorexterior number
numeroInteriorinterior number
estadoCivilCivil status:
-SOLTERO (A)
-CASADO (A)
statusEstatus of the request
-FOUND: The CURP was found in the ISSSTE system and the response was successfully retrieved.
-NOT_FOUND: The CURP was not found in the ISSSTE system and and we could not return information.
fechaAltaPlazaActualDate of registration of current employment in format yyyy-mm-dd
fechaBajaDate of termination in format yyyy-mm-dd
fechaIngresoGobiernoFederalDate of entry into the Federal Government in format yyyy-mm-dd
fechaNacimientoBirth date
historialCotizacionArrangement indicating the employment history that the person has had
historialInternal arrangement where the exchange rates that have been had in the same job are indicated
cotizaIndicates whether the employee is contributing to the ISSSTE
-SÍ
-NO
fechaFinEnd date for salary change in format yyyy-mm-dd
fechaInicioStart date for salary change in format yyyy-mm-dd
sueldoBasicoSalary reported in this record
tipoSalary type
pagaduriaInstitution that pays the salary
ramoBranch or role played at work.
nombreName(s) of the person
nssSocial security number
primerApellidolast name
rfcRFC
segundoApellidoSecond last name
sexoGender:
-HOMBRE
-MUJER
situacionAfiliatoriaAffiliation Status:
-ACTIVO
-INACTIVO
tipoDerechohabientetype of beneficiary:
-PENSIONISTA
-TRABAJADOR

Test the service (test cases)

We have included a query parameter in Sandbox to enable you to query the test cases that we created for running tests. To get a response, fill the testCaseId parameter with any of the following cases:

NumIdNameDescription
1663567bb713cf2110a1106cbCURP inválidaIndicates that no information was found for the CURP provided
3663567bb713cf2110a1106caRespuesta exitosaIndicates a successful response
6663567bb713cf2110a1106ccServicio no disponibleIndicates that the service is not available

📘

Test your own test case

In case you want to test your own test case created in link, you can send in the testCaseId parameter the identifier of the test case you want to use.

For more information visit our knowledge center to know more about test cases

Listing the possible error responses

Required fields

You will get a 400 bad request error when the RFC is not provided in the request body.

{
    "curp": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty"
}

Invalid format

You will get a 400 bad request error when the RFC does not conform the specific format.

{
    "curp": "FORMAT_ERROR; must match [A-Z]{1}[AEIOUX]{1}[A-Z]{2}[0-9]{2}(0[1-9]|1[0-2])(0[1-9]|1[0-9]|2[0-9]|3[0-1])[HM]{1}(AS|BC|BS|CC|CS|CH|CL|CM|DF|DG|GT|GR|HG|JC|MC|MN|MS|NT|NL|OC|PL|QT|QR|SP|SL|SR|TC|TS|TL|VZ|YN|ZS|NE)[B-DF-HJ-NP-TV-Z]{3}[0-9A-Z]{1}[0-9]{1}"
}

Test case not found

If a test case parameter is not sent or a value other than those mentioned above is sent, the service will return the following error 400 bad request

{
    "testCase": "EMPTY_ERROR; test case not found",
    "testCaseId": "EMPTY_ERROR; test case not found with given id"
}

CURP not found

You will get a 200 http code response when we could not find data on the ISSSTE platform associated with the CURP provided, the status of the request will be NOT_FOUND

{
    "id": "65553db7acf971fe2a459351",
    "createdAt": "2023-11-15T21:52:55.338558267Z",
    "finishedAt": "2023-11-15T21:57:38.181184331Z",
    "duration": 282842,
    "status": "SUCCESS",
    "request": {
        "curp": "KIBA801010HDFPMD00"
    },
    "response": {
        "mensaje": "Verifique que la CURP sea correcta y se encuentre en la base de datos del ISSSTE",
        "status": "NOT_FOUND"
    }
}

Unauthorized

It means that the provided API KEY is incorrect and you are not authorized to access it. You will not receive a body, only a 401 HTTP code.

Language
Authorization
Header
Click Try It! to start a request and see the response here!