Sign in

v1

latestOpenAPI 3.0.02026-07-26117198177.4 KB
Counterparties

Create a counterparty

post/v2/counterparties

Request body

namestring required
type'vendor' | 'customer' | 'investor' | 'partner' | 'exchange' | 'other' required
websitestring uri
notesstring

Example request

{
  "name": "Vercel",
  "type": "vendor",
  "website": "https://vercel.com",
  "notes": "Infrastructure hosting provider",
  "addresses": [
    {
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
      "network": "ethereum",
      "label": "payment wallet"
    }
  ],
  "bank_accounts": [
    {
      "currency": "USD",
      "bank_name": "Chase",
      "account_name": "Vercel Inc",
      "iban": "DE89370400440532013000",
      "swift": "DEUTDEFF",
      "routing_number": "021000021",
      "account_number": "12345678",
      "account_type": "checking",
      "sort_code": "60-16-13"
    }
  ]
}

Response

idstring required
namestring required
typestring required
websitestring
notesstring
created_atstring required
updated_atstring required

Example response

{
  "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "name": "Vercel",
  "type": "vendor",
  "website": "https://vercel.com",
  "notes": "Infrastructure hosting provider",
  "addresses": [
    {
      "id": "08846e81-b3a8-7fd9-cc39-d4023a75dcff",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
      "network": "ethereum",
      "name": "Vercel Payment Wallet",
      "label": "payment address"
    }
  ],
  "bank_accounts": [
    {
      "id": "ba-001",
      "currency": "USD",
      "bank_name": "Silicon Valley Bank",
      "account_name": "Vercel Inc",
      "iban": "************1234",
      "swift": "CHASUS33",
      "routing_number": "*****0248",
      "account_number": "****5678",
      "account_type": "checking",
      "sort_code": "****89"
    }
  ],
  "documents": [
    {
      "id": "doc-001",
      "name": "certificate_of_incorporation.pdf",
      "type": "kyb",
      "mime_type": "application/pdf",
      "size_bytes": 245000,
      "uploaded_at": "2026-05-10T09:00:00Z"
    }
  ],
  "created_at": "2026-05-01T10:00:00Z",
  "updated_at": "2026-05-11T14:30:00Z"
}