Get a KYB verification

curl --request GET \
  --url https://api.dataspike.io/api/v4/kyb/verifications/{verification_id} \
  --header 'ds-api-token: <api-key>'

import requests

url = "https://api.dataspike.io/api/v4/kyb/verifications/{verification_id}"

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.dataspike.io/api/v4/kyb/verifications/{verification_id}', 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.dataspike.io/api/v4/kyb/verifications/{verification_id}",
  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.dataspike.io/api/v4/kyb/verifications/{verification_id}"

	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.dataspike.io/api/v4/kyb/verifications/{verification_id}")
  .header("ds-api-token", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dataspike.io/api/v4/kyb/verifications/{verification_id}")

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",
  "verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "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": "under_review",
  "stage": "manual_review",
  "decision": null,
  "risk_level": "High",
  "is_sandbox": false,
  "created_at": "2023-11-07T05:31:56Z",
  "submitted_at": "2023-11-07T05:31:56Z",
  "company": {
    "legal_name": "Acme Holdings Inc.",
    "dba": "<string>",
    "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": 4,
    "sections_total": 7,
    "current_section": "volume_banking",
    "sections": [
      {
        "key": "volume_banking",
        "title": "Volumes & banking",
        "state": "current"
      }
    ]
  },
  "checks_summary": {
    "expected": 7,
    "completed": 6,
    "passed": 4,
    "review": 2,
    "failed": 0,
    "errored": 0,
    "checks": [
      {
        "type": "registry",
        "status": "completed",
        "severity": "low",
        "verdict": "active",
        "completed_at": "2023-11-07T05:31:56Z",
        "instances": {
          "expected": 8,
          "completed": 3
        }
      }
    ]
  },
  "application": {},
  "checks": [
    {
      "id": "019f1a00-0000-7000-8000-000000000001",
      "type": "registry",
      "subject_kind": "company",
      "subject_ref": "<string>",
      "status": "completed",
      "severity": "low",
      "verdict": "active",
      "response": "<unknown>",
      "errors": [
        {
          "code": "check_unavailable",
          "message": "Verification is temporarily unavailable, please try again later"
        }
      ],
      "completed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "documents": [
    {
      "document_id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
      "document_type": "Certificate of Registration / Incorporation",
      "file_name": "cert_of_inc.pdf",
      "owner_id": "<string>",
      "check_ref": "019f1a00-0000-7000-8000-000000000004"
    }
  ],
  "persons": [
    {
      "owner_id": "019f1383-8f38-7d31-b921-39310a19b444",
      "full_name": "John Doe",
      "role": "beneficial_owner",
      "citizenship": "US",
      "ownership_pct": 60,
      "aml_check_ref": "019f1a00-0000-7000-8000-000000000007",
      "id_check_ref": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kyc_status": "passed",
      "kyc_verification_status": "verified",
      "kyc_check_ref": "0195c1f0-1234-7000-8000-0123456789ab"
    }
  ],
  "risk": {
    "score": 42,
    "level": "medium",
    "decision": "manual_review",
    "state": "final",
    "rules_triggered": [
      "<string>"
    ],
    "calculated_at": "2023-11-07T05:31:56Z"
  }
}

KYB Verification

Get a KYB verification

Returns the full detail for one KYB verification: the widget-collected application data, the flat checks list (registry, TIN, document verification, doc-manipulation per file, AML per person, company AML, cross-check, KYC, business risk score, agentic verification), and the documents and persons grouping slices.

The risk block and the top-level decision field are reserved for the KYB risk scoring service and are null until it runs — the risk-driven outcome currently surfaces in status (approved / manual_review / rejected).

The path id is the KYB case id (the id returned by the list). The organization scope is taken from the API key.

GET

api

kyb

verifications

{verification_id}

Get a KYB verification

curl --request GET \
  --url https://api.dataspike.io/api/v4/kyb/verifications/{verification_id} \
  --header 'ds-api-token: <api-key>'

import requests

url = "https://api.dataspike.io/api/v4/kyb/verifications/{verification_id}"

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.dataspike.io/api/v4/kyb/verifications/{verification_id}', 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.dataspike.io/api/v4/kyb/verifications/{verification_id}",
  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.dataspike.io/api/v4/kyb/verifications/{verification_id}"

	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.dataspike.io/api/v4/kyb/verifications/{verification_id}")
  .header("ds-api-token", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dataspike.io/api/v4/kyb/verifications/{verification_id}")

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",
  "verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "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": "under_review",
  "stage": "manual_review",
  "decision": null,
  "risk_level": "High",
  "is_sandbox": false,
  "created_at": "2023-11-07T05:31:56Z",
  "submitted_at": "2023-11-07T05:31:56Z",
  "company": {
    "legal_name": "Acme Holdings Inc.",
    "dba": "<string>",
    "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": 4,
    "sections_total": 7,
    "current_section": "volume_banking",
    "sections": [
      {
        "key": "volume_banking",
        "title": "Volumes & banking",
        "state": "current"
      }
    ]
  },
  "checks_summary": {
    "expected": 7,
    "completed": 6,
    "passed": 4,
    "review": 2,
    "failed": 0,
    "errored": 0,
    "checks": [
      {
        "type": "registry",
        "status": "completed",
        "severity": "low",
        "verdict": "active",
        "completed_at": "2023-11-07T05:31:56Z",
        "instances": {
          "expected": 8,
          "completed": 3
        }
      }
    ]
  },
  "application": {},
  "checks": [
    {
      "id": "019f1a00-0000-7000-8000-000000000001",
      "type": "registry",
      "subject_kind": "company",
      "subject_ref": "<string>",
      "status": "completed",
      "severity": "low",
      "verdict": "active",
      "response": "<unknown>",
      "errors": [
        {
          "code": "check_unavailable",
          "message": "Verification is temporarily unavailable, please try again later"
        }
      ],
      "completed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "documents": [
    {
      "document_id": "019c9c39-0b8a-7aa4-a5c0-abc123def456",
      "document_type": "Certificate of Registration / Incorporation",
      "file_name": "cert_of_inc.pdf",
      "owner_id": "<string>",
      "check_ref": "019f1a00-0000-7000-8000-000000000004"
    }
  ],
  "persons": [
    {
      "owner_id": "019f1383-8f38-7d31-b921-39310a19b444",
      "full_name": "John Doe",
      "role": "beneficial_owner",
      "citizenship": "US",
      "ownership_pct": 60,
      "aml_check_ref": "019f1a00-0000-7000-8000-000000000007",
      "id_check_ref": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kyc_status": "passed",
      "kyc_verification_status": "verified",
      "kyc_check_ref": "0195c1f0-1234-7000-8000-0123456789ab"
    }
  ],
  "risk": {
    "score": 42,
    "level": "medium",
    "decision": "manual_review",
    "state": "final",
    "rules_triggered": [
      "<string>"
    ],
    "calculated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

ds-api-token

string

header

required

Path Parameters

verification_id

string<uuid>

required

The KYB case id (the id from the list response).

Example:

"019f179b-0fa7-72c8-818e-819652540477"

Response

KYB verification detail.

Full drill-in for one KYB verification.

string<uuid>

KYB case id (the URL key; the id from the list).

Example:

"019f179b-0fa7-72c8-818e-819652540477"

verification_id

string<uuid> | null

Verification id created by the pipeline after submit; null before then.

public_id

string

Example:

"KYBC8274B9CF4907859"

organization_id

string

Example:

"o6e501dc4d3c6d9a4"

applicant_id

string<uuid>

Example:

"019f1383-8f38-7d31-b921-39310a19b444"

external_id

string | null

Example:

"bolt-merchant-123"

company_name

string | null

Example:

"Acme Holdings Inc."

country

string | null

Example:

"US"

status

enum<string>

KYB case status.

draft → under_review as the case moves from data collection into checks.
action_required — a remediation is open (the merchant must fix and resubmit something).
Once the checks are terminal the risk score sets the outcome: approved (Low) / manual_review (Medium) / rejected (High), or failed when the score could not be obtained.
approved_manually / rejected_manually — a reviewer's manual decision.

Available options:

draft,

under_review,

action_required,

approved,

manual_review,

rejected,

failed,

approved_manually,

rejected_manually

Example:

"under_review"

stage

enum<string>

Derived lifecycle stage. While the case is in progress: collecting_data → running_checks → manual_review; action_required when a remediation is open. Once the case is decided, stage mirrors the final status.

Available options:

collecting_data,

running_checks,

manual_review,

action_required,

approved,

rejected,

failed,

approved_manually,

rejected_manually

Example:

"manual_review"

decision

string | null

Reserved for the KYB risk scoring service; currently always null. The risk-driven outcome is surfaced in status instead.

Example:

null

risk_level

string | null

KYB business risk level (Low/Medium/High); null until the risk-score check runs.

Example:

"High"

is_sandbox

boolean

Example:

false

created_at

string<date-time>

submitted_at

string<date-time> | null

company

object | null

Declared-company snapshot for the Company/Application cards, sourced from the widget field values.

Show child attributes

form_progress

object | null

Widget-session completion stepper. Section completeness uses the same rules Submit enforces.

Show child attributes

checks_summary

object | null

Aggregates the verification's checks for the expanded row. Counts are by check TYPE (a fan-out check such as AML-per-person counts as one). completed = passed + review + failed + errored. Null until the pipeline links a verification to the case.

Show child attributes

application

object

The widget-collected state — the section catalog merged with stored values, owners and documents. Same shape as the widget state (GET /api/v4/kyb/widget/{public_id}).

checks

object[]

The single flat list of every check the pipeline ran.

Show child attributes

documents

object[]

Uploaded files grouped for the Documents section; each references its doc-manipulation check via check_ref.

Show child attributes

persons

object[]

The representative and beneficial owners grouped for the People section; each references its AML check via aml_check_ref (and the representative its KYC via kyc_check_ref).

Show child attributes

risk

object | null

Final risk scoring outcome. Provided by the KYB risk scoring service; null until then.

Show child attributes

List KYB verifications

List email checks

API documentation

KYT

Get a KYB verification

Authorizations

Path Parameters

Response