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": "bolt-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": "annual_volume",
"label": "Annual transactional value",
"type": "select",
"required": true,
"value": "$1,000,000 - $5,000,000",
"editable": false
},
{
"key": "avg_transaction_volume",
"label": "Average transaction volume",
"type": "select",
"required": true,
"value": "$2,000 - $10,000",
"editable": false
},
{
"key": "highest_transaction_value",
"label": "Highest transaction value",
"type": "select",
"required": true,
"value": "$25,000 - $100,000",
"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"
}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).
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": "bolt-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": "annual_volume",
"label": "Annual transactional value",
"type": "select",
"required": true,
"value": "$1,000,000 - $5,000,000",
"editable": false
},
{
"key": "avg_transaction_volume",
"label": "Average transaction volume",
"type": "select",
"required": true,
"value": "$2,000 - $10,000",
"editable": false
},
{
"key": "highest_transaction_value",
"label": "Highest transaction value",
"type": "select",
"required": true,
"value": "$25,000 - $100,000",
"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
"019f1383-8f38-7d31-b921-39310a19b444"
Show child attributes
Show child attributes
{
"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
"Acme Holdings Inc."
Show child attributes
Show child attributes
"US"
"manual_review"
Show child attributes
Show child attributes
"bolt-merchant-123"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
"019f179b-0fa7-72c8-818e-819652540477"
false
"o6e501dc4d3c6d9a4"
Show child attributes
Show child attributes
"KYBC8274B9CF4907859"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Low, Medium, High "High"
collecting_data, running_checks, manual_review, in_remediation, remediation_review, completed, approved, rejected, failed, approved_manually, rejected_manually "manual_review"
draft, under_review, in_remediation, remediation_review, completed, approved, manual_review, rejected, failed, approved_manually, rejected_manually "under_review"
Show child attributes
Show child attributes