Person Check

Description

Obtain the full names and surnames of an Ecuadorian citizen from the Civil Registry.

info

Before proceeding, make sure you have your jwt token, if you don't have it, check the login documentation.

HTTP method GET

Endpoint

http://apidev3.mslainternational.com/lexisnexis/api/idv-govcheck/v1/ecu-check/validate

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	Bearer {Json Web Token}

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION
documentType	✅	string	CCEC.
documentNumber	✅	string	Identity card 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": "c824b59769fec973",
    "timestamp": "2024-06-27 08:55:04",
    "data": {
        "errorMessage": null,
        "errorCode": null,
        "documentType": "CCEC",
        "documentNumber": "0927138842",
        "fullName": "CARLOS JULIO BRAN MATICURENA",
        "firstName": "CARLOS JULIO",
        "lastName": "BRAN MATICURENA",
        "arrayName": [
            "BRAN",
            "MATICURENA",
            "CARLOS",
            "JULIO"
        ]
    }
}

Response 400 status code

Scenario 1

{
    "traceId": "76b3e0a80adc6585",
    "timestamp": "2024-04-04 17:25:44",
    "code": "IDV-3001",
    "message": "Provider error, contact with the administrator.",
    "data": null
}

Note: Error in the source of origin, please contact an administrator

Scenario 2

{
    "traceId": "0829a4407237096a",
    "timestamp": "2024-06-25 09:02:15",
    "code": "IDV-1002",
    "message": "Data not found."
}

Note: Ensure that the request contains the necessary data and try again.

Response 500 status code

{
  "traceId": "86c6eda02b615604",
  "timestamp": "2024-01-09 15:44:32",
  "code": "IDV-1008",
  "message": "Error in the source of origin, please contact an administrator!",
  "data": null
}