Accounts

Create a new generic account

Create an account that records an account identifier Tesser does not interpret, such as a customer id at an exchange. A generic account has no network, currency or balance.

Ownership: Exactly one of tenant_id or counterparty_id is required.

Uniqueness: An owner has at most one generic account per generic_account_number. A duplicate returns 409 with the existing account's id, including accounts Tesser created from travel-rule data.

Immutability: generic_account_number cannot be changed. Use a new generic account for a different number.

post/v1/accounts/generic

Request

Base URL
https://api.tesser.xyz
Auth
HTTP bearer
TypeScript
https://skmtc.dev/tesser/apis/tesser-api/docs/v1/accounts/generic/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

tenant_idstring uuid nullable

Tenant ID (mutually exclusive with counterparty_id). One of tenant_id or counterparty_id is required.

counterparty_idstring uuid nullable

Counterparty ID (mutually exclusive with tenant_id). One of tenant_id or counterparty_id is required.

namestring required

Human-readable name for the generic account

generic_account_numberstring required

The account identifier, as the account holder's institution issues it (e.g. a customer id at an exchange). Stored as given after trimming surrounding whitespace; case is kept. Cannot be changed after creation.

Example request

{
  "tenant_id": "550e8400-e29b-41d4-a716-446655440002",
  "counterparty_id": "660e8400-e29b-41d4-a716-446655440003",
  "name": "Acme at Coinbase",
  "generic_account_number": "ACC-778"
}

Response

Generic account created successfully

Changes

No recorded changes to this operation across all 1 revision of this API.