The Colombian Citizen Identification Information with Extra Data service provides comprehensive details about a Colombian citizen's identification document, extending beyond basic identification information. By supplying the identification number and type of document, you can retrieve not only the citizen’s full name, first name, last name, and identification number but also additional information such as date of birth, gender, and status of living.

Note: This service is specifically for Colombian identification documents. For verification of documents from other countries or different types of identification, please refer to the documentation for the relevant service.

Parameters

Name Type ¿Required? Description Example
documentType String True Type of document. Valid parameter: CC. CC
documentNumber String True Document number of the person to consult, without spaces or periods. 123456789
date String True Document issue date. Valid format: DD/MM/YYYY. 10/10/2020

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/cedula/extra>',
  params: {documentType: 'CC', documentNumber: '123456789', date: '10/10/2020'},
  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": "CC",
    "documentNumber": "123456789",
    "fullName": "MATEO VERIFIK",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "arrayName": [
      "MATEO",
      "VERIFIK"
    ],
    "expeditionDate": "2022-05-10T00:00:00.000Z",
    "expeditionPlace": {
      "municipio": "BOGOTA D.C.",
      "departamento": "BOGOTA"
    },
    "dateOfBirth": "1999-05-07T00:00:00.000Z",
    "gender": "HOMBRE",
    "isAlive": true
  },
  "signature": {
    "dateTime": "August 23, 2022 11:42 AM",
    "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: [CC]" } | | 409 | Conflict | Invalid date format. | { "code": "MissingParameter", "message": "date format required: DD/MM/YYYY\n" } |