Real-time Mexican Data All APIQueryMexicoFamilyProfile
/imss/vigencia/family-20%$0.2 USDT/call$0.16 USDT/callFree billing instructions: No billing will be charged in case of abnormalities
Billing instructions for empty value: The interface is limited to 10 free empty value times per day
Empty value definition: The server query result is empty and no data was found
Query Mexico IMSS holder and family profile by CURP
These examples use complete synthetic data. Use your own authorized input in Online Test to see the actual API response.
Start using this endpoint
- Create an account, or use your existing one.
- Copy your API token from Account → Security.
- Enter your token and your own authorized input in Online Test. Masked examples are format hints and must be replaced.
Online tests are subject to your account’s test quota and the gateway rules. For production calls, check the endpoint price and your available balance before sending. Open balance and recharge
Header Parameters
| Name | Type | Required | Description |
|---|---|---|---|
X-Api-Token | string | Required | Your platform API token |
Parameters
| Name | In | Type | Required | Example | Description |
|---|---|---|---|---|---|
curp | query | string | Required | TEST900101HDFABC01 | 18-character CURP code |
Response 200JSON
{
"data": {
"holder": {
"name": "SAMPLE USER",
"birthDate": "1990-01-01",
"nss": "00000000000",
"curp": "TEST900101HDFABC01",
"phone": "0000000000",
"address": "..."
},
"beneficiaries": [
{
"name": "SAMPLE USER",
"birthDate": "1990-01-01",
"nss": "00000000000",
"curp": "TEST900101HDFABC01",
"phone": "",
"address": "..."
}
]
},
"status": 200,
"message": "Found",
"success": true
}Data source
- Held by
- IMSS — Instituto Mexicano del Seguro Social Official site
- Data category
- Social security enrolment and NSS
- Country
- Mexico · Public institution
API Pull does not hold its own copy of this record. Each call is forwarded to the source above and the response is returned as received; accuracy and availability depend on that source.
Rate limits & free allowance
- Requests per second
- 10
- Free empty results per day
- 10
Calls that return no matching record are not charged, up to this many per day. Beyond it, an empty result is billed at the unit price.
Balance is consumed at the time of the call. When it does not cover the call, the gateway returns 402 and the call is not made.
Error codes
Status codes observed in production, with how to handle each. Codes not listed here have not occurred.
| Code | What it means and what to do |
|---|---|
200 | Request reached the upstream source and a response was returned. This includes “no record found”, so check the payload, not just the code. |
402 | Prepaid balance did not cover the call. The call was not made and nothing was charged. Top up and retry. |
504 | Upstream source did not answer in time. Retry later; this is the normal failure mode for slow registries. |
404 | Route does not exist, or the endpoint is no longer published. |
401 | Missing or invalid API token. |
Conditions of use
This endpoint returns personal data about an identifiable individual held by a national registry or institution. You must have a lawful basis for each identifier you query, must not enumerate identifier ranges, and must not use a result as the sole basis for a decision that adversely affects someone.