ID Status

Description

Costa Rica Document Verification Check allows clients to validate a Costa Rican national ID card against official civil and electoral records maintained by the Official National ID issuer.

The service verifies whether the provided ID Card Number corresponds to an existing Costa Rican citizen record and returns the associated civil identity and electoral registration data available. The response may include the person's first name, paternal surname, maternal surname, ID card expiration date, electoral code, electoral board, and registered electoral location, including province, canton, and district.

This check is designed for KYC, identity verification, customer onboarding, fraud prevention, and document validation workflows where the client needs to confirm that a Costa Rican ID card number is valid and linked to the expected civil identity record.

HTTP method GET

Endpoint

https://api.msla-id.com/experience-idv-docverifcheck-api-v1/api/idv-govcheck/v1/cr-identity/id-status

[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 have it, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION
documentNumber	✅	string	Costa Rican identification data by means of the identity document.

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": "fe36278f86dd9d98",
    "timestamp": "2026-06-22 14:57:31",
    "data": {
        "idCard": "101240037",
        "electoralCode": "823001",
        "expirationDate": "20300204",
        "electoralBoard": "00000",
        "firstName": "ANA MARIA",
        "fatherSurname": "PEREZ",
        "motherSurname": "PEREZ",
        "sex": null,
        "province": "CONSULADO",
        "canton": "MEXICO",
        "district": "CIUDAD DE MEXICO"
    }
}

Response 400 status code

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

Response 401 status code

{
    "traceId": "0829a4407237096a",
    "timestamp": "2024-06-25 09:02:15",
    "code": "IDV-1002"
}

Response 404 status code

{
    "traceId": "ef2407b8c0df635c",
    "timestamp": "2023-05-22 17:25:55",
    "code": "IDV-1002",
    "message": "Data not found."
}

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
}