Employment history


This API lets you know the Informative data that allows you to know the number of weeks that you have contributed to the Instituto Mexicano del Seguro Social (IMSS).

Important points

Required parameters

Both fields nss and curp in the request body are required.


Número de Seguridad Social (NSS for its acronym in Spanish), must be an 11-digit numeric data


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

If you are not sure how to obtain this field and you have your client's personal data, we suggest you visit our 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.

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:

1663567bb713cf2110a1106c3InválidoIndicates that the request is invalid
2663567bb713cf2110a1106c4Número de Intentos permitidosIndicates that the maximum number of queries allowed was exceeded
3663567bb713cf2110a1106bcRespuesta exitosaIndicates one successful response
4663567bb713cf2110a1106c1Servicio 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

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