This service allows you to verify the authenticity of a Costa Rican National ID card (Cédula) by providing the document number. The response includes the cardholder's full name, along with their first and last names separately.

This service is useful for confirming the validity of a Costa Rican National ID for various purposes, such as identity verification and background checks.

To use this service in a graphical interface, we invite you to access our client panel at Verifik.

Parameters

Name Type ¿Required? Description Example
documentType String True Document type. Allowed parameter: CCCR. CCCR
documentNumber String True Document number of the person to consult without spaces. 123456789

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/cr/cedula>',
  params: {documentType: 'CCCR', documentNumber: '123456789'},
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Response 200 - (Successful response)

{
  "data": {
    "documentType": "CCCR",
    "documentNumber": "123456789",
    "fullName": "MATEO VERIFIK",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "arrayName": [
      "MATEO",
      "VERIFIK"
    ]
  },
  "signature": {
    "dateTime": "April 11, 2023 12:25 PM",
    "message": "Certified by Verifik.co"
  }
}

Other responses

Code Description Response Body
404 Not Found Information not found. {
"code": "NotFound",
"message": "Record not found.",
"signature": {
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"
}
}
409 Conflict Some parameters are missing. {
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
409 Conflict Invalid documentType for this query. {
"code": "MissingParameter",
"message": "documentType must be one of: [CCCR]"
}