🇲🇽

IMSS API

Overview

Obtain and verify worker from the IMSS by CURP or Mexican Name.

🕑 Average Latency ~100 ms 🕑 Worst Latency ~5000 ms 🧑‍⚖️ Success Rate 80%

Getting started

  1. Log in and copy API Key.
  1. You either can test directly in your browser, use Postman, or use our sandbox. Remember substitute API Key.

Request

GET https://us-west4-arsus-production.cloudfunctions.net/imss

Parameters

NameDescription
nssnumber 11 Security social number
apiKeystring You need to sign up on https://sanchezcarlosjr.com for you to get it.

Response

If successful, this method returns a response body with the following structure:

{
  "nss": "string",
  "idAssignmentNss": "number",
  "isRegistredIMSS": "boolean",
  "rightINC": "boolean",
  "rightSM": "boolean",
  "vigency": "date"
}

Properties

NameDescription
creditFromInfonavitnumber Monto de credito a otorgar. Moneda mexicana.
housingSubAccountBalancenumber Monto del Saldo de la Subcuenta de Vivienda. Moneda mexicana.
operatingExpensesnumber Monto de gastos de titulación, financieros y de operación. Moneda mexicana.
totalnumber Total aproximado de crédito. Moneda mexicana. total = creditFromInfonavit + housingSubAccountBalance -operatingExpenses
monthlySalaryDiscountnumber El descuento mensual de su salario para el fondo de protección de pago, la cuota de administración, el pago de ecotecnologías, el monto de seguro y seguro de danos. Moneda mexicana.
creditForEcotechnologiesnumber Monto máximo de crédito para ecotecnologías. Moneda mexicana.
productstring CI, CII Numero de credito

Example Request

https://us-west4-arsus-production.cloudfunctions.net/infonavit?apiKey=pT32raieZC3&nss=69648001&birthday=1972-05-21T00:00:00.000Z

Example Success Response

{
  "creditFromInfonavit": 316938.24,
  "housingSubAccountBalance": 45218.87,
  "operatingExpenses": 9508.14,
  "total": 352648.97,
  "monthlySalaryDiscount": 2668.86,
  "creditForEcotechnologies": 15846.9,
  "product": "CI"
}

Errors

The error messages that the API could return in response to a call to this method.

Error TypeError detailDescription
forbidden (400)forbiddenapi key not found
internalError (500)internalError
PersonWithoutCreditError (401)Person without creditExamples: "nss no registrado en infonavit", "sin relacion laboral vigente en el tercer bimestre del 2020", "trabajador no tiene las ultimas aportaciones registradas",

Contact

Reviews in Video YouTube Comments

Web on https://sanchezcarlosjr.com/

Do you have any questions, suggestions or issues?

Roadmap

Regions

https://us-west4-arsus-production.cloudfunctions.net/infonavit
https://us-central1-arsus-production.cloudfunctions.net/infonavit

FAQ

Does the API Key have a expire time?

No. It doesn't. You're free to use unlimited it. But, We don't responsible by bad use.

How can you help yourself, and me too? No money. Yes learning.

Do you want to learn about high computer science? Then subscribe to my Arsus Channel. Thank you so much.

Is this an open-source project?

Yes, this a open-source project on GitHub. Happy code!