Social Assistance Beneficiaries - Mexico
Description​
The Social Assistance Beneficiaries IDV Solution provides access to official Mexican government data related to individuals enrolled in federal welfare programs.
This service enables verification of whether an individual is a registered beneficiary of social assistance programs, supporting KYC enrichment, socioeconomic profiling, and fraud prevention use cases.
HTTP method POST​
Endpoint​
https://api.msla-id.com/experience-idv-financial-api-v1/api/idv-govcheck/v1/mx-social-assistance-beneficiaries/validate
For testing purposes, use the base domain: apidev.msla-id.com
info
Before proceeding, make sure you have your jwt token, if you don't, check the login documentation.
Request header parameter​
| NAME | REQUIRED | TYPE | DESCRIPTION |
|---|---|---|---|
| Authorization | ✅ | string | bearer jwt token |
| Content-Type | ✅ | string | application/json |
Request body parameter​
| NAME | REQUIRED | TYPE | DESCRIPTION |
|---|---|---|---|
| fullName | ✅ | string | Full name of the person to validate. |
| state | ✅ | string | Mexican state used for the search. |
Request body example​
{
"fullName": "JOSE LUIS PEREZ TRUJILLO",
"state": "AGUASCALIENTES"
}
Status code responses​
| Code | Description |
|---|---|
| 200 | OK |
| 400 | Bad request |
| 401 | Unauthorized |
| 404 | Not found |
| 500 | Internal server error. |
The full documentation error codes can be found here.
Response 200 status code​
{
"stateCode": "01",
"stateName": "AGUASCALIENTES",
"municipalityCode": "01001",
"municipalityName": "AGUASCALIENTES",
"firstLastName": "PEREZ",
"secondLastName": "TRUJILLO",
"givenNames": "JOSE LUIS",
"monetaryAmount": "6000.0",
"program": "PRODUCCION PARA EL BIENESTAR - PRODUCTORES INDIGENAS",
"governmentEntity": "SADER"
}
Response 400 status code​
{
"traceId": "542fc743fffda052",
"timestamp": "2026-05-05 11:20:46",
"code": "IDV-4005",
"message": "-",
"data": null
}
Response 401 status code​
{
"timestamp": "2026-05-05 11:20:46",
"status": 401,
"error": "Unauthorized",
"path": "/api/idv-govcheck/v1/mx-social-assistance-beneficiaries/validate"
}
Response 404 status code​
{
"timestamp": "2026-05-05 11:20:46",
"status": 404,
"error": "Not Found",
"path": "/api/idv-govcheck/v1/mx-social-assistance-beneficiaries/validate"
}
Response 500 status code​
{
"traceId": "43a20f33d4e8730d",
"timestamp": "2026-05-05 11:20:46",
"code": "IDV-1001",
"message": "A generic error has occurred.",
"data": null
}