Identity Match Score

Description

Validate an individual's identity against Colombia's National Civil Registry (ANI) by comparing the provided identity data with official records. The service returns an overall identity match score, document validation result, document status, and detailed matching scores for names, surnames, and issuance date to support KYC, fraud prevention, and customer onboarding processes.

info

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

HTTP method POST

Endpoint

https://api.msla-id.com/experience-idv-docverifcheck-api-v1/api/idv-govcheck/v1/co-identity/ani-check

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

Request body parameter

NAME	REQUIRED	TYPE	DESCRIPTION
documentNumber	✅	string	Citizen identification number (max. 12 characters).
firstName		string	Citizen's first name.
secondName		string	Citizen's second name..
firstLastName		string	Citizen's first surname.
secondLastName		string	Citizen's second surname.
issueDate		string	Document issue date (yyyy-mm-dd).

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": "eb0fa1750ee919ee",
    "timestamp": "2026-08-26 12:25:49",
    "data": {
        "validationResult": "DOCUMENTO 1130673043 ENCONTRADO - Validación Exitosa",
        "validationScore": 91.66666666666667,
        "documentStatus": "true",
        "matches": {
            "issueDateMatches": false,
            "firstNameScore": 83.33333333333334,
            "secondNameScore": 0.0,
            "firstLastNameScore": 100.0,
            "secondLastNameScore": 0.0,
            "deathDateFound": false
        }
    }
} 

Response 400 status code

{
    "traceId": "87f0dc3e70773a74",
    "timestamp": "2026-08-26 12:42:26",
    "code": "IDV-CO4004",
    "message": "Document number is required and must not be empty."
}

{
    "traceId": "4e963d36a41305eb",
    "timestamp": "2026-08-26 12:43:36",
    "code": "IDV-CO4002",
    "message": "Invalid parameters in request for ANI check."
}

Response 401 status code

{
    "timestamp": "2026-08-26T17:44:06.169+00:00",
    "status": 401,
    "error": "Unauthorized",
    "message": "Unauthorized",
    "path": "/api/idv-govcheck/v1/co-identity/ani-check"
}

Response 404 status code

{
    "traceId": "2f0e299b44d5a594",
    "timestamp": "2026-08-26 13:02:55",
    "code": "IDV-1002",
    "message": "Data not found."
}

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.",
"data": null
}

Response 504 status code

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