KYB - Global
Premium Company Search
Advanced company verification endpoint supporting multiple countries with premium checks available for Nigeria, South Africa, and Kenya.
POST
/
v2
/
api
/
verifications
/
global
/
company-advance-check
Premium Company Search
curl --request POST \
--url https://api.youverify.co/v2/api/verifications/global/company-advance-check \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"registrationNumber": "PVT-JZUA6Z663",
"premium": true,
"countryCode": "KE",
"isConsent": true
}
'import requests
url = "https://api.youverify.co/v2/api/verifications/global/company-advance-check"
payload = {
"registrationNumber": "PVT-JZUA6Z663",
"premium": True,
"countryCode": "KE",
"isConsent": True
}
headers = {
"token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {token: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
registrationNumber: 'PVT-JZUA6Z663',
premium: true,
countryCode: 'KE',
isConsent: true
})
};
fetch('https://api.youverify.co/v2/api/verifications/global/company-advance-check', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.youverify.co/v2/api/verifications/global/company-advance-check",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'registrationNumber' => 'PVT-JZUA6Z663',
'premium' => true,
'countryCode' => 'KE',
'isConsent' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.youverify.co/v2/api/verifications/global/company-advance-check"
payload := strings.NewReader("{\n \"registrationNumber\": \"PVT-JZUA6Z663\",\n \"premium\": true,\n \"countryCode\": \"KE\",\n \"isConsent\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.youverify.co/v2/api/verifications/global/company-advance-check")
.header("token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"registrationNumber\": \"PVT-JZUA6Z663\",\n \"premium\": true,\n \"countryCode\": \"KE\",\n \"isConsent\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.youverify.co/v2/api/verifications/global/company-advance-check")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"registrationNumber\": \"PVT-JZUA6Z663\",\n \"premium\": true,\n \"countryCode\": \"KE\",\n \"isConsent\": true\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"statusCode": 200,
"message": "success",
"data": {
"status": "found",
"registrationNumber": "PVT-JZUA6Z663",
"countryCode": "KE",
"note": "Full response contains 100+ fields including name, registration number, VAT, status, contact information, shareholders, filings, and affiliates."
},
"links": []
}{
"success": false,
"statusCode": 401,
"message": "Permission denied",
"name": "UnauthorizedError",
"data": {}
}{
"success": false,
"statusCode": 402,
"message": "Insufficient fund",
"name": "PaymentRequiredError",
"data": {}
}{
"success": false,
"statusCode": 404,
"message": "You have attempted to get a resource that does not exist.",
"name": "ResourceNotFoundError",
"data": {}
}{
"success": false,
"statusCode": 429,
"message": "Too many requests",
"name": "RateLimitError",
"data": {}
}{
"success": false,
"statusCode": 500,
"message": "Internal Server Error",
"name": "Error",
"data": {}
}Authorizations
Your Youverify API secret key. Never expose client-side.
Headers
API secret token
Body
application/json
Kenyan Company Registration number
For any country with sub-divisions, always use the code of the sub-divisions and don't use the main country code
Indicate you have consent. Must be true
Registered name of the business. Provide this to refine the search, especially for older companies. Only for Nigerian companies.
Perform premium checks, currently exclusive NG, ZA and KE
Response
Found or not found response
⌘I
Premium Company Search
curl --request POST \
--url https://api.youverify.co/v2/api/verifications/global/company-advance-check \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"registrationNumber": "PVT-JZUA6Z663",
"premium": true,
"countryCode": "KE",
"isConsent": true
}
'import requests
url = "https://api.youverify.co/v2/api/verifications/global/company-advance-check"
payload = {
"registrationNumber": "PVT-JZUA6Z663",
"premium": True,
"countryCode": "KE",
"isConsent": True
}
headers = {
"token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {token: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
registrationNumber: 'PVT-JZUA6Z663',
premium: true,
countryCode: 'KE',
isConsent: true
})
};
fetch('https://api.youverify.co/v2/api/verifications/global/company-advance-check', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.youverify.co/v2/api/verifications/global/company-advance-check",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'registrationNumber' => 'PVT-JZUA6Z663',
'premium' => true,
'countryCode' => 'KE',
'isConsent' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.youverify.co/v2/api/verifications/global/company-advance-check"
payload := strings.NewReader("{\n \"registrationNumber\": \"PVT-JZUA6Z663\",\n \"premium\": true,\n \"countryCode\": \"KE\",\n \"isConsent\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.youverify.co/v2/api/verifications/global/company-advance-check")
.header("token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"registrationNumber\": \"PVT-JZUA6Z663\",\n \"premium\": true,\n \"countryCode\": \"KE\",\n \"isConsent\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.youverify.co/v2/api/verifications/global/company-advance-check")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"registrationNumber\": \"PVT-JZUA6Z663\",\n \"premium\": true,\n \"countryCode\": \"KE\",\n \"isConsent\": true\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"statusCode": 200,
"message": "success",
"data": {
"status": "found",
"registrationNumber": "PVT-JZUA6Z663",
"countryCode": "KE",
"note": "Full response contains 100+ fields including name, registration number, VAT, status, contact information, shareholders, filings, and affiliates."
},
"links": []
}{
"success": false,
"statusCode": 401,
"message": "Permission denied",
"name": "UnauthorizedError",
"data": {}
}{
"success": false,
"statusCode": 402,
"message": "Insufficient fund",
"name": "PaymentRequiredError",
"data": {}
}{
"success": false,
"statusCode": 404,
"message": "You have attempted to get a resource that does not exist.",
"name": "ResourceNotFoundError",
"data": {}
}{
"success": false,
"statusCode": 429,
"message": "Too many requests",
"name": "RateLimitError",
"data": {}
}{
"success": false,
"statusCode": 500,
"message": "Internal Server Error",
"name": "Error",
"data": {}
}