ONU Background Check

API Reference

Endpoint

https://api.verifik.co/v2/onu

Query the United Nations sanctions list to see whether a person or entity appears using documentType and documentNumber, or fullName. Use the results for global compliance, KYC, and AML workflows when screening counterparties.

Note: Dates (date of birth or expedition date) must be in dd/mm/yyyy format.

Headers

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

Parameters

info

For the complete list of supported Document Types and their specific mandatory parameters, please visit the Document Types guide.

Name	Type	Required	Description
documentType	string	No	Document type that you want to request
documentNumber	string	No	Document number to consult, without spaces or points
fullName	string	No	Instead of documentType and documentNumber, you can pass the name directly of the person/business

Use Cases

• International compliance: Verify individuals and entities against UN sanctions before onboarding or transactions.
• Risk assessment: Reduce financial and reputational exposure from sanctioned parties.
• Regulatory programs: Support banking, finance, and insurance KYC/AML requirements.

Request

JavaScript

import axios from "axios";

const options = {
  method: "GET",
  url: "https://api.verifik.co/v2/onu",
  params: { documentType: "CC", documentNumber: "80251972" },
  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")

headers = {
    'Accept': "application/json",
    'Authorization': "JWT token"
}

conn.request("GET", "/v2/onu?fullName=", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "JWT token"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/onu?fullName=")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/onu?fullName=', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'JWT token',
  ],
]);

echo $response->getBody();

Response

200

{
  "data": {
    "documentType": "CC",
    "documentNumber": "1234567894",
    "fullName": "MATEO VERIFIK",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "arrayName": ["MATEO", "VERIFIK"],
    "foundInONU": true
  },
  "signature": {
    "dateTime": "August 4, 2022 3:57 PM",
    "message": "Certified by Verifik.co"
  }
}

404

{
  "code": "NotFound",
  "message": "Record not found."
}

409

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

Notes

• UN sanctions verification for persons and entities.
• Structured responses for integration; supports JavaScript, Python, PHP, and Swift examples above.