---
title: "Create a counterparty"
method: POST
path: "/v2/counterparties"
tags: ["Counterparties"]
---

# Create a counterparty

`POST /v2/counterparties`

## Request body

- CreateCounterpartyDto
  - `name` string, required
  - `type` 'vendor' | 'customer' | 'investor' | 'partner' | 'exchange' | 'other', required
  - `website` string, uri
  - `notes` string
  - `addresses` CreateCounterpartyAddressDto[]
    - `address` string, required
    - `network` string, required
    - `label` string
  - `bank_accounts` CreateCounterpartyBankAccountDto[]
    - `currency` string, required — ISO 4217 currency code
    - `bank_name` string, required
    - `account_name` string
    - `iban` string
    - `swift` string
    - `routing_number` string
    - `account_number` string
    - `account_type` 'checking' | 'savings'
    - `sort_code` string

## Response `200`

- CounterpartyDto
  - `id` string, required
  - `name` string, required
  - `type` string, required
  - `website` string
  - `notes` string
  - `addresses` CounterpartyAddressDto[], required
    - `id` string, required
    - `address` string, required
    - `network` string, required
    - `name` string, required
    - `label` string
  - `bank_accounts` CounterpartyBankAccountDto[], required
    - `id` string, required
    - `currency` string, required
    - `bank_name` string, required
    - `account_name` string
    - `iban` string
    - `swift` string
    - `routing_number` string
    - `account_number` string
    - `account_type` string
    - `sort_code` string
  - `documents` CounterpartyDocumentDto[], required
    - `id` string, required
    - `name` string, required
    - `type` 'kyc' | 'kyb' | 'contract' | 'other', required
    - `mime_type` string, required
    - `size_bytes` number, required
    - `uploaded_at` string, required
  - `created_at` string, required
  - `updated_at` string, required

---

[API](https://skmtc.net/range/apis/range-platform-api.md) · [All operations](https://skmtc.net/range/apis/range-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/range/range-platform-api/revisions/9926df2e476d/schema)