🇪🇸Spain Citizen

Service to query Spanish citizens using the DNI (National Identity Document) or NIE (Foreigner Identification Number).

Spanish Resident Information for DNI or NIE

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

The Spanish resident information service you can easily verify the validity of Spanish Identity Cards (DNI/NIE) by providing the document number and the expiration date. The response includes the document type, document number, full name, first name, last name, and an array of names.

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: DNIES, NIE.	DNIES
documentNumber	String	True	Document number of the person to consult without spaces.	123456789
date	String	True	The date on which the document to be consulted expires. Valid format: DD/MM/YYYY.	17/07/2024

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/es/cedula>',
  params: {
		  documentType: 'DNIES', 
		  documentNumber: '12345678H', 
		  date: '17/07/2024'
				  },
  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/es/cedula?documentType=DNIES&documentNumber=12345678H&date=17/07/2024", 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/es/cedula?documentType=DNIES&documentNumber=12345678H&date=17%2F07%2F2024")!,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/es/cedula?documentType=DNIES&documentNumber=12345678H&date=17/07/2024');
$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": "DNIES",
        "documentNumber": "53578667Y",
        "fullName": "CARMEN BEATRIZ ROMERO RODRIGUEZ",
        "firstName": "CARMEN BEATRIZ",
        "lastName": "ROMERO RODRIGUEZ",
        "arrayName": [
            "ROMERO",
            "RODRIGUEZ",
            "CARMEN",
            "BEATRIZ"
        ]
    },
    "signature": {
        "dateTime": "March 12, 2024 9:16 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "UCEJG"
}

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: [DNIES,NIE]"
}

409

{
    "code": "MissingParameter",
    "message": "Format incorrect: documentNumber"
}

409

{
    "code": "MissingParameter",
    "message": "date format required: DD/MM/YYYY\n"
}