Get a KYB verification (full detail)
curl --request GET \
--url https://api.example.com/api/v4/kyb/verifications/{caseId} \
--header 'ds-api-token: <api-key>'import requests
url = "https://api.example.com/api/v4/kyb/verifications/{caseId}"
headers = {"ds-api-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'ds-api-token': '<api-key>'}};
fetch('https://api.example.com/api/v4/kyb/verifications/{caseId}', 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.example.com/api/v4/kyb/verifications/{caseId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"ds-api-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"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v4/kyb/verifications/{caseId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("ds-api-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v4/kyb/verifications/{caseId}")
.header("ds-api-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v4/kyb/verifications/{caseId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["ds-api-token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "019f179b-0fa7-72c8-818e-819652540477",
"public_id": "KYBC8274B9CF4907859",
"organization_id": "o6e501dc4d3c6d9a4",
"applicant_id": "019f1383-8f38-7d31-b921-39310a19b444",
"external_id": "merchant-123",
"company_name": "Acme Holdings Inc.",
"country": "US",
"status": "rejected",
"stage": "manual_review",
"risk_level": "High",
"is_sandbox": false,
"created_at": "2026-07-01T08:10:00Z",
"submitted_at": "2026-07-01T08:15:00Z",
"company": {
"legal_name": "Acme Holdings Inc.",
"form_type": "US - Limited Liability Company (LLC)",
"entity_type": "Limited Liability Company (LLC)",
"registration_type": "EIN",
"registration_number": "16-1782204",
"country": "US",
"state": "NY",
"representative_name": "Joe Marrano",
"representative_email": "joe@acme.com"
},
"form_progress": {
"sections_completed": 8,
"sections_total": 8,
"sections": [
{
"key": "business",
"title": "Business details",
"state": "completed"
},
{
"key": "registration",
"title": "Business registration",
"state": "completed"
},
{
"key": "address_contact",
"title": "Business address",
"state": "completed"
},
{
"key": "representative",
"title": "Representative",
"state": "completed"
},
{
"key": "kyc",
"title": "KYC",
"state": "completed"
},
{
"key": "people",
"title": "Beneficial owners",
"state": "completed"
},
{
"key": "volume_banking",
"title": "Volumes & banking",
"state": "completed"
},
{
"key": "documents",
"title": "Documents",
"state": "completed"
}
]
},
"checks_summary": {
"expected": 9,
"completed": 7,
"passed": 5,
"review": 2,
"failed": 0,
"errored": 0,
"checks": [
{
"type": "registry",
"status": "completed",
"severity": "low",
"verdict": "active",
"completed_at": "2026-07-01T08:16:05Z"
},
{
"type": "tin",
"status": "completed",
"severity": "medium",
"verdict": "not_issued",
"completed_at": "2026-07-01T08:16:07Z"
},
{
"type": "document_verification",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-01T08:16:31Z"
},
{
"type": "aml_company",
"status": "completed",
"severity": "medium",
"verdict": "potential_match",
"completed_at": "2026-07-01T08:16:12Z"
},
{
"type": "aml_person",
"status": "completed",
"severity": "low",
"verdict": "no_hits",
"completed_at": "2026-07-01T08:16:14Z",
"instances": {
"expected": 3,
"completed": 3
}
},
{
"type": "doc_manipulation",
"status": "in_progress",
"severity": "low",
"verdict": "authentic",
"completed_at": "2026-07-01T08:16:40Z",
"instances": {
"expected": 8,
"completed": 3
}
},
{
"type": "cross_check",
"status": "pending"
},
{
"type": "kyc",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-01T08:16:45Z"
},
{
"type": "website_triage",
"status": "completed",
"severity": "low",
"verdict": "legitimate",
"completed_at": "2026-07-01T08:16:50Z"
}
]
},
"checks_summary_remediation": {
"expected": 9,
"completed": 8,
"passed": 6,
"review": 2,
"failed": 0,
"errored": 0,
"checks": [
{
"type": "registry",
"status": "completed",
"severity": "low",
"verdict": "active",
"completed_at": "2026-07-02T10:31:30Z"
},
{
"type": "tin",
"status": "completed",
"severity": "low",
"verdict": "match",
"completed_at": "2026-07-02T10:31:20Z"
},
{
"type": "document_verification",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-02T10:31:45Z"
},
{
"type": "aml_company",
"status": "completed",
"severity": "low",
"verdict": "no_hits",
"completed_at": "2026-07-02T10:32:20Z"
},
{
"type": "aml_person",
"status": "completed",
"severity": "medium",
"verdict": "potential_match",
"completed_at": "2026-07-02T10:32:25Z",
"instances": {
"expected": 3,
"completed": 3
}
},
{
"type": "doc_manipulation",
"status": "in_progress",
"severity": "low",
"verdict": "authentic",
"completed_at": "2026-07-02T10:32:10Z",
"instances": {
"expected": 4,
"completed": 3
}
},
{
"type": "cross_check",
"status": "completed",
"severity": "medium",
"verdict": "partial_match",
"completed_at": "2026-07-02T10:32:40Z"
},
{
"type": "kyc",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-02T10:32:45Z"
},
{
"type": "website_triage",
"status": "completed",
"severity": "low",
"verdict": "legitimate",
"completed_at": "2026-07-02T10:32:50Z"
}
]
},
"application": {
"id": "019f179b-0fa7-72c8-818e-819652540477",
"status": "under_review",
"sections": [
{
"key": "business",
"title": "Business details",
"kind": "fields",
"fields": [
{
"key": "legal_name",
"label": "Legal Business Name",
"type": "text",
"required": true,
"value": "Acme Holdings Inc",
"editable": false
},
{
"key": "dba",
"label": "DBA (Doing Business As)",
"type": "text",
"required": false,
"value": "Acme Capital",
"editable": false
},
{
"key": "entity_type",
"label": "Entity Type",
"type": "select",
"required": true,
"value": "Corporation",
"editable": false
},
{
"key": "form_type",
"label": "Federal Tax Classification",
"type": "select",
"required": true,
"value": "C-Corporation",
"editable": false
}
]
},
{
"key": "registration",
"title": "Business registration",
"kind": "fields",
"fields": [
{
"key": "registration_type",
"label": "Business Registration Type",
"type": "select",
"required": true,
"value": "EIN",
"editable": false
},
{
"key": "registration_type_other",
"label": "Specify registration type",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "registration_number",
"label": "Registration Number",
"type": "text",
"required": true,
"value": "36-2382580",
"editable": false,
"original_value": "36-2382XXX",
"remediation": {
"request_id": "019f1b00-0000-7000-8000-000000000001",
"remediation_item_id": "019f1b00-0000-7000-8000-000000000002",
"updated_at": "2026-07-02T10:20:00Z",
"changes_count": 1
}
},
{
"key": "industry_type",
"label": "Industry Type",
"type": "select",
"required": true,
"value": "General Retail",
"editable": false
},
{
"key": "mcc",
"label": "Merchant Category Code (MCC)",
"type": "select",
"required": true,
"value": "5999 - MISCELLANEOUS AND SPECIALTY RETAIL STORES",
"editable": false
},
{
"key": "incorporation_date",
"label": "Date of Incorporation",
"type": "date",
"required": true,
"value": "2022-03-15",
"editable": false
},
{
"key": "website",
"label": "Company Website",
"type": "text",
"required": true,
"value": "https://acme.example",
"editable": false,
"original_value": "https://acme.co"
}
]
},
{
"key": "address_contact",
"title": "Business address",
"kind": "fields",
"fields": [
{
"key": "reg_address_street",
"label": "Street address",
"type": "text",
"required": true,
"value": "123 Main Street",
"editable": false
},
{
"key": "reg_address_city",
"label": "City",
"type": "text",
"required": true,
"value": "Dover",
"editable": false
},
{
"key": "reg_address_state",
"label": "State / Region",
"type": "text",
"required": true,
"value": "DE",
"editable": false
},
{
"key": "reg_address_postal",
"label": "ZIP / Postal code",
"type": "text",
"required": true,
"value": "19901",
"editable": false
},
{
"key": "reg_address_country",
"label": "Country",
"type": "country",
"required": true,
"value": "US",
"editable": false
},
{
"key": "operating_same_as_reg",
"label": "Same as registered address",
"type": "bool",
"required": false,
"value": true,
"editable": false
},
{
"key": "op_address_street",
"label": "Street address",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "op_address_city",
"label": "City",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "op_address_state",
"label": "State / Region",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "op_address_postal",
"label": "ZIP / Postal code",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "op_address_country",
"label": "Country",
"type": "country",
"required": false,
"value": null,
"editable": false
}
]
},
{
"key": "representative",
"title": "Authorized representative",
"kind": "fields",
"fields": [
{
"key": "rep_full_name",
"label": "Full Name",
"type": "text",
"required": true,
"value": "John Doe",
"editable": false
},
{
"key": "rep_dob",
"label": "Date of Birth",
"type": "date",
"required": true,
"value": "1980-06-01",
"editable": false
},
{
"key": "rep_job_title",
"label": "Job Title",
"type": "select",
"required": false,
"value": "Chief Executive Officer (CEO)",
"editable": false
},
{
"key": "rep_email",
"label": "Email Address",
"type": "email",
"required": true,
"value": "john@acme.example",
"editable": false
},
{
"key": "rep_mobile",
"label": "Mobile Number",
"type": "text",
"required": true,
"value": "+1-302-555-0100",
"editable": false
},
{
"key": "rep_citizenship",
"label": "Citizenship / Residency",
"type": "select",
"required": true,
"value": "U.S. citizen",
"editable": false
},
{
"key": "rep_ssn",
"label": "SSN / Tax ID",
"type": "text",
"required": true,
"value": "***-**-1234",
"editable": false
},
{
"key": "rep_address_street",
"label": "Street address",
"type": "text",
"required": true,
"value": "1 Main St",
"editable": false
},
{
"key": "rep_address_city",
"label": "City",
"type": "text",
"required": true,
"value": "Dover",
"editable": false
},
{
"key": "rep_address_state",
"label": "State / Region",
"type": "text",
"required": true,
"value": "DE",
"editable": false
},
{
"key": "rep_address_postal",
"label": "ZIP / Postal code",
"type": "text",
"required": true,
"value": "19901",
"editable": false
},
{
"key": "rep_address_country",
"label": "Country",
"type": "country",
"required": true,
"value": "US",
"editable": false
}
]
},
{
"key": "people",
"title": "Beneficial owners",
"kind": "parties",
"owners": [
{
"id": "019f1384-9a3c-7d31-b921-39310a19b666",
"applicant_id": null,
"full_name": "Jane Smith",
"dob": "1985-04-12",
"email": "jane@acme.example",
"mobile": "+1-302-555-0148",
"role": "Beneficial Owner (≥25%)",
"ownership_pct": 60,
"citizenship": "U.S. citizen",
"ssn": "***-**-5678",
"address_street": "2 Oak Ave",
"address_city": "Dover",
"address_state": "DE",
"address_postal": "19901",
"address_country": "US",
"source": "",
"editable": false,
"documents": []
}
]
},
{
"key": "volume_banking",
"title": "Volume & banking",
"kind": "fields",
"fields": [
{
"key": "currency",
"label": "Purchase currency",
"type": "currency",
"required": true,
"value": "USD",
"editable": false
},
{
"key": "annual_volume",
"label": "Annual transactional value",
"type": "integer",
"required": true,
"value": 2500000,
"editable": false
},
{
"key": "highest_transaction_value",
"label": "Maximum transaction amount per order",
"type": "integer",
"required": true,
"value": 15000,
"editable": false
},
{
"key": "bank_name",
"label": "Bank Name",
"type": "text",
"required": true,
"value": "Big Bank NA",
"editable": false
},
{
"key": "account_number",
"label": "Account Number",
"type": "text",
"required": true,
"value": "****6789",
"editable": false
},
{
"key": "routing_number",
"label": "Routing Number",
"type": "text",
"required": true,
"value": "021000021",
"editable": false
}
]
},
{
"key": "documents",
"title": "Documents",
"kind": "documents",
"documents": [
{
"key": "tax",
"label": "Tax identification",
"required": true,
"editable": false,
"multiple": false,
"options": [
"IRS EIN Confirmation Letter",
"W-9 Form",
"ITIN Assignment Letter",
"Federal Tax Return"
],
"documents": [
{
"id": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"type": "IRS EIN Confirmation Letter",
"filename": "ein_letter.pdf",
"editable": false,
"created_at": "2026-07-01T08:04:30Z"
}
]
},
{
"key": "bank",
"label": "Bank account / payout",
"required": true,
"editable": false,
"multiple": false,
"options": [
"Bank Statement",
"ACH / Direct Deposit Authorization"
],
"documents": [
{
"id": "019c9c43-5a6b-7aa4-a5c0-abc123def222",
"type": "Bank Statement",
"filename": "bank_statement_2026_06.pdf",
"editable": false,
"created_at": "2026-07-02T10:20:00Z"
},
{
"id": "019c9c42-4e5f-7aa4-a5c0-abc123def111",
"type": "Bank Statement",
"filename": "bank_statement_2026_05.pdf",
"editable": false,
"created_at": "2026-07-01T08:05:00Z",
"superseded_at": "2026-07-02T10:20:00Z",
"superseded_by_document_id": "019c9c43-5a6b-7aa4-a5c0-abc123def222"
}
]
},
{
"key": "registration",
"label": "Certificate of Registration / Incorporation",
"required": true,
"editable": false,
"multiple": false,
"options": [
"Certificate of Registration / Incorporation"
],
"documents": [
{
"id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"type": "Certificate of Registration / Incorporation",
"filename": "cert_of_inc.pdf",
"editable": false,
"created_at": "2026-07-01T08:04:00Z"
}
]
},
{
"key": "operating_agreement",
"label": "Operating Agreement",
"note": "Required for LLCs and partnerships",
"required": false,
"editable": false,
"multiple": false,
"options": [
"Operating Agreement"
],
"documents": []
},
{
"key": "pci",
"label": "PCI SAQ",
"required": true,
"editable": false,
"multiple": false,
"options": [
"SAQ A",
"SAQ A-EP",
"SAQ D"
],
"documents": []
},
{
"key": "additional",
"label": "Additional documents",
"required": false,
"editable": false,
"multiple": true,
"options": [
"Other"
],
"documents": []
}
]
}
]
},
"checks": [
{
"id": "019f1a00-0000-7000-8000-000000000001",
"type": "registry",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "active",
"response": {
"message": "",
"results": [
{
"address_match": true,
"agent_is_commercial": true,
"agent_resigned": false,
"ai_confidence_level": 98.5,
"ar_standing": "Current",
"assumed_business_names": [
{
"effective_date": "2023-01-10",
"joint_venture": false,
"sos_id": "DBA-99",
"status": "Active",
"title": "ACME CAPITAL",
"type": "DBA"
}
],
"base_info": {
"associated_persons": [
{
"address": {
"city": "Dover",
"country": "US",
"postal_code": "19901",
"state_or_province": "DE",
"street": "1 Main St"
},
"current": "true",
"email": "jane@acme.example",
"name": "Jane Smith",
"phone": "+1-302-555-0100",
"role": "CEO"
}
],
"company_name": "ACME HOLDINGS INC.",
"company_type": "Corporation",
"jurisdiction": "DE",
"registered_address": {
"city": "DOVER",
"country": "US",
"postal_code": "19904",
"state_or_province": "DE",
"street": "850 NEW BURTON ROAD SUITE 201"
},
"registration_date": "3/15/2022",
"registration_number": "7654321",
"status": "Good Standing"
},
"confidence_level": 100,
"documents": [
{
"date": "3/15/2022",
"name": "Certificate of Incorporation",
"url": "https://.../doc/123"
}
],
"ein": "36-2382580",
"email": "contact@acme.example",
"entity_sub_type": "Domestic",
"full_data_count": {
"assumed_business_names_count": 1,
"documents_count": 1,
"history_count": 1,
"officers_count": 1,
"ucc_data_count": 1
},
"history": [
{
"changes": [
{
"action": "Modified",
"changed_from": "OLD AGENT LLC",
"changed_to": "CORPORATION SERVICE COMPANY",
"name": "Registered Agent"
}
],
"date": "2024-02-01",
"name": "Amendment"
}
],
"industry": "Holding companies",
"mailing_address": {
"city": "Dover",
"country": "US",
"postal_code": "19903",
"state_or_province": "DE",
"street": "PO Box 5"
},
"next_report_due_date": "2027-03-01",
"normalized_filing_date": "2022-03-15T00:00:00.000Z",
"normalized_status": "active",
"phone_number": "+1-302-555-0148",
"registered_agent": {
"address": {
"city": "WILMINGTON",
"country": "US",
"postal_code": "19808",
"state_or_province": "DE",
"street": "251 LITTLE FALLS DRIVE"
},
"name": "CORPORATION SERVICE COMPANY"
},
"sos_id": "7654321",
"state_of_formation": "DE",
"ucc_data": [
{
"debtors": [
{
"city": "Dover",
"name": "ACME HOLDINGS INC.",
"state": "DE",
"street": "1 Main St",
"zip": "19904"
}
],
"file_number": "2023-1234567",
"filing_date": "2023-06-01",
"image_url": "https://.../ucc/123",
"lapse_date": "2028-06-01",
"secured_parties": [
{
"city": "New York",
"name": "BIG BANK NA",
"state": "NY",
"street": "100 Bank St",
"zip": "10001"
}
],
"status": "Active",
"type": "Original"
}
],
"url": "https://icis.corp.delaware.gov/Ecorp/EntitySearch/..."
}
]
},
"completed_at": "2026-07-02T10:31:30Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000002",
"type": "tin",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "match",
"response": {
"message": "",
"result": {
"irs_code": 7,
"irs_reason": "TIN and Name combination matches IRS EIN records",
"irs_service_status": "available",
"last_irs_check_date": "2026-07-01",
"name": "ACME HOLDINGS INC.",
"status": "TIN Matched",
"tin": "362382580"
}
},
"completed_at": "2026-07-02T10:31:20Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000003",
"type": "document_verification",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "verified",
"response": {
"case_id": "019f179b-0fa7-72c8-818e-819652540477",
"result": {
"document_results": [
{
"document": {
"doc_path": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"document_type": "KybCertificateOfIncorporation"
},
"errors": [],
"extracted_shareholders": [
{
"country": "US",
"first_name": "John",
"last_name": "Doe",
"name": "John Doe"
}
],
"message": "",
"status": "VERIFIED"
}
],
"extracted_company_info": {
"address": "123 Main St, Dover, DE 19901",
"company_name": "Acme Holdings Inc.",
"jurisdiction": "US"
},
"message": "",
"status": "VERIFIED"
},
"verification_id": "019f179b-0fa7-72c8-818e-819652540477"
},
"completed_at": "2026-07-02T10:31:45Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000004",
"type": "doc_manipulation",
"subject_kind": "document",
"subject_ref": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"status": "completed",
"severity": "low",
"verdict": "authentic",
"response": {
"case_id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"confidence": 0.96,
"document_id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"error_code": "PROCESSING_ERROR",
"error_message": "",
"page_count": 1,
"pages": [
{
"checks_skipped": [],
"confidence": 0.96,
"document_type_detected": "corporate document",
"flags": [
{
"category": "METADATA",
"check_id": "M01",
"confidence": 0.99,
"evidence": "Creation and modification timestamps are consistent.",
"result": "PASS",
"severity": "LOW"
}
],
"language_detected": "en",
"page_number": 1,
"page_verdict": "AUTHENTIC",
"processing_notes": "",
"risk_score": 8,
"submission_method_detected": "scanned PDF",
"summary": "No signs of manipulation detected."
}
],
"risk_score": 8,
"verdict": "AUTHENTIC",
"verification_id": "019f179b-0fa7-72c8-818e-819652540477"
},
"completed_at": "2026-07-02T10:32:00Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000005",
"type": "doc_manipulation",
"subject_kind": "document",
"subject_ref": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"status": "completed",
"severity": "low",
"verdict": "authentic",
"response": {
"case_id": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"confidence": 0.98,
"document_id": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"error_code": "PROCESSING_ERROR",
"error_message": "",
"page_count": 1,
"pages": [
{
"checks_skipped": [],
"confidence": 0.98,
"document_type_detected": "corporate document",
"flags": [
{
"category": "METADATA",
"check_id": "M01",
"confidence": 0.99,
"evidence": "Creation and modification timestamps are consistent.",
"result": "PASS",
"severity": "LOW"
}
],
"language_detected": "en",
"page_number": 1,
"page_verdict": "AUTHENTIC",
"processing_notes": "",
"risk_score": 5,
"submission_method_detected": "scanned PDF",
"summary": "No signs of manipulation detected."
}
],
"risk_score": 5,
"verdict": "AUTHENTIC",
"verification_id": "019f179b-0fa7-72c8-818e-819652540477"
},
"completed_at": "2026-07-02T10:32:05Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000006",
"type": "doc_manipulation",
"subject_kind": "document",
"subject_ref": "019c9c41-3c4d-7aa4-a5c0-abc123defabc",
"status": "completed",
"severity": "low",
"verdict": "authentic",
"response": {
"case_id": "019c9c41-3c4d-7aa4-a5c0-abc123defabc",
"confidence": 0.99,
"document_id": "019c9c41-3c4d-7aa4-a5c0-abc123defabc",
"error_code": "PROCESSING_ERROR",
"error_message": "",
"page_count": 1,
"pages": [
{
"checks_skipped": [],
"confidence": 0.99,
"document_type_detected": "corporate document",
"flags": [
{
"category": "METADATA",
"check_id": "M01",
"confidence": 0.99,
"evidence": "Creation and modification timestamps are consistent.",
"result": "PASS",
"severity": "LOW"
}
],
"language_detected": "en",
"page_number": 1,
"page_verdict": "AUTHENTIC",
"processing_notes": "",
"risk_score": 3,
"submission_method_detected": "scanned PDF",
"summary": "No signs of manipulation detected."
}
],
"risk_score": 3,
"verdict": "AUTHENTIC",
"verification_id": "019f179b-0fa7-72c8-818e-819652540477"
},
"completed_at": "2026-07-02T10:32:10Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000007",
"type": "aml_company",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "no_hits",
"response": {
"data": [],
"max_risk_score": "Low",
"requested_name": "Acme Holdings Inc.",
"search_uuid": "019f1a00-0000-7000-8000-000000000007"
},
"completed_at": "2026-07-02T10:32:20Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000008",
"type": "aml_person",
"subject_kind": "owner",
"subject_ref": "019f1383-8f38-7d31-b921-39310a19b444",
"status": "completed",
"severity": "medium",
"verdict": "potential_match",
"response": {
"data": [
{
"annotation": "Politically exposed person – former government official.",
"fields": {
"addresses": [
{
"country": "United States"
}
],
"citizenships": [
"US"
],
"dates_of_birth": [
"1987-12-24"
],
"names": [
{
"full_name": "John Doe",
"lang": "en"
}
],
"political_roles": [
{
"country": "US",
"title": "Former Deputy Minister"
}
],
"sources": [
{
"last_updated": "2025-10-01",
"name": "US Consolidated Sanctions List"
}
]
},
"importance_score": 87,
"risk_score": "Medium",
"risk_score_value": 3.5,
"search_metadata": {
"country_matched": true,
"date_of_birth_matched": false,
"match_level": "MEDIUM"
},
"tags": [
"PEP",
"Finance"
],
"type": "Person",
"updated_at": "2025-10-20T15:45:00Z",
"uuid": "a123-45b6-78c9-0123"
}
],
"max_risk_score": "Medium",
"requested_name": "John Doe",
"search_uuid": "019f1a00-0000-7000-8000-000000000008"
},
"completed_at": "2026-07-02T10:32:25Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000009",
"type": "aml_person",
"subject_kind": "owner",
"subject_ref": "019f1384-9a3c-7d31-b921-39310a19b666",
"status": "completed",
"severity": "low",
"verdict": "no_hits",
"response": {
"data": [],
"max_risk_score": "No_Risk",
"requested_name": "Jane Smith",
"search_uuid": "019f1a00-0000-7000-8000-000000000009"
},
"completed_at": "2026-07-02T10:32:30Z"
},
{
"id": "019f1a00-0000-7000-8000-00000000000a",
"type": "cross_check",
"subject_kind": "case",
"status": "completed",
"severity": "medium",
"verdict": "partial_match",
"response": {
"fields": [
{
"axis": "widget_vs_registry",
"document_value": "Acme Holdings Inc.",
"field": "legal_name",
"level": "MATCH",
"registry_value": "ACME HOLDINGS INC.",
"widget_value": "Acme Holdings Inc"
},
{
"document_value": "7654321",
"field": "registration_number",
"level": "MATCH",
"registry_value": "7654321",
"widget_value": "7654321"
},
{
"axis": "widget_vs_registry",
"document_value": "123 Main St, Dover, DE 19901",
"field": "registered_address",
"level": "SOFT_MISMATCH",
"registry_value": "850 New Burton Rd Ste 201, Dover, DE",
"widget_value": "123 Main Street, Dover, DE"
}
],
"overall": "has_soft_mismatch"
},
"completed_at": "2026-07-02T10:32:40Z"
},
{
"id": "019f17b0-6c4e-72c8-818e-819652540911",
"type": "kyc",
"subject_kind": "person",
"subject_ref": "019f1383-8f38-7d31-b921-39310a19b444",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-02T10:32:45Z"
},
{
"id": "019f1a00-0000-7000-8000-00000000000b",
"type": "website_triage",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "legitimate",
"response": {
"result": {
"business_match": "WEBSITE_BUSINESS_MATCH_MATCH",
"classified": true,
"content_inspected": true,
"domain": "acme.example",
"http_status": 200,
"mcc_match": "WEBSITE_MCC_MATCH_CORROBORATED",
"observed_category": "general retail storefront",
"outcome": "WEBSITE_TRIAGE_OUTCOME_LEGITIMATE",
"page_title": "Acme Holdings — Retail",
"site_type": "WEBSITE_SITE_TYPE_LIVE",
"summary": "Retail storefront consistent with the declared business.",
"url": "https://acme.example"
},
"status": "KYB_CHECK_STATUS_OK"
},
"completed_at": "2026-07-02T10:32:50Z"
}
],
"documents": [
{
"document_id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"document_type": "Certificate of Registration / Incorporation",
"file_name": "cert_of_inc.pdf",
"check_ref": "019f1a00-0000-7000-8000-000000000004"
},
{
"document_id": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"document_type": "IRS EIN Confirmation Letter",
"file_name": "ein_letter.pdf",
"check_ref": "019f1a00-0000-7000-8000-000000000005"
},
{
"document_id": "019c9c41-3c4d-7aa4-a5c0-abc123defabc",
"document_type": "Passport",
"file_name": "owner_passport.jpg",
"owner_id": "019f1383-8f38-7d31-b921-39310a19b444",
"check_ref": "019f1a00-0000-7000-8000-000000000006"
},
{
"document_id": "019c9c43-5a6b-7aa4-a5c0-abc123def222",
"document_type": "Bank Statement",
"file_name": "bank_statement_2026_06.pdf"
}
],
"persons": [
{
"owner_id": "019f1383-8f38-7d31-b921-39310a19b444",
"applicant_id": "",
"source": "",
"full_name": "John Doe",
"role": "representative",
"citizenship": "US",
"aml_check_ref": "019f1a00-0000-7000-8000-000000000008",
"kyc_status": "passed",
"kyc_verification_status": "verified",
"kyc_check_ref": "019f17b0-6c4e-72c8-818e-819652540911"
},
{
"owner_id": "019f1384-9a3c-7d31-b921-39310a19b666",
"applicant_id": "",
"source": "",
"full_name": "Jane Smith",
"role": "beneficial_owner",
"citizenship": "US",
"ownership_pct": 60,
"aml_check_ref": "019f1a00-0000-7000-8000-000000000009"
}
],
"compliance_documents": {
"state": "needs_attention",
"total": 2,
"last_uploaded_at": "2026-07-23T18:04:05Z",
"items": [
{
"document_id": "019c9c46-8d9e-7aa4-a5c0-abc123def555",
"document_type": "Bank Statement",
"file_name": "wells_fargo_august.pdf",
"uploaded_by": "a0f2c1d4e5b6a7c8",
"uploaded_at": "2026-07-23T18:04:05Z",
"received_from": "Email from the CFO",
"comment": "Sent after the call on 12 September",
"authenticity": {
"status": "completed",
"verdict": "suspicious",
"risk_score": 71,
"confidence": 0.93,
"completed_at": "2026-07-23T18:06:40Z"
}
},
{
"document_id": "019c9c47-9eaf-7aa4-a5c0-abc123def666",
"document_type": "Other",
"file_name": "lease_agreement_signed.pdf",
"uploaded_by": "a0f2c1d4e5b6a7c8",
"uploaded_at": "2026-07-10T09:12:00Z",
"received_from": "Handed over at the on-site visit",
"authenticity": {
"status": "completed",
"verdict": "authentic",
"risk_score": 6,
"confidence": 0.97,
"completed_at": "2026-07-10T09:14:20Z"
}
}
]
},
"remediation_items": [
{
"id": "019f1b00-0000-7000-8000-000000000002",
"request_id": "019f1b00-0000-7000-8000-000000000001",
"target_kind": "field",
"section_key": "registration",
"field_key": "registration_number",
"audience": "merchant",
"message": "The number does not match the registry, please re-enter it.",
"comment": "The registry still lists our old name; the rename filing is with them since May.",
"comment_at": "2026-07-02T10:20:00Z",
"status": "resolved",
"created_by": "a0f2c1d4e5b6a7c8",
"created_at": "2026-07-02T09:00:00Z",
"resolved_at": "2026-07-02T10:30:00Z",
"answered_at": "2026-07-02T10:20:00Z",
"last_value": "36-2382XXX",
"new_value": "36-2382580"
},
{
"id": "019f1b00-0000-7000-8000-000000000003",
"request_id": "019f1b00-0000-7000-8000-000000000001",
"target_kind": "document",
"section_key": "documents",
"field_key": "bank",
"audience": "merchant",
"message": "The statement is older than 90 days, please upload the latest one.",
"status": "resolved",
"created_by": "a0f2c1d4e5b6a7c8",
"created_at": "2026-07-02T09:00:00Z",
"resolved_at": "2026-07-02T10:30:00Z",
"answered_at": "2026-07-02T10:20:00Z",
"last_value": [
{
"id": "019c9c42-4e5f-7aa4-a5c0-abc123def111",
"name": "bank_statement_2026_05.pdf"
}
],
"new_value": [
{
"id": "019c9c43-5a6b-7aa4-a5c0-abc123def222",
"name": "bank_statement_2026_06.pdf"
}
]
},
{
"id": "019f1b00-0000-7000-8000-000000000004",
"request_id": "019f1b00-0000-7000-8000-000000000001",
"target_kind": "field",
"section_key": "registration",
"field_key": "website",
"audience": "merchant",
"message": "The website does not resolve, please check the address.",
"status": "canceled",
"created_by": "a0f2c1d4e5b6a7c8",
"created_at": "2026-07-02T09:00:00Z",
"canceled_at": "2026-07-02T10:30:00Z",
"answered_at": "2026-07-02T10:20:00Z",
"last_value": "https://acme.co",
"new_value": null
},
{
"id": "019f1b00-0000-7000-8000-000000000005",
"request_id": "019f1b00-0000-7000-8000-000000000001",
"target_kind": "custom",
"section_key": "",
"field_key": "",
"label": "Proof of address",
"instruction": "A utility bill showing the company name and the registered address.",
"expectation": "Issued within the last 3 months.",
"resp_type": "text+file",
"required": true,
"answer_text": "Suite 400, 1 Market Street, San Francisco, CA 94105.",
"answer_files": [
{
"id": "019c9c44-6b7c-7aa4-a5c0-abc123def333",
"name": "utility_bill_2026_06.pdf"
}
],
"reference_files": [
{
"id": "019c9c45-7c8d-7aa4-a5c0-abc123def444",
"name": "utility_bill_example.pdf"
}
],
"audience": "merchant",
"message": "The address on the application is not the one the registry holds.",
"status": "resolved",
"created_by": "a0f2c1d4e5b6a7c8",
"created_at": "2026-07-02T09:00:00Z",
"resolved_at": "2026-07-02T10:30:00Z",
"answered_at": "2026-07-02T10:20:00Z",
"last_value": null,
"new_value": null
}
],
"field_changes": [
{
"section_key": "registration",
"field_key": "registration_number",
"was": "36-2382XXX",
"now": "36-2382580",
"changed_by": "remediation",
"at": "2026-07-02T10:30:00Z"
},
{
"section_key": "registration",
"field_key": "website",
"was": "https://acme.co",
"now": "https://acme.example",
"changed_by": "applicant",
"at": "2026-07-02T10:30:00Z"
}
]
}{
"code": "case_not_found",
"message": "Case not found"
}KYB Verifications
Get a KYB verification (full detail)
Server-to-server (API key) twin of the dashboard KYB verification detail: same response, the only difference is tenancy — the organization comes from the API key, not a path param.
Full drill-in for one KYB verification. Bundles everything the case page renders: application — all widget-collected data & documents from every step; checks — the 3 KYB checks (US registry, TIN, document verification); document_checks — the ML doc-manipulation verdict for EACH uploaded file; company_aml + owner_aml — AML screening for the company and every owner/representative; cross_check — declared vs registry vs document field deltas; risk — final score/decision (null until the KYB risk scoring service exists).
GET
/
api
/
v4
/
kyb
/
verifications
/
{caseId}
Get a KYB verification (full detail)
curl --request GET \
--url https://api.example.com/api/v4/kyb/verifications/{caseId} \
--header 'ds-api-token: <api-key>'import requests
url = "https://api.example.com/api/v4/kyb/verifications/{caseId}"
headers = {"ds-api-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'ds-api-token': '<api-key>'}};
fetch('https://api.example.com/api/v4/kyb/verifications/{caseId}', 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.example.com/api/v4/kyb/verifications/{caseId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"ds-api-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"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v4/kyb/verifications/{caseId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("ds-api-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v4/kyb/verifications/{caseId}")
.header("ds-api-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v4/kyb/verifications/{caseId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["ds-api-token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "019f179b-0fa7-72c8-818e-819652540477",
"public_id": "KYBC8274B9CF4907859",
"organization_id": "o6e501dc4d3c6d9a4",
"applicant_id": "019f1383-8f38-7d31-b921-39310a19b444",
"external_id": "merchant-123",
"company_name": "Acme Holdings Inc.",
"country": "US",
"status": "rejected",
"stage": "manual_review",
"risk_level": "High",
"is_sandbox": false,
"created_at": "2026-07-01T08:10:00Z",
"submitted_at": "2026-07-01T08:15:00Z",
"company": {
"legal_name": "Acme Holdings Inc.",
"form_type": "US - Limited Liability Company (LLC)",
"entity_type": "Limited Liability Company (LLC)",
"registration_type": "EIN",
"registration_number": "16-1782204",
"country": "US",
"state": "NY",
"representative_name": "Joe Marrano",
"representative_email": "joe@acme.com"
},
"form_progress": {
"sections_completed": 8,
"sections_total": 8,
"sections": [
{
"key": "business",
"title": "Business details",
"state": "completed"
},
{
"key": "registration",
"title": "Business registration",
"state": "completed"
},
{
"key": "address_contact",
"title": "Business address",
"state": "completed"
},
{
"key": "representative",
"title": "Representative",
"state": "completed"
},
{
"key": "kyc",
"title": "KYC",
"state": "completed"
},
{
"key": "people",
"title": "Beneficial owners",
"state": "completed"
},
{
"key": "volume_banking",
"title": "Volumes & banking",
"state": "completed"
},
{
"key": "documents",
"title": "Documents",
"state": "completed"
}
]
},
"checks_summary": {
"expected": 9,
"completed": 7,
"passed": 5,
"review": 2,
"failed": 0,
"errored": 0,
"checks": [
{
"type": "registry",
"status": "completed",
"severity": "low",
"verdict": "active",
"completed_at": "2026-07-01T08:16:05Z"
},
{
"type": "tin",
"status": "completed",
"severity": "medium",
"verdict": "not_issued",
"completed_at": "2026-07-01T08:16:07Z"
},
{
"type": "document_verification",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-01T08:16:31Z"
},
{
"type": "aml_company",
"status": "completed",
"severity": "medium",
"verdict": "potential_match",
"completed_at": "2026-07-01T08:16:12Z"
},
{
"type": "aml_person",
"status": "completed",
"severity": "low",
"verdict": "no_hits",
"completed_at": "2026-07-01T08:16:14Z",
"instances": {
"expected": 3,
"completed": 3
}
},
{
"type": "doc_manipulation",
"status": "in_progress",
"severity": "low",
"verdict": "authentic",
"completed_at": "2026-07-01T08:16:40Z",
"instances": {
"expected": 8,
"completed": 3
}
},
{
"type": "cross_check",
"status": "pending"
},
{
"type": "kyc",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-01T08:16:45Z"
},
{
"type": "website_triage",
"status": "completed",
"severity": "low",
"verdict": "legitimate",
"completed_at": "2026-07-01T08:16:50Z"
}
]
},
"checks_summary_remediation": {
"expected": 9,
"completed": 8,
"passed": 6,
"review": 2,
"failed": 0,
"errored": 0,
"checks": [
{
"type": "registry",
"status": "completed",
"severity": "low",
"verdict": "active",
"completed_at": "2026-07-02T10:31:30Z"
},
{
"type": "tin",
"status": "completed",
"severity": "low",
"verdict": "match",
"completed_at": "2026-07-02T10:31:20Z"
},
{
"type": "document_verification",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-02T10:31:45Z"
},
{
"type": "aml_company",
"status": "completed",
"severity": "low",
"verdict": "no_hits",
"completed_at": "2026-07-02T10:32:20Z"
},
{
"type": "aml_person",
"status": "completed",
"severity": "medium",
"verdict": "potential_match",
"completed_at": "2026-07-02T10:32:25Z",
"instances": {
"expected": 3,
"completed": 3
}
},
{
"type": "doc_manipulation",
"status": "in_progress",
"severity": "low",
"verdict": "authentic",
"completed_at": "2026-07-02T10:32:10Z",
"instances": {
"expected": 4,
"completed": 3
}
},
{
"type": "cross_check",
"status": "completed",
"severity": "medium",
"verdict": "partial_match",
"completed_at": "2026-07-02T10:32:40Z"
},
{
"type": "kyc",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-02T10:32:45Z"
},
{
"type": "website_triage",
"status": "completed",
"severity": "low",
"verdict": "legitimate",
"completed_at": "2026-07-02T10:32:50Z"
}
]
},
"application": {
"id": "019f179b-0fa7-72c8-818e-819652540477",
"status": "under_review",
"sections": [
{
"key": "business",
"title": "Business details",
"kind": "fields",
"fields": [
{
"key": "legal_name",
"label": "Legal Business Name",
"type": "text",
"required": true,
"value": "Acme Holdings Inc",
"editable": false
},
{
"key": "dba",
"label": "DBA (Doing Business As)",
"type": "text",
"required": false,
"value": "Acme Capital",
"editable": false
},
{
"key": "entity_type",
"label": "Entity Type",
"type": "select",
"required": true,
"value": "Corporation",
"editable": false
},
{
"key": "form_type",
"label": "Federal Tax Classification",
"type": "select",
"required": true,
"value": "C-Corporation",
"editable": false
}
]
},
{
"key": "registration",
"title": "Business registration",
"kind": "fields",
"fields": [
{
"key": "registration_type",
"label": "Business Registration Type",
"type": "select",
"required": true,
"value": "EIN",
"editable": false
},
{
"key": "registration_type_other",
"label": "Specify registration type",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "registration_number",
"label": "Registration Number",
"type": "text",
"required": true,
"value": "36-2382580",
"editable": false,
"original_value": "36-2382XXX",
"remediation": {
"request_id": "019f1b00-0000-7000-8000-000000000001",
"remediation_item_id": "019f1b00-0000-7000-8000-000000000002",
"updated_at": "2026-07-02T10:20:00Z",
"changes_count": 1
}
},
{
"key": "industry_type",
"label": "Industry Type",
"type": "select",
"required": true,
"value": "General Retail",
"editable": false
},
{
"key": "mcc",
"label": "Merchant Category Code (MCC)",
"type": "select",
"required": true,
"value": "5999 - MISCELLANEOUS AND SPECIALTY RETAIL STORES",
"editable": false
},
{
"key": "incorporation_date",
"label": "Date of Incorporation",
"type": "date",
"required": true,
"value": "2022-03-15",
"editable": false
},
{
"key": "website",
"label": "Company Website",
"type": "text",
"required": true,
"value": "https://acme.example",
"editable": false,
"original_value": "https://acme.co"
}
]
},
{
"key": "address_contact",
"title": "Business address",
"kind": "fields",
"fields": [
{
"key": "reg_address_street",
"label": "Street address",
"type": "text",
"required": true,
"value": "123 Main Street",
"editable": false
},
{
"key": "reg_address_city",
"label": "City",
"type": "text",
"required": true,
"value": "Dover",
"editable": false
},
{
"key": "reg_address_state",
"label": "State / Region",
"type": "text",
"required": true,
"value": "DE",
"editable": false
},
{
"key": "reg_address_postal",
"label": "ZIP / Postal code",
"type": "text",
"required": true,
"value": "19901",
"editable": false
},
{
"key": "reg_address_country",
"label": "Country",
"type": "country",
"required": true,
"value": "US",
"editable": false
},
{
"key": "operating_same_as_reg",
"label": "Same as registered address",
"type": "bool",
"required": false,
"value": true,
"editable": false
},
{
"key": "op_address_street",
"label": "Street address",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "op_address_city",
"label": "City",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "op_address_state",
"label": "State / Region",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "op_address_postal",
"label": "ZIP / Postal code",
"type": "text",
"required": false,
"value": null,
"editable": false
},
{
"key": "op_address_country",
"label": "Country",
"type": "country",
"required": false,
"value": null,
"editable": false
}
]
},
{
"key": "representative",
"title": "Authorized representative",
"kind": "fields",
"fields": [
{
"key": "rep_full_name",
"label": "Full Name",
"type": "text",
"required": true,
"value": "John Doe",
"editable": false
},
{
"key": "rep_dob",
"label": "Date of Birth",
"type": "date",
"required": true,
"value": "1980-06-01",
"editable": false
},
{
"key": "rep_job_title",
"label": "Job Title",
"type": "select",
"required": false,
"value": "Chief Executive Officer (CEO)",
"editable": false
},
{
"key": "rep_email",
"label": "Email Address",
"type": "email",
"required": true,
"value": "john@acme.example",
"editable": false
},
{
"key": "rep_mobile",
"label": "Mobile Number",
"type": "text",
"required": true,
"value": "+1-302-555-0100",
"editable": false
},
{
"key": "rep_citizenship",
"label": "Citizenship / Residency",
"type": "select",
"required": true,
"value": "U.S. citizen",
"editable": false
},
{
"key": "rep_ssn",
"label": "SSN / Tax ID",
"type": "text",
"required": true,
"value": "***-**-1234",
"editable": false
},
{
"key": "rep_address_street",
"label": "Street address",
"type": "text",
"required": true,
"value": "1 Main St",
"editable": false
},
{
"key": "rep_address_city",
"label": "City",
"type": "text",
"required": true,
"value": "Dover",
"editable": false
},
{
"key": "rep_address_state",
"label": "State / Region",
"type": "text",
"required": true,
"value": "DE",
"editable": false
},
{
"key": "rep_address_postal",
"label": "ZIP / Postal code",
"type": "text",
"required": true,
"value": "19901",
"editable": false
},
{
"key": "rep_address_country",
"label": "Country",
"type": "country",
"required": true,
"value": "US",
"editable": false
}
]
},
{
"key": "people",
"title": "Beneficial owners",
"kind": "parties",
"owners": [
{
"id": "019f1384-9a3c-7d31-b921-39310a19b666",
"applicant_id": null,
"full_name": "Jane Smith",
"dob": "1985-04-12",
"email": "jane@acme.example",
"mobile": "+1-302-555-0148",
"role": "Beneficial Owner (≥25%)",
"ownership_pct": 60,
"citizenship": "U.S. citizen",
"ssn": "***-**-5678",
"address_street": "2 Oak Ave",
"address_city": "Dover",
"address_state": "DE",
"address_postal": "19901",
"address_country": "US",
"source": "",
"editable": false,
"documents": []
}
]
},
{
"key": "volume_banking",
"title": "Volume & banking",
"kind": "fields",
"fields": [
{
"key": "currency",
"label": "Purchase currency",
"type": "currency",
"required": true,
"value": "USD",
"editable": false
},
{
"key": "annual_volume",
"label": "Annual transactional value",
"type": "integer",
"required": true,
"value": 2500000,
"editable": false
},
{
"key": "highest_transaction_value",
"label": "Maximum transaction amount per order",
"type": "integer",
"required": true,
"value": 15000,
"editable": false
},
{
"key": "bank_name",
"label": "Bank Name",
"type": "text",
"required": true,
"value": "Big Bank NA",
"editable": false
},
{
"key": "account_number",
"label": "Account Number",
"type": "text",
"required": true,
"value": "****6789",
"editable": false
},
{
"key": "routing_number",
"label": "Routing Number",
"type": "text",
"required": true,
"value": "021000021",
"editable": false
}
]
},
{
"key": "documents",
"title": "Documents",
"kind": "documents",
"documents": [
{
"key": "tax",
"label": "Tax identification",
"required": true,
"editable": false,
"multiple": false,
"options": [
"IRS EIN Confirmation Letter",
"W-9 Form",
"ITIN Assignment Letter",
"Federal Tax Return"
],
"documents": [
{
"id": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"type": "IRS EIN Confirmation Letter",
"filename": "ein_letter.pdf",
"editable": false,
"created_at": "2026-07-01T08:04:30Z"
}
]
},
{
"key": "bank",
"label": "Bank account / payout",
"required": true,
"editable": false,
"multiple": false,
"options": [
"Bank Statement",
"ACH / Direct Deposit Authorization"
],
"documents": [
{
"id": "019c9c43-5a6b-7aa4-a5c0-abc123def222",
"type": "Bank Statement",
"filename": "bank_statement_2026_06.pdf",
"editable": false,
"created_at": "2026-07-02T10:20:00Z"
},
{
"id": "019c9c42-4e5f-7aa4-a5c0-abc123def111",
"type": "Bank Statement",
"filename": "bank_statement_2026_05.pdf",
"editable": false,
"created_at": "2026-07-01T08:05:00Z",
"superseded_at": "2026-07-02T10:20:00Z",
"superseded_by_document_id": "019c9c43-5a6b-7aa4-a5c0-abc123def222"
}
]
},
{
"key": "registration",
"label": "Certificate of Registration / Incorporation",
"required": true,
"editable": false,
"multiple": false,
"options": [
"Certificate of Registration / Incorporation"
],
"documents": [
{
"id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"type": "Certificate of Registration / Incorporation",
"filename": "cert_of_inc.pdf",
"editable": false,
"created_at": "2026-07-01T08:04:00Z"
}
]
},
{
"key": "operating_agreement",
"label": "Operating Agreement",
"note": "Required for LLCs and partnerships",
"required": false,
"editable": false,
"multiple": false,
"options": [
"Operating Agreement"
],
"documents": []
},
{
"key": "pci",
"label": "PCI SAQ",
"required": true,
"editable": false,
"multiple": false,
"options": [
"SAQ A",
"SAQ A-EP",
"SAQ D"
],
"documents": []
},
{
"key": "additional",
"label": "Additional documents",
"required": false,
"editable": false,
"multiple": true,
"options": [
"Other"
],
"documents": []
}
]
}
]
},
"checks": [
{
"id": "019f1a00-0000-7000-8000-000000000001",
"type": "registry",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "active",
"response": {
"message": "",
"results": [
{
"address_match": true,
"agent_is_commercial": true,
"agent_resigned": false,
"ai_confidence_level": 98.5,
"ar_standing": "Current",
"assumed_business_names": [
{
"effective_date": "2023-01-10",
"joint_venture": false,
"sos_id": "DBA-99",
"status": "Active",
"title": "ACME CAPITAL",
"type": "DBA"
}
],
"base_info": {
"associated_persons": [
{
"address": {
"city": "Dover",
"country": "US",
"postal_code": "19901",
"state_or_province": "DE",
"street": "1 Main St"
},
"current": "true",
"email": "jane@acme.example",
"name": "Jane Smith",
"phone": "+1-302-555-0100",
"role": "CEO"
}
],
"company_name": "ACME HOLDINGS INC.",
"company_type": "Corporation",
"jurisdiction": "DE",
"registered_address": {
"city": "DOVER",
"country": "US",
"postal_code": "19904",
"state_or_province": "DE",
"street": "850 NEW BURTON ROAD SUITE 201"
},
"registration_date": "3/15/2022",
"registration_number": "7654321",
"status": "Good Standing"
},
"confidence_level": 100,
"documents": [
{
"date": "3/15/2022",
"name": "Certificate of Incorporation",
"url": "https://.../doc/123"
}
],
"ein": "36-2382580",
"email": "contact@acme.example",
"entity_sub_type": "Domestic",
"full_data_count": {
"assumed_business_names_count": 1,
"documents_count": 1,
"history_count": 1,
"officers_count": 1,
"ucc_data_count": 1
},
"history": [
{
"changes": [
{
"action": "Modified",
"changed_from": "OLD AGENT LLC",
"changed_to": "CORPORATION SERVICE COMPANY",
"name": "Registered Agent"
}
],
"date": "2024-02-01",
"name": "Amendment"
}
],
"industry": "Holding companies",
"mailing_address": {
"city": "Dover",
"country": "US",
"postal_code": "19903",
"state_or_province": "DE",
"street": "PO Box 5"
},
"next_report_due_date": "2027-03-01",
"normalized_filing_date": "2022-03-15T00:00:00.000Z",
"normalized_status": "active",
"phone_number": "+1-302-555-0148",
"registered_agent": {
"address": {
"city": "WILMINGTON",
"country": "US",
"postal_code": "19808",
"state_or_province": "DE",
"street": "251 LITTLE FALLS DRIVE"
},
"name": "CORPORATION SERVICE COMPANY"
},
"sos_id": "7654321",
"state_of_formation": "DE",
"ucc_data": [
{
"debtors": [
{
"city": "Dover",
"name": "ACME HOLDINGS INC.",
"state": "DE",
"street": "1 Main St",
"zip": "19904"
}
],
"file_number": "2023-1234567",
"filing_date": "2023-06-01",
"image_url": "https://.../ucc/123",
"lapse_date": "2028-06-01",
"secured_parties": [
{
"city": "New York",
"name": "BIG BANK NA",
"state": "NY",
"street": "100 Bank St",
"zip": "10001"
}
],
"status": "Active",
"type": "Original"
}
],
"url": "https://icis.corp.delaware.gov/Ecorp/EntitySearch/..."
}
]
},
"completed_at": "2026-07-02T10:31:30Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000002",
"type": "tin",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "match",
"response": {
"message": "",
"result": {
"irs_code": 7,
"irs_reason": "TIN and Name combination matches IRS EIN records",
"irs_service_status": "available",
"last_irs_check_date": "2026-07-01",
"name": "ACME HOLDINGS INC.",
"status": "TIN Matched",
"tin": "362382580"
}
},
"completed_at": "2026-07-02T10:31:20Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000003",
"type": "document_verification",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "verified",
"response": {
"case_id": "019f179b-0fa7-72c8-818e-819652540477",
"result": {
"document_results": [
{
"document": {
"doc_path": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"document_type": "KybCertificateOfIncorporation"
},
"errors": [],
"extracted_shareholders": [
{
"country": "US",
"first_name": "John",
"last_name": "Doe",
"name": "John Doe"
}
],
"message": "",
"status": "VERIFIED"
}
],
"extracted_company_info": {
"address": "123 Main St, Dover, DE 19901",
"company_name": "Acme Holdings Inc.",
"jurisdiction": "US"
},
"message": "",
"status": "VERIFIED"
},
"verification_id": "019f179b-0fa7-72c8-818e-819652540477"
},
"completed_at": "2026-07-02T10:31:45Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000004",
"type": "doc_manipulation",
"subject_kind": "document",
"subject_ref": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"status": "completed",
"severity": "low",
"verdict": "authentic",
"response": {
"case_id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"confidence": 0.96,
"document_id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"error_code": "PROCESSING_ERROR",
"error_message": "",
"page_count": 1,
"pages": [
{
"checks_skipped": [],
"confidence": 0.96,
"document_type_detected": "corporate document",
"flags": [
{
"category": "METADATA",
"check_id": "M01",
"confidence": 0.99,
"evidence": "Creation and modification timestamps are consistent.",
"result": "PASS",
"severity": "LOW"
}
],
"language_detected": "en",
"page_number": 1,
"page_verdict": "AUTHENTIC",
"processing_notes": "",
"risk_score": 8,
"submission_method_detected": "scanned PDF",
"summary": "No signs of manipulation detected."
}
],
"risk_score": 8,
"verdict": "AUTHENTIC",
"verification_id": "019f179b-0fa7-72c8-818e-819652540477"
},
"completed_at": "2026-07-02T10:32:00Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000005",
"type": "doc_manipulation",
"subject_kind": "document",
"subject_ref": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"status": "completed",
"severity": "low",
"verdict": "authentic",
"response": {
"case_id": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"confidence": 0.98,
"document_id": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"error_code": "PROCESSING_ERROR",
"error_message": "",
"page_count": 1,
"pages": [
{
"checks_skipped": [],
"confidence": 0.98,
"document_type_detected": "corporate document",
"flags": [
{
"category": "METADATA",
"check_id": "M01",
"confidence": 0.99,
"evidence": "Creation and modification timestamps are consistent.",
"result": "PASS",
"severity": "LOW"
}
],
"language_detected": "en",
"page_number": 1,
"page_verdict": "AUTHENTIC",
"processing_notes": "",
"risk_score": 5,
"submission_method_detected": "scanned PDF",
"summary": "No signs of manipulation detected."
}
],
"risk_score": 5,
"verdict": "AUTHENTIC",
"verification_id": "019f179b-0fa7-72c8-818e-819652540477"
},
"completed_at": "2026-07-02T10:32:05Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000006",
"type": "doc_manipulation",
"subject_kind": "document",
"subject_ref": "019c9c41-3c4d-7aa4-a5c0-abc123defabc",
"status": "completed",
"severity": "low",
"verdict": "authentic",
"response": {
"case_id": "019c9c41-3c4d-7aa4-a5c0-abc123defabc",
"confidence": 0.99,
"document_id": "019c9c41-3c4d-7aa4-a5c0-abc123defabc",
"error_code": "PROCESSING_ERROR",
"error_message": "",
"page_count": 1,
"pages": [
{
"checks_skipped": [],
"confidence": 0.99,
"document_type_detected": "corporate document",
"flags": [
{
"category": "METADATA",
"check_id": "M01",
"confidence": 0.99,
"evidence": "Creation and modification timestamps are consistent.",
"result": "PASS",
"severity": "LOW"
}
],
"language_detected": "en",
"page_number": 1,
"page_verdict": "AUTHENTIC",
"processing_notes": "",
"risk_score": 3,
"submission_method_detected": "scanned PDF",
"summary": "No signs of manipulation detected."
}
],
"risk_score": 3,
"verdict": "AUTHENTIC",
"verification_id": "019f179b-0fa7-72c8-818e-819652540477"
},
"completed_at": "2026-07-02T10:32:10Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000007",
"type": "aml_company",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "no_hits",
"response": {
"data": [],
"max_risk_score": "Low",
"requested_name": "Acme Holdings Inc.",
"search_uuid": "019f1a00-0000-7000-8000-000000000007"
},
"completed_at": "2026-07-02T10:32:20Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000008",
"type": "aml_person",
"subject_kind": "owner",
"subject_ref": "019f1383-8f38-7d31-b921-39310a19b444",
"status": "completed",
"severity": "medium",
"verdict": "potential_match",
"response": {
"data": [
{
"annotation": "Politically exposed person – former government official.",
"fields": {
"addresses": [
{
"country": "United States"
}
],
"citizenships": [
"US"
],
"dates_of_birth": [
"1987-12-24"
],
"names": [
{
"full_name": "John Doe",
"lang": "en"
}
],
"political_roles": [
{
"country": "US",
"title": "Former Deputy Minister"
}
],
"sources": [
{
"last_updated": "2025-10-01",
"name": "US Consolidated Sanctions List"
}
]
},
"importance_score": 87,
"risk_score": "Medium",
"risk_score_value": 3.5,
"search_metadata": {
"country_matched": true,
"date_of_birth_matched": false,
"match_level": "MEDIUM"
},
"tags": [
"PEP",
"Finance"
],
"type": "Person",
"updated_at": "2025-10-20T15:45:00Z",
"uuid": "a123-45b6-78c9-0123"
}
],
"max_risk_score": "Medium",
"requested_name": "John Doe",
"search_uuid": "019f1a00-0000-7000-8000-000000000008"
},
"completed_at": "2026-07-02T10:32:25Z"
},
{
"id": "019f1a00-0000-7000-8000-000000000009",
"type": "aml_person",
"subject_kind": "owner",
"subject_ref": "019f1384-9a3c-7d31-b921-39310a19b666",
"status": "completed",
"severity": "low",
"verdict": "no_hits",
"response": {
"data": [],
"max_risk_score": "No_Risk",
"requested_name": "Jane Smith",
"search_uuid": "019f1a00-0000-7000-8000-000000000009"
},
"completed_at": "2026-07-02T10:32:30Z"
},
{
"id": "019f1a00-0000-7000-8000-00000000000a",
"type": "cross_check",
"subject_kind": "case",
"status": "completed",
"severity": "medium",
"verdict": "partial_match",
"response": {
"fields": [
{
"axis": "widget_vs_registry",
"document_value": "Acme Holdings Inc.",
"field": "legal_name",
"level": "MATCH",
"registry_value": "ACME HOLDINGS INC.",
"widget_value": "Acme Holdings Inc"
},
{
"document_value": "7654321",
"field": "registration_number",
"level": "MATCH",
"registry_value": "7654321",
"widget_value": "7654321"
},
{
"axis": "widget_vs_registry",
"document_value": "123 Main St, Dover, DE 19901",
"field": "registered_address",
"level": "SOFT_MISMATCH",
"registry_value": "850 New Burton Rd Ste 201, Dover, DE",
"widget_value": "123 Main Street, Dover, DE"
}
],
"overall": "has_soft_mismatch"
},
"completed_at": "2026-07-02T10:32:40Z"
},
{
"id": "019f17b0-6c4e-72c8-818e-819652540911",
"type": "kyc",
"subject_kind": "person",
"subject_ref": "019f1383-8f38-7d31-b921-39310a19b444",
"status": "completed",
"severity": "low",
"verdict": "verified",
"completed_at": "2026-07-02T10:32:45Z"
},
{
"id": "019f1a00-0000-7000-8000-00000000000b",
"type": "website_triage",
"subject_kind": "company",
"status": "completed",
"severity": "low",
"verdict": "legitimate",
"response": {
"result": {
"business_match": "WEBSITE_BUSINESS_MATCH_MATCH",
"classified": true,
"content_inspected": true,
"domain": "acme.example",
"http_status": 200,
"mcc_match": "WEBSITE_MCC_MATCH_CORROBORATED",
"observed_category": "general retail storefront",
"outcome": "WEBSITE_TRIAGE_OUTCOME_LEGITIMATE",
"page_title": "Acme Holdings — Retail",
"site_type": "WEBSITE_SITE_TYPE_LIVE",
"summary": "Retail storefront consistent with the declared business.",
"url": "https://acme.example"
},
"status": "KYB_CHECK_STATUS_OK"
},
"completed_at": "2026-07-02T10:32:50Z"
}
],
"documents": [
{
"document_id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
"document_type": "Certificate of Registration / Incorporation",
"file_name": "cert_of_inc.pdf",
"check_ref": "019f1a00-0000-7000-8000-000000000004"
},
{
"document_id": "019c9c40-1a2b-7aa4-a5c0-abc123def789",
"document_type": "IRS EIN Confirmation Letter",
"file_name": "ein_letter.pdf",
"check_ref": "019f1a00-0000-7000-8000-000000000005"
},
{
"document_id": "019c9c41-3c4d-7aa4-a5c0-abc123defabc",
"document_type": "Passport",
"file_name": "owner_passport.jpg",
"owner_id": "019f1383-8f38-7d31-b921-39310a19b444",
"check_ref": "019f1a00-0000-7000-8000-000000000006"
},
{
"document_id": "019c9c43-5a6b-7aa4-a5c0-abc123def222",
"document_type": "Bank Statement",
"file_name": "bank_statement_2026_06.pdf"
}
],
"persons": [
{
"owner_id": "019f1383-8f38-7d31-b921-39310a19b444",
"applicant_id": "",
"source": "",
"full_name": "John Doe",
"role": "representative",
"citizenship": "US",
"aml_check_ref": "019f1a00-0000-7000-8000-000000000008",
"kyc_status": "passed",
"kyc_verification_status": "verified",
"kyc_check_ref": "019f17b0-6c4e-72c8-818e-819652540911"
},
{
"owner_id": "019f1384-9a3c-7d31-b921-39310a19b666",
"applicant_id": "",
"source": "",
"full_name": "Jane Smith",
"role": "beneficial_owner",
"citizenship": "US",
"ownership_pct": 60,
"aml_check_ref": "019f1a00-0000-7000-8000-000000000009"
}
],
"compliance_documents": {
"state": "needs_attention",
"total": 2,
"last_uploaded_at": "2026-07-23T18:04:05Z",
"items": [
{
"document_id": "019c9c46-8d9e-7aa4-a5c0-abc123def555",
"document_type": "Bank Statement",
"file_name": "wells_fargo_august.pdf",
"uploaded_by": "a0f2c1d4e5b6a7c8",
"uploaded_at": "2026-07-23T18:04:05Z",
"received_from": "Email from the CFO",
"comment": "Sent after the call on 12 September",
"authenticity": {
"status": "completed",
"verdict": "suspicious",
"risk_score": 71,
"confidence": 0.93,
"completed_at": "2026-07-23T18:06:40Z"
}
},
{
"document_id": "019c9c47-9eaf-7aa4-a5c0-abc123def666",
"document_type": "Other",
"file_name": "lease_agreement_signed.pdf",
"uploaded_by": "a0f2c1d4e5b6a7c8",
"uploaded_at": "2026-07-10T09:12:00Z",
"received_from": "Handed over at the on-site visit",
"authenticity": {
"status": "completed",
"verdict": "authentic",
"risk_score": 6,
"confidence": 0.97,
"completed_at": "2026-07-10T09:14:20Z"
}
}
]
},
"remediation_items": [
{
"id": "019f1b00-0000-7000-8000-000000000002",
"request_id": "019f1b00-0000-7000-8000-000000000001",
"target_kind": "field",
"section_key": "registration",
"field_key": "registration_number",
"audience": "merchant",
"message": "The number does not match the registry, please re-enter it.",
"comment": "The registry still lists our old name; the rename filing is with them since May.",
"comment_at": "2026-07-02T10:20:00Z",
"status": "resolved",
"created_by": "a0f2c1d4e5b6a7c8",
"created_at": "2026-07-02T09:00:00Z",
"resolved_at": "2026-07-02T10:30:00Z",
"answered_at": "2026-07-02T10:20:00Z",
"last_value": "36-2382XXX",
"new_value": "36-2382580"
},
{
"id": "019f1b00-0000-7000-8000-000000000003",
"request_id": "019f1b00-0000-7000-8000-000000000001",
"target_kind": "document",
"section_key": "documents",
"field_key": "bank",
"audience": "merchant",
"message": "The statement is older than 90 days, please upload the latest one.",
"status": "resolved",
"created_by": "a0f2c1d4e5b6a7c8",
"created_at": "2026-07-02T09:00:00Z",
"resolved_at": "2026-07-02T10:30:00Z",
"answered_at": "2026-07-02T10:20:00Z",
"last_value": [
{
"id": "019c9c42-4e5f-7aa4-a5c0-abc123def111",
"name": "bank_statement_2026_05.pdf"
}
],
"new_value": [
{
"id": "019c9c43-5a6b-7aa4-a5c0-abc123def222",
"name": "bank_statement_2026_06.pdf"
}
]
},
{
"id": "019f1b00-0000-7000-8000-000000000004",
"request_id": "019f1b00-0000-7000-8000-000000000001",
"target_kind": "field",
"section_key": "registration",
"field_key": "website",
"audience": "merchant",
"message": "The website does not resolve, please check the address.",
"status": "canceled",
"created_by": "a0f2c1d4e5b6a7c8",
"created_at": "2026-07-02T09:00:00Z",
"canceled_at": "2026-07-02T10:30:00Z",
"answered_at": "2026-07-02T10:20:00Z",
"last_value": "https://acme.co",
"new_value": null
},
{
"id": "019f1b00-0000-7000-8000-000000000005",
"request_id": "019f1b00-0000-7000-8000-000000000001",
"target_kind": "custom",
"section_key": "",
"field_key": "",
"label": "Proof of address",
"instruction": "A utility bill showing the company name and the registered address.",
"expectation": "Issued within the last 3 months.",
"resp_type": "text+file",
"required": true,
"answer_text": "Suite 400, 1 Market Street, San Francisco, CA 94105.",
"answer_files": [
{
"id": "019c9c44-6b7c-7aa4-a5c0-abc123def333",
"name": "utility_bill_2026_06.pdf"
}
],
"reference_files": [
{
"id": "019c9c45-7c8d-7aa4-a5c0-abc123def444",
"name": "utility_bill_example.pdf"
}
],
"audience": "merchant",
"message": "The address on the application is not the one the registry holds.",
"status": "resolved",
"created_by": "a0f2c1d4e5b6a7c8",
"created_at": "2026-07-02T09:00:00Z",
"resolved_at": "2026-07-02T10:30:00Z",
"answered_at": "2026-07-02T10:20:00Z",
"last_value": null,
"new_value": null
}
],
"field_changes": [
{
"section_key": "registration",
"field_key": "registration_number",
"was": "36-2382XXX",
"now": "36-2382580",
"changed_by": "remediation",
"at": "2026-07-02T10:30:00Z"
},
{
"section_key": "registration",
"field_key": "website",
"was": "https://acme.co",
"now": "https://acme.example",
"changed_by": "applicant",
"at": "2026-07-02T10:30:00Z"
}
]
}{
"code": "case_not_found",
"message": "Case not found"
}Authorizations
API token passed in the request header.
Path Parameters
KYB case id (the id from the list; the docver verification_id is a field in the response).
Response
KYB verification detail.
VerificationDetail schema
Example:
"019f1383-8f38-7d31-b921-39310a19b444"
Show child attributes
Show child attributes
Example:
{
"id": "019f179b-0fa7-72c8-818e-819652540477",
"sections": [
{
"fields": [
{
"editable": true,
"key": "legal_name",
"label": "Legal Business Name",
"required": true,
"type": "text",
"validation": { "min_len": 1, "max_len": 200 },
"value": null
},
{
"editable": true,
"key": "dba",
"label": "DBA (Doing Business As)",
"required": false,
"type": "text",
"value": null
},
{
"editable": true,
"key": "entity_type",
"label": "Entity Type",
"options": [
"Sole Proprietorship",
"Limited Liability Company (LLC)",
"Corporation",
"Limited Partnership (LP)",
"Limited Liability Partnership (LLP)",
"S - Corp",
"C - Corp"
],
"required": true,
"type": "select",
"value": null
}
],
"key": "business",
"kind": "fields",
"title": "Business details"
},
{
"fields": [
{
"editable": true,
"key": "registration_type",
"label": "Business Registration Type",
"options": [
"EIN",
"CRN",
"SSN",
"ITIN",
"NPWP",
"LEI",
"Other"
],
"required": true,
"type": "select",
"value": null
},
{
"editable": true,
"key": "registration_type_other",
"label": "Specify registration type",
"required": false,
"required_if": {
"field": "registration_type",
"value": "Other"
},
"type": "text",
"value": null
},
{
"editable": true,
"key": "industry_type",
"label": "Industry Type",
"options": ["Electronics", "General Retail", "Other"],
"required": true,
"type": "select",
"value": null
},
{
"editable": true,
"key": "industry_type_other",
"label": "Specify industry",
"required": false,
"required_if": {
"field": "industry_type",
"value": "Other"
},
"type": "text",
"value": null
},
{
"editable": true,
"key": "mcc",
"label": "Merchant Category Code (MCC)",
"options": [
"5732 - ELECTRONIC SALES",
"5999 - MISCELLANEOUS AND SPECIALTY RETAIL STORES"
],
"required": true,
"type": "select",
"value": null
}
],
"key": "registration",
"kind": "fields",
"title": "Business registration"
},
{
"fields": [
{
"editable": true,
"key": "rep_full_name",
"label": "Full Name",
"required": true,
"type": "text",
"validation": { "min_len": 1, "max_len": 200 },
"value": null
},
{
"editable": true,
"key": "rep_dob",
"label": "Date of Birth",
"required": true,
"type": "date",
"value": null
},
{
"editable": true,
"key": "rep_mobile",
"label": "Mobile Number",
"required": true,
"type": "phone",
"value": null
},
{
"editable": true,
"key": "rep_citizenship",
"label": "Citizenship / Residency",
"options": [
"U.S. citizen",
"U.S. permanent resident",
"Non-U.S. citizen / resident"
],
"required": true,
"type": "select",
"value": null
},
{
"editable": true,
"key": "rep_ssn",
"label": "SSN / Tax ID",
"required": true,
"type": "text",
"value": null
}
],
"key": "representative",
"kind": "fields",
"title": "Authorized representative"
},
{
"documents": [
{
"documents": [],
"editable": true,
"key": "owner_id_doc",
"label": "Government ID",
"multiple": true,
"options": [
"Passport",
"Drivers License",
"State ID",
"Permanent Resident Card (Green Card)"
],
"required": true
}
],
"fields": [
{
"editable": true,
"key": "full_name",
"label": "Full Name",
"required": true,
"type": "text",
"validation": { "min_len": 1, "max_len": 200 },
"value": null
},
{
"editable": true,
"key": "dob",
"label": "Date of Birth",
"required": true,
"type": "date",
"value": null
},
{
"editable": true,
"key": "ssn",
"label": "SSN / Tax ID",
"required": true,
"type": "text",
"value": null
},
{
"editable": true,
"key": "ownership_pct",
"label": "% Ownership",
"required": true,
"type": "number",
"value": null
}
],
"key": "people",
"kind": "parties",
"owners": [
{
"applicant_id": "019f1383-8f38-7d31-b921-39310a19b444",
"citizenship": "U.S. citizen",
"dob": "1990-01-01",
"documents": [
{
"created_at": "2026-06-30T08:15:00Z",
"editable": true,
"filename": "john_passport.pdf",
"id": "019f18a1-0000-7000-8000-0123456789ab",
"type": "Passport"
}
],
"editable": true,
"email": "john@acme.com",
"full_name": "John Doe",
"id": "019f18a0-0000-7000-8000-0123456789ab",
"ownership_pct": 40,
"role": "Beneficial Owner (≥25%)",
"ssn": "123-45-6789"
}
],
"title": "Beneficial owners"
},
{
"documents": [
{
"documents": [],
"editable": true,
"key": "tax",
"label": "Tax identification",
"multiple": false,
"note": "Upload one of the following documents",
"options": [
"IRS EIN Confirmation Letter",
"W-9 Form",
"ITIN Assignment Letter",
"Federal Tax Return"
],
"required": true
},
{
"documents": [],
"editable": true,
"key": "bank",
"label": "Bank account / payout",
"multiple": false,
"options": [
"Bank Statement",
"ACH / Direct Deposit Authorization"
],
"required": true
},
{
"documents": [],
"editable": true,
"key": "registration",
"label": "Certificate of Registration / Incorporation",
"multiple": false,
"options": [
"Certificate of Registration / Incorporation"
],
"required": true
},
{
"documents": [],
"editable": true,
"key": "operating_agreement",
"label": "Operating Agreement",
"multiple": false,
"note": "Required for LLCs and partnerships",
"options": ["Operating Agreement"],
"required": false
},
{
"documents": [],
"editable": true,
"key": "pci",
"label": "PCI SAQ",
"multiple": false,
"options": ["SAQ A", "SAQ A-EP", "SAQ D"],
"required": true
},
{
"documents": [],
"editable": true,
"key": "additional",
"label": "Additional documents",
"multiple": true,
"options": ["Other"],
"required": false
}
],
"key": "documents",
"kind": "documents",
"title": "Documents"
}
],
"status": "draft"
}
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
"Acme Holdings Inc."
Show child attributes
Show child attributes
Example:
"US"
Example:
"manual_review"
Show child attributes
Show child attributes
Example:
"merchant-123"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
"019f179b-0fa7-72c8-818e-819652540477"
Example:
false
Example:
"o6e501dc4d3c6d9a4"
Show child attributes
Show child attributes
Example:
"KYBC8274B9CF4907859"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Available options:
Low, Medium, High Example:
"High"
Available options:
collecting_data, running_checks, manual_review, in_remediation, remediation_review, completed, approved, rejected, failed, approved_manually, rejected_manually Example:
"manual_review"
Available options:
draft, under_review, in_remediation, remediation_review, completed, approved, manual_review, rejected, failed, approved_manually, rejected_manually Example:
"under_review"
Show child attributes
Show child attributes