Social Security

Description

Validate information from Social Security contributions issued by ANSES.

HTTP method GET

Endpoint

http://apidev3.mslainternational.com/lexisnexis/api/idv-govcheck/v1/social-security

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Country	✅	string	Argentina
CUIL	✅	string	Argentina labor identification number

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

{
    "traceId": "34372f63ac42d547",
    "timestamp": "2024-10-17 12:04:00",
    "data": {
        "errorMessage": null,
        "errorCode": null,
        "id": 1,
        "cuil": 20123456789,
        "fecpres": "2023-10-13",
        "pago": true,
        "cantTotal": 1,
        "actividad": {
            "datos": [
                {
                    "cuil": 20123456789,
                    "descripcion": "Comercio Minorista",
                    "ciiu": 4711
                }
            ],
            "cantTotal": 1
        },
        "obraSocial": {
            "datos": [
                {
                    "descripcion": "OSDE",
                    "codigo": "OS1234"
                }
            ],
            "cantTotal": 1
        },
        "empAportes": {
            "datos": [
                {
                    "periodo": "2023-09",
                    "cantidadEmpleados": 5,
                    "empleados": [
                        {
                            "cuil": 20123456780,
                            "nombre": "Juan Pérez"
                        }
                    ]
                }
            ],
            "cantTotal": 1
        },
        "sueldos": {
            "datos": [
                {
                    "periodo": "2023-09",
                    "remuneracion": 150000,
                    "cuil": 20123456789,
                    "cuit": 30567891234
                }
            ],
            "cantTotal": 1
        },
        "empDomesticos": {
            "datos": [
                {
                    "domestico": {
                        "id": 1,
                        "cuil": 27123456789,
                        "estado": "Activo",
                        "nombre": "Ana Gómez",
                        "cuilEmple": 30567891234,
                        "alta": "2022-01-01",
                        "baja": "N/A",
                        "modoLiquida": "Mensual",
                        "sueldo": 60000
                    },
                    "aportes": [
                        {
                            "id": 2,
                            "cuil": 27123456789,
                            "fecpres": "2023-09-30",
                            "pago": true
                        }
                    ]
                }
            ],
            "cantTotal": 1
        },
        "domAportes": {
            "datos": [
                {
                    "id": 2,
                    "cuil": 27123456789,
                    "fecpres": "2023-09-30",
                    "pago": true
                }
            ],
            "cantTotal": 1
        },
        "seguridadSocial": {
            "datos": [
                {
                    "cuil": 20123456789,
                    "periodo": "2023-09",
                    "segSocialAportes": 10000,
                    "segSocialContribu": 5000,
                    "segSocialRetencion": 2000,
                    "obSocialAportes": 8000,
                    "obSocialContribu": 4000,
                    "obSocialRetencion": 1000
                }
            ],
            "cantTotal": 1
        },
        "jubilacion": {
            "datos": [
                {
                    "cuil": 20123456789,
                    "cuilApo": 30567891234,
                    "sueldoBruto": "200000",
                    "sueldoNeto": "180000",
                    "titular": "Carlos López",
                    "apoderado": "María Fernández",
                    "periodo": "2023-09"
                }
            ],
            "cantTotal": 1
        }
    }
}

Response 404 status code

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

Response 400 status code

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

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administration."
}