Skip to main content
POST
/
v2
/
partners
/
{partner_id}
/
kyb
Start Verification
curl --request POST \
  --url https://api.example.com/v2/partners/{partner_id}/kyb \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business_name": "<string>",
  "address": "<string>",
  "tin": "<string>",
  "officer_names": [
    "<string>"
  ],
  "force": false
}
'
{
  "verification_id": "<string>",
  "status": "<string>",
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.api.stuut.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
partner_id
string
required

Body

application/json

Request to start a KYB verification for a partner.

​
business_name
string | null

Business name to verify. If not provided, uses partner's name or legal_name.

​
address
string | null

Full address string. If not provided, constructs from partner's billing_address.

​
tin
string | null

Tax ID number (EIN/TIN). If not provided, uses partner's tax_number.

​
officer_names
string[] | null

List of officer names to verify against business records.

​
force
boolean
default:false

Bypass cooldown and force a new verification.

Response

Successful Response

Response after starting a KYB verification.

​
verification_id
string
required
​
status
string
required
​
message
string
required