🇪🇨Ecuador

Service to query Ecuadorian citizens using the National Identity Document.

Ecuadorian Citizen Information

GET - https://api.verifik.co/v2/ec/cedula

This service allows users to obtain basic information about an individual based on their Ecuadorian identification number. By providing the document type and number as parameters, the service returns the person's full name, first and last names separately.

Implementation

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query Parameters

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

Request

JavaScript

import axios from 'axios';

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

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

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/ec/cedula?documentType=CCEC&documentNumber=0123456789", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/ec/cedula?documentType=CCEC&documentNumber=0123456789")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/ec/cedula?documentType=CCEC&documentNumber=0123456789');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Response

200

{
  "data": {
    "documentType": "CCEC",
    "documentNumber": "0123456789",
    "fullName": "MATEO VERIFIK",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "arrayName": [
      "MATEO",
      "VERIFIK"
    ],
    "signature": {
        "dateTime": "March 12, 2024 6:16 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "HR6YN"
}

404

{
    "code": "NotFound",
    "message": "Record not found.",
    "signature": {
        "dateTime": "August 31, 2022 3:24 PM",
        "message": "Certified by Verifik.co"
    }
}

409

{
    "code": "MissingParameter",
    "message": "missing documentType\n. missing documentNumber\n"
}

409

{
    "code": "MissingParameter",
    "message": "documentType must be one of: [CCEC]"
}

Other responses