Social Security

Description

The Argentina Social Security service allows to validate an individual's social security contributions information issued by ANSES (Administración Nacional de la Seguridad Social).

HTTP method GET

Endpoint

https://api.msla-id.com/experience-idv-socialsecurity-api-v1/api/idv-govcheck/v1/ar-identity/social-security?CUIL={CUIL}

[SANDBOX Environment]

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

Query request parameter

NAME	REQUIRED	TYPE	DESCRIPTION	EXAMPLE
CUIL	✅	string	Argentina labor identification number	20123456789

info

If the person doesn't have data for a given section, that section is returned empty ("data": [], "totalCount": 0). The endpoint still shows whichever other sections do have data for that CUIL.

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error.
504	Gateway timeout.

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "34372f63ac42d547",
    "timestamp": "2024-10-17 12:04:00",
    "data": {
        "id": 1,
        "cuil": 20123456789,
        "presentationDate": "2023-10-13",
        "paid": true,
        "totalCount": 1,
        "activity": {
            "data": [
                {
                    "cuil": 20123456789,
                    "description": "Comercio Minorista",
                    "ciiu": 4711
                }
            ],
            "totalCount": 1
        },
        "healthInsurance": {
            "data": [
                {
                    "description": "OSDE",
                    "code": "OS1234"
                }
            ],
            "totalCount": 1
        },
        "employerContributions": {
            "data": [
                {
                    "period": "2023-09",
                    "employeeCount": 5,
                    "employees": [
                        {
                            "cuil": 20123456780,
                            "name": "Juan Pérez"
                        }
                    ]
                }
            ],
            "totalCount": 1
        },
        "salaries": {
            "data": [
                {
                    "period": "2023-09",
                    "remuneration": 150000,
                    "cuil": 20123456789,
                    "cuit": 30567891234
                }
            ],
            "totalCount": 1
        },
        "domesticEmployees": {
            "data": [
                {
                    "domesticWorker": {
                        "id": 1,
                        "cuil": 27123456789,
                        "status": "Activo",
                        "name": "Ana Gómez",
                        "employerCuil": 30567891234,
                        "startDate": "2022-01-01",
                        "endDate": "",
                        "paymentMode": "Mensual",
                        "salary": 60000
                    },
                    "contributions": [
                        {
                            "id": 2,
                            "cuil": 27123456789,
                            "presentationDate": "2023-09-30",
                            "paid": true
                        }
                    ]
                }
            ],
            "totalCount": 1
        },
        "domesticContributions": {
            "data": [
                {
                    "id": 2,
                    "cuil": 27123456789,
                    "presentationDate": "2023-09-30",
                    "paid": true
                }
            ],
            "totalCount": 1
        },
        "socialSecurity": {
            "data": [
                {
                    "cuil": 20123456789,
                    "period": "2023-09",
                    "socialSecurityEmployeeContributions": 10000,
                    "socialSecurityEmployerContributions": 5000,
                    "socialSecurityWithholding": 2000,
                    "healthInsuranceEmployeeContributions": 8000,
                    "healthInsuranceEmployerContributions": 4000,
                    "healthInsuranceWithholding": 1000
                }
            ],
            "totalCount": 1
        },
        "retirement": {
            "data": [
                {
                    "cuil": 20123456789,
                    "representativeCuil": 30567891234,
                    "grossSalary": "200000",
                    "netSalary": "180000",
                    "accountHolder": "Carlos López",
                    "representative": "María Fernández",
                    "period": "2023-09"
                }
            ],
            "totalCount": 1
        }
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-3010",
    "message": "Bad request - Invalid or missing CUIL",
    "data": null
}

Response 401 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 401,
    "error": "Unauthorized",
    "path": "/api/idv-govcheck/v1/ar-identity/social-security"
}

Response 404 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-1002",
    "message": "Data not found.",
    "data": null
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administrator!",
    "data": null
}

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}

Response 504 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-3011",
    "message": "Service execution timeout",
    "data": null
}