IMSS · API

IMSS through an API: employment, contribution weeks and NSS.

Three IMSS queries with a single input: the CURP. Know whether a person works today, see their full work history or get their Social Security Number, with a structured response ready for your system.

Request access → View documentation ›

input: CURP onlyresult to your webhookthree services, one contract

Technical questions? Talk to an engineer on WhatsApp — 0% bots.

imssTHE THREE SERVICES

Pick what you need to know:

All three take the CURP and deliver the result to your webhook.

Which one do I need?

Three different questions, three services.

All three query IMSS and all three start from the CURP. The difference is what each one answers.

	Employment verification	Contribution weeks	NSS lookup
The question it answers	Do they work today, and for whom?	What has their work history been?	What is their Social Security Number?
What you send	The CURP. The NSS is optional: if you send it, it is checked.	The CURP.	The CURP.
What you get	Whether they are currently employed, the employer with its tax ID and registration, the base salary and the contributed days of the period.	The contributed weeks, the full job history and calculated signals for tenure, stability and salary, each with its formula.	The 11-digit NSS, or the exact reason if it does not exist.
Official document	The IMSS report as a PDF, if you ask for it.	The certificate as a PDF, with folio and digital seal. Always.	Not applicable.
Cost per resolved query	2 credits	3 credits	2 credits
Use it when	You need to confirm the current job and income.	You need to assess stability and income over time.	You are going to register someone and do not have their NSS.
	See employment verification →	See contribution weeks →	See NSS lookup →

Who uses it

To decide with the employer's data, not with what was declared.

Lending and fintechVerify employment and income before approving, and measure job stability to size the limit and the term.

◈

Payroll and HRRegister people without asking for the Social Security card and confirm the track record on a résumé.

⚑

Leasing and insuranceCheck that the applicant has a current formal job and an income consistent with what they declared.

Available today

We do not ask you to trust us. Check it.

It is common for an IMSS service to appear in a catalog or in some documentation and not exist when it is time to integrate. So before talking to us, there are three things you can check on your own.

The endpoint is publishedWith its route, its inputs and its cost in credits, in the open API reference. No sign-up.See the endpoint ↗

Every response has its exampleEvery case it can return, with the full JSON for each one. Not a general description: the contract.See the examples ↗

You test it with your own casesWe enable courtesy credits in production. You send your own CURPs and see what comes back, before signing anything.Request access →

How it works

You send the CURP. The result arrives at your system.

All three queries work the same way: you send the request with an address of yours, called a webhook, you get a receipt right away and the result arrives at that address as soon as it is ready.

{ }

You send the CURPwith your webhook address

You get a receiptwith a query ID

✓

The result arrivesat your webhook, with the same ID

First time using a webhook? We explain it step by step →

OrigoID is not IMSS and does not act on its behalf: it is a technical means of querying and cross-checking against that source. The accuracy and currency of the information depend on the institute itself.

Frequently asked

What people usually ask us.

What can be queried from IMSS through an API?

Three things, all from the CURP: whether the person is currently employed and with which employer; their Certificate of Contributed Weeks, with the full work history; and their Social Security Number.

What is the difference between employment verification and contribution weeks?

Employment verification answers for the present: whether they work today, for whom and with what base salary. Contribution weeks answers for the whole track record: every job they have had, with dates and salaries, plus calculated stability signals.

Do I need the NSS to run a query?

No. All three queries start from the CURP. In employment verification the NSS is optional: if you send it, it is checked against the one IMSS has on record.

How do I receive the result?

At your webhook. When you create the query you get a receipt with an ID; when the result is ready we send it to your address with that same ID.

How much does it cost?

Employment verification and NSS lookup use 2 credits per resolved query; contribution weeks uses 3. The receipt is not charged. Plans are published.

Is OrigoID part of IMSS?

No. OrigoID is not IMSS and does not act on its behalf: it is a technical means of querying that source. The accuracy and currency of the information depend on the institute itself.