curl -X POST https://verification.didit.me/v3/kyb/shareholders/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "kyb_response_id": "69aeeb95febb0f1704042259",
    "vendor_data": "company-1234"
  }'

import os, time, requests

search = requests.post(
    "https://verification.didit.me/v3/kyb/search/",
    headers={"x-api-key": os.environ["DIDIT_API_KEY"]},
    json={"country_code": "GB", "name": "Tesco"},
    timeout=60,
).json()
kyb_response_id = search["kyb_registry"]["companies"][0]["kyb_response_id"]

resp = requests.post(
    "https://verification.didit.me/v3/kyb/shareholders/",
    headers={"x-api-key": os.environ["DIDIT_API_KEY"]},
    json={"kyb_response_id": kyb_response_id, "vendor_data": "company-1234"},
    timeout=90,
)
resp.raise_for_status()
data = resp.json()
request_id = data["request_id"]
print("Keep this request ID:", request_id)
company = data["kyb_registry"]
if resp.status_code == 202 or company.get("fetch_status") == "pending":
    # This client wait limit does not cancel the report or create a new purchase.
    deadline = time.monotonic() + 300
    while company.get("fetch_status") != "resolved" and time.monotonic() < deadline:
        time.sleep(5)
        decision = requests.get(
            f"https://verification.didit.me/v3/session/{request_id}/decision/",
            headers={"x-api-key": os.environ["DIDIT_API_KEY"]},
            timeout=30,
        )
        decision.raise_for_status()
        checks = decision.json().get("registry_checks") or []
        if checks:
            company = checks[0].get("company") or company
if company.get("fetch_status") == "resolved":
    print(company["company_name"], company["registry_tier_delivered"])
else:
    print("Still processing; retrieve this request later:", request_id)

const res = await fetch('https://verification.didit.me/v3/kyb/shareholders/', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    kyb_response_id: '69aeeb95febb0f1704042259',
    vendor_data: 'company-1234',
  }),
});
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
const requestId = data.request_id;
console.log('Keep this request ID:', requestId);
let company = data.kyb_registry;
if (res.status === 202 || company.fetch_status === 'pending') {
  // This client wait limit does not cancel the report or create a new purchase.
  const deadline = Date.now() + 300000;
  while (company.fetch_status !== 'resolved' && Date.now() < deadline) {
    await new Promise(resolve => setTimeout(resolve, 5000));
    const decisionResponse = await fetch(
      `https://verification.didit.me/v3/session/${requestId}/decision/`,
      { headers: { 'x-api-key': 'YOUR_API_KEY' }, signal: AbortSignal.timeout(30000) },
    );
    if (!decisionResponse.ok) throw new Error(`Retrieval failed: ${decisionResponse.status}`);
    const decision = await decisionResponse.json();
    company = decision.registry_checks?.[0]?.company ?? company;
  }
}
if (company.fetch_status === 'resolved') {
  console.log(company.company_name, company.registry_tier_delivered);
} else {
  console.log('Still processing; retrieve this request later:', requestId);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://verification.didit.me/v3/kyb/shareholders/",
  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([
    'kyb_response_id' => '69aeeb95febb0f1704042259',
    'vendor_data' => '<string>',
    'metadata' => [
        
    ],
    'save_api_request' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <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://verification.didit.me/v3/kyb/shareholders/"

	payload := strings.NewReader("{\n  \"kyb_response_id\": \"69aeeb95febb0f1704042259\",\n  \"vendor_data\": \"<string>\",\n  \"metadata\": {},\n  \"save_api_request\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<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://verification.didit.me/v3/kyb/shareholders/")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"kyb_response_id\": \"69aeeb95febb0f1704042259\",\n  \"vendor_data\": \"<string>\",\n  \"metadata\": {},\n  \"save_api_request\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://verification.didit.me/v3/kyb/shareholders/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"kyb_response_id\": \"69aeeb95febb0f1704042259\",\n  \"vendor_data\": \"<string>\",\n  \"metadata\": {},\n  \"save_api_request\": true\n}"

response = http.request(request)
puts response.read_body