Create Counterparty

POSThttps://bank.dattaremit.com/api/counterparties

Requires a bank-scoped key.

Creates a counterparty.

## Counterparty Type

Counterparty resources are an abstraction for real world individuals and businesses that are not directly on the Cybrid Platform.

## State

State	Description
storing	The Platform is storing the counterparty details in our private store
unverified	The Platform has not yet verified the counterparty's identity
verified	The Platform has verified the counterparty's identity
rejected	The Platform was not able to successfully verify the counterparty's identity

Required scope: counterparties:execute

Body Params

required

typebusiness | individualrequired

The counterparty's type.

customer_guidstring

The owning customer's identifier.

addressobjectrequired

The address of the counterparty.

streetstring

The first line of the address.

street2string

The optional second line of the address.

citystring

The city of the address.

subdivisionstring

The ISO 3166-2 subdivision code of the address. Applicable only for countries that use subnational states, provinces, lands, oblasts or regions.

postal_codestring

The postal, zip or post code of the address. Applicable only for countries that use postal, zip or post codes.

country_codestringrequired

The ISO 3166 country 2-Alpha country code of the address.

nameobject

The name of the counterparty. Required when type is business or type is individual.

fullstring

The counterparty's full name. Required when type is business.

firststring

The counterparty's first name. Required when type is individual.

middlestring

The counterparty's middle name. Optional when type is individual.

laststring

The counterparty's last name. Required when type is individual.

aliasesobject[]

The aliases of the counterparty. Optional when type is business.

date_of_birthstring<date>

The counterparty's date of birth. Optional when type is individual.

email_addressstring

The counterparty's email address.

identification_numbersobject[]

The counterparty's identification numbers.

labelsstring[]

The labels associated with the counterparty.

Responses

201

counterparty created

400

Bad Request

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Request

curl https://api.dattaremit.com/api/counterparties \
  -X POST \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "business",
  "address": {
    "country_code": "string",
    "street": "string",
    "street2": "string",
    "city": "string",
    "subdivision": "string",
    "postal_code": "string"
  },
  "customer_guid": "string",
  "name": {
    "full": "string",
    "first": "string",
    "middle": "string",
    "last": "string"
  },
  "aliases": [
    {
      "full": "string"
    }
  ],
  "date_of_birth": "1990-04-12",
  "email_address": "string",
  "identification_numbers": [
    {
      "type": "drivers_license",
      "issuing_country_code": "string",
      "identification_number": "string",
      "issuing_subdivision": "string"
    }
  ],
  "labels": [
    "string"
  ]
}'

Response

counterparty created

{
  "guid": "string",
  "type": "string",
  "bank_guid": "string",
  "customer_guid": "string",
  "created_at": "2026-07-20T16:27:51.438Z",
  "updated_at": "2026-07-20T16:27:51.438Z",
  "state": "string",
  "name": {
    "first": "string",
    "middle": "string",
    "last": "string",
    "full": "string"
  },
  "address": {
    "street": "string",
    "street2": "string",
    "city": "string",
    "subdivision": "string",
    "postal_code": "string",
    "country_code": "string"
  },
  "aliases": [
    {
      "first": "string",
      "middle": "string",
      "last": "string",
      "full": "string"
    }
  ],
  "date_of_birth": "1990-04-12",
  "labels": [
    "string"
  ],
  "compliance_decisions": [
    {
      "type": "string",
      "state": "string",
      "failure_codes": [
        "string"
      ],
      "expired_at": "2026-07-20T16:27:51.438Z"
    }
  ]
}