Tesser API

Accounts (v1)

Endpointhttps://sandbox.tesserx.co

Download schema

List all accounts

GET

https://sandbox.tesserx.co

/v1/accounts

Retrieve all accounts for your workspace with optional filtering and pagination.

List all accounts › query Parameters

type

string · enum

Filter by account type

Enum values:

fiat_bank

stablecoin_ethereum

stablecoin_solana

stablecoin_stellar

ledger

types

string[]

Filter by multiple account types (overrides type when present)

Enum values:

fiat_bank

stablecoin_ethereum

stablecoin_solana

stablecoin_stellar

ledger

tenant_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Filter by tenant ID

counterparty_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Filter by counterparty ID

entity_type

string · enum

Filter by entity type (e.g. sub_org for workspace-level)

Enum values:

sub_org

counterparty

tenant

entityType

string · enum

Filter by entity type (alias for entity_type)

Enum values:

sub_org

counterparty

tenant

search

string

Search by account name

is_managed

string · enum

Filter by managed status: 'true' for managed wallets only, 'false' for unmanaged wallets only, omit for all accounts

Enum values:

true

false

include_secure

boolean

Include masked sensitive fields (e.g., bank account number)

page

integer · min: 1

Page number for pagination (1-based)

limit

integer · min: 1 · max: 100

Number of items per page (max 100)

compliance_accepted

boolean

Filter ledger accounts by compliance status: 'true' returns only ledgers with ACCEPTED compliance state

List all accounts › Responses

Accounts retrieved successfully

object[] · required

object · required

GET/v1/accounts

curl --request GET \
  --url https://sandbox.tesserx.co/v1/accounts

shell

Example Responses

{
  "data": [
    {
      "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
      "workspace_id": "b53f6690-3242-4942-9907-885779632832",
      "tenant_id": null,
      "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
      "type": "fiat_bank",
      "name": "Operating Account - EU",
      "bank_name": "Chase Bank",
      "bank_code_type": "SWIFT",
      "bank_identifier_code": "CHASUS33",
      "created_at": "2024-03-02T14:30:00.000Z",
      "updated_at": "2024-03-02T14:30:00.000Z",
      "bank_account_number": "•••6789"
    },
    {
      "id": "7a3d8f2e-6b4c-4a91-b8e5-2f9c1d7e3a0b",
      "workspace_id": "b53f6690-3242-4942-9907-885779632832",
      "tenant_id": null,
      "counterparty_id": null,
      "type": "stablecoin_ethereum",
      "name": "Treasury Wallet - Ethereum",
      "crypto_wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE0B",
      "is_managed": true,
      "assets": [
        {
          "currency": "USDC",
          "network": "POLYGON",
          "available_balance": "0"
        },
        {
          "currency": "USDT",
          "network": "POLYGON",
          "available_balance": "0"
        }
      ],
      "created_at": "2024-03-01T10:00:00.000Z",
      "updated_at": "2024-03-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

json

application/json

Create a new bank account

POST

https://sandbox.tesserx.co

/v1/accounts/banks

Create a new fiat bank account for your workspace, tenant, or counterparty.

Security: The bank_account_number field is encrypted and stored securely in a vault. It will never be returned in API responses.

Ownership: Use tenant_id OR counterparty_id to link the account. Omit both for a workspace-level account.

Create a new bank account › Request Body

name

string · minLength: 1 · maxLength: 255 · required

Human-readable name for the bank account

bank_name

string · minLength: 1 · maxLength: 255 · required

Name of the financial institution

bank_code_type

string · minLength: 1 · maxLength: 50 · required

Type of bank code (e.g., SWIFT, BIC, IBAN, ROUTING, SORT_CODE)

bank_identifier_code

string · minLength: 1 · maxLength: 255 · required

Bank identifier code value

bank_account_number

string · minLength: 1 · maxLength: 255 · required

Bank account number. SECURE FIELD: Encrypted and stored in vault, never returned in responses. Required in API request.

tenant_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Tenant ID (mutually exclusive with counterparty_id). Links this account to a specific tenant.

counterparty_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Counterparty ID (mutually exclusive with tenant_id). Links this account to a specific counterparty.

Create a new bank account › Responses

Bank account created successfully

object · required

POST/v1/accounts/banks

curl --request POST \
  --url https://sandbox.tesserx.co/v1/accounts/banks \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Workspace Operating Account",
  "bank_name": "JPMorgan Chase Bank",
  "bank_code_type": "SWIFT",
  "bank_identifier_code": "CHASUS33",
  "bank_account_number": "1234567890"
}
'

shell

Example Request Body

{
  "name": "Workspace Operating Account",
  "bank_name": "JPMorgan Chase Bank",
  "bank_code_type": "SWIFT",
  "bank_identifier_code": "CHASUS33",
  "bank_account_number": "1234567890"
}

json

application/json

Example Responses

{
  "data": {
    "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
    "type": "fiat_bank",
    "name": "Operating Account - EU",
    "bank_name": "Chase Bank",
    "bank_code_type": "SWIFT",
    "bank_identifier_code": "CHASUS33",
    "created_at": "2024-03-02T14:30:00.000Z",
    "updated_at": "2024-03-02T14:30:00.000Z"
  }
}

json

application/json

Create a new ledger account

POST

https://sandbox.tesserx.co

/v1/accounts/ledgers

Create a ledger account linked to an external liquidity provider.

Supported Providers:

CIRCLE_MINT: Circle Mint USDC accounts for institutional settlement
KRAKEN: Kraken exchange accounts for cryptocurrency liquidity

Ledger accounts are virtual accounts managed by the provider. They enable fast settlement without on-chain transactions.

Ownership: Use tenant_id OR counterparty_id to link the account. Omit both for a workspace-level ledger account.

Create a new ledger account › Request Body

name

string · minLength: 1 · maxLength: 255 · required

Human-readable name for the ledger account

provider

string · enum · required

Liquidity provider that manages this ledger account. CIRCLE_MINT for Circle Mint accounts, KRAKEN for Kraken exchange accounts.

Enum values:

CIRCLE_MINT

KRAKEN

tenant_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Tenant ID (mutually exclusive with counterparty_id). Links this ledger account to a specific tenant.

counterparty_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Counterparty ID (mutually exclusive with tenant_id). Links this ledger account to a specific counterparty.

Create a new ledger account › Responses

Ledger account created successfully

object · required

POST/v1/accounts/ledgers

curl --request POST \
  --url https://sandbox.tesserx.co/v1/accounts/ledgers \
  --header 'Content-Type: application/json' \
  --data '
{
  "tenant_id": "7a1f5c9e-3b2d-4e68-b0a4-6e9c1f3d8a2b",
  "name": "Circle Settlement Account",
  "provider": "CIRCLE_MINT"
}
'

shell

Example Request Body

{
  "tenant_id": "7a1f5c9e-3b2d-4e68-b0a4-6e9c1f3d8a2b",
  "name": "Circle Settlement Account",
  "provider": "CIRCLE_MINT"
}

json

application/json

Example Responses

{
  "data": {
    "id": "770e8400-e29b-41d4-a716-446655440006",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": null,
    "type": "ledger",
    "name": "Circle Settlement Account",
    "provider": "CIRCLE_MINT",
    "created_at": "2024-03-01T10:00:00.000Z",
    "updated_at": "2024-03-01T10:00:00.000Z"
  }
}

json

application/json

Create a new wallet account

POST

https://sandbox.tesserx.co

/v1/accounts/wallets

Create a new stablecoin wallet account.

Supported Networks:

stablecoin_ethereum - Ethereum/Polygon stablecoin wallet
stablecoin_solana - Solana stablecoin wallet
stablecoin_stellar - Stellar stablecoin wallet

Wallet Types:

Managed (is_managed=true) - Tesser-managed wallet, requires signature
Unmanaged (is_managed=false, default) - External wallet, requires wallet_address

Ownership: Optionally link to a tenant or counterparty using tenant_id or counterparty_id.

Create a new wallet account › Request Body

name

string · minLength: 1 · maxLength: 255 · required

Human-readable name for the wallet account

type

string · enum · required

Stablecoin network type. Determines which blockchain network the wallet operates on.

Enum values:

stablecoin_ethereum

stablecoin_solana

stablecoin_stellar

tenant_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Tenant ID (mutually exclusive with counterparty_id). Links this wallet to a specific tenant.

counterparty_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Counterparty ID (mutually exclusive with tenant_id). Links this wallet to a specific counterparty.

signature

string

A cryptographic stamp used to verify the integrity and authenticity of the request. This ensures the request was signed by an authorized key. Required for managed wallets (is_managed=true). See Documentation > Signing for more details.

is_managed

boolean

Whether this is a managed wallet (provisioned by Tesser), or unmanaged (not provisioned by Tesser). Managed wallets (true) require a signature and automatically create USDC/USDT assets. Unmanaged wallets (false) require a wallet_address. Defaults to false.

Default: false

wallet_address

string

Blockchain wallet address. Required for unmanaged wallets (is_managed=false). Auto-generated for managed wallets.

Create a new wallet account › Responses

Wallet account created successfully

object · required

POST/v1/accounts/wallets

curl --request POST \
  --url https://sandbox.tesserx.co/v1/accounts/wallets \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Treasury Wallet (Omnibus)",
  "type": "stablecoin_ethereum",
  "is_managed": true,
  "signature": "eyJwdWJsaWNLZXkiOiJwdWJfZXhhbXBsZSIsInNpZ25hdHVyZSI6InNpZ19leGFtcGxlIiwic2NoZW1lIjoiRUQyNTUxOSJ9"
}
'

shell

Example Request Body

{
  "name": "Treasury Wallet (Omnibus)",
  "type": "stablecoin_ethereum",
  "is_managed": true,
  "signature": "eyJwdWJsaWNLZXkiOiJwdWJfZXhhbXBsZSIsInNpZ25hdHVyZSI6InNpZ19leGFtcGxlIiwic2NoZW1lIjoiRUQyNTUxOSJ9"
}

json

application/json

Example Responses

{
  "data": {
    "id": "7a3d8f2e-6b4c-4a91-b8e5-2f9c1d7e3a0b",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": null,
    "type": "stablecoin_ethereum",
    "name": "Treasury Wallet - Ethereum",
    "crypto_wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE0B",
    "is_managed": true,
    "assets": [
      {
        "currency": "USDC",
        "network": "POLYGON",
        "available_balance": "0"
      },
      {
        "currency": "USDT",
        "network": "POLYGON",
        "available_balance": "0"
      }
    ],
    "created_at": "2024-03-01T10:00:00.000Z",
    "updated_at": "2024-03-01T10:00:00.000Z"
  }
}

json

application/json

Get an account by ID

GET

https://sandbox.tesserx.co

/v1/accounts/{id}

Retrieve a specific account by its unique identifier.

Get an account by ID › path Parameters

id

string · required

Account ID (UUID)

Get an account by ID › query Parameters

include_secure

boolean

Include masked secure fields (e.g., bank account number)

Get an account by ID › Responses

Account retrieved successfully

object · required

GET/v1/accounts/{id}

curl --request GET \
  --url https://sandbox.tesserx.co/v1/accounts/:id

shell

Example Responses

{
  "data": {
    "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
    "type": "fiat_bank",
    "name": "Operating Account - EU",
    "bank_name": "Chase Bank",
    "bank_code_type": "SWIFT",
    "bank_identifier_code": "CHASUS33",
    "created_at": "2024-03-02T14:30:00.000Z",
    "updated_at": "2024-03-02T14:30:00.000Z",
    "bank_account_number": "•••6789"
  }
}

json

application/json

Update an account

PATCH

https://sandbox.tesserx.co

/v1/accounts/{id}

Update an existing account's information.

Update an account › path Parameters

id

string · required

Account ID (UUID)

Update an account › Request Body

name

string · minLength: 1

New account name

Update an account › Responses

Account updated successfully

object · required

PATCH/v1/accounts/{id}

curl --request PATCH \
  --url https://sandbox.tesserx.co/v1/accounts/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Updated Operating Account"
}
'

shell

Example Request Body

{
  "name": "Updated Operating Account"
}

json

application/json

Example Responses

{
  "data": {
    "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
    "type": "fiat_bank",
    "name": "Updated Operating Account",
    "bank_name": "Chase Bank",
    "bank_code_type": "SWIFT",
    "bank_identifier_code": "CHASUS33",
    "created_at": "2024-03-02T14:30:00.000Z",
    "updated_at": "2024-03-01T12:00:00.000Z"
  }
}

json

application/json

Currencies

Tesser API

Accounts (v1)

Endpointhttps://sandbox.tesserx.co

Download schema

List all accounts

GET

https://sandbox.tesserx.co

/v1/accounts

Retrieve all accounts for your workspace with optional filtering and pagination.

List all accounts › query Parameters

type

string · enum

Filter by account type

Enum values:

fiat_bank

stablecoin_ethereum

stablecoin_solana

stablecoin_stellar

ledger

types

string[]

Filter by multiple account types (overrides type when present)

Enum values:

fiat_bank

stablecoin_ethereum

stablecoin_solana

stablecoin_stellar

ledger

tenant_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Filter by tenant ID

counterparty_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Filter by counterparty ID

entity_type

string · enum

Filter by entity type (e.g. sub_org for workspace-level)

Enum values:

sub_org

counterparty

tenant

entityType

string · enum

Filter by entity type (alias for entity_type)

Enum values:

sub_org

counterparty

tenant

search

string

Search by account name

is_managed

string · enum

Filter by managed status: 'true' for managed wallets only, 'false' for unmanaged wallets only, omit for all accounts

Enum values:

true

false

include_secure

boolean

Include masked sensitive fields (e.g., bank account number)

page

integer · min: 1

Page number for pagination (1-based)

limit

integer · min: 1 · max: 100

Number of items per page (max 100)

compliance_accepted

boolean

Filter ledger accounts by compliance status: 'true' returns only ledgers with ACCEPTED compliance state

List all accounts › Responses

Accounts retrieved successfully

object[] · required

object · required

GET/v1/accounts

curl --request GET \
  --url https://sandbox.tesserx.co/v1/accounts

shell

Example Responses

{
  "data": [
    {
      "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
      "workspace_id": "b53f6690-3242-4942-9907-885779632832",
      "tenant_id": null,
      "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
      "type": "fiat_bank",
      "name": "Operating Account - EU",
      "bank_name": "Chase Bank",
      "bank_code_type": "SWIFT",
      "bank_identifier_code": "CHASUS33",
      "created_at": "2024-03-02T14:30:00.000Z",
      "updated_at": "2024-03-02T14:30:00.000Z",
      "bank_account_number": "•••6789"
    },
    {
      "id": "7a3d8f2e-6b4c-4a91-b8e5-2f9c1d7e3a0b",
      "workspace_id": "b53f6690-3242-4942-9907-885779632832",
      "tenant_id": null,
      "counterparty_id": null,
      "type": "stablecoin_ethereum",
      "name": "Treasury Wallet - Ethereum",
      "crypto_wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE0B",
      "is_managed": true,
      "assets": [
        {
          "currency": "USDC",
          "network": "POLYGON",
          "available_balance": "0"
        },
        {
          "currency": "USDT",
          "network": "POLYGON",
          "available_balance": "0"
        }
      ],
      "created_at": "2024-03-01T10:00:00.000Z",
      "updated_at": "2024-03-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

json

application/json

Create a new bank account

POST

https://sandbox.tesserx.co

/v1/accounts/banks

Create a new fiat bank account for your workspace, tenant, or counterparty.

Security: The bank_account_number field is encrypted and stored securely in a vault. It will never be returned in API responses.

Ownership: Use tenant_id OR counterparty_id to link the account. Omit both for a workspace-level account.

Create a new bank account › Request Body

name

string · minLength: 1 · maxLength: 255 · required

Human-readable name for the bank account

bank_name

string · minLength: 1 · maxLength: 255 · required

Name of the financial institution

bank_code_type

string · minLength: 1 · maxLength: 50 · required

Type of bank code (e.g., SWIFT, BIC, IBAN, ROUTING, SORT_CODE)

bank_identifier_code

string · minLength: 1 · maxLength: 255 · required

Bank identifier code value

bank_account_number

string · minLength: 1 · maxLength: 255 · required

Bank account number. SECURE FIELD: Encrypted and stored in vault, never returned in responses. Required in API request.

tenant_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Tenant ID (mutually exclusive with counterparty_id). Links this account to a specific tenant.

counterparty_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Counterparty ID (mutually exclusive with tenant_id). Links this account to a specific counterparty.

Create a new bank account › Responses

Bank account created successfully

object · required

POST/v1/accounts/banks

curl --request POST \
  --url https://sandbox.tesserx.co/v1/accounts/banks \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Workspace Operating Account",
  "bank_name": "JPMorgan Chase Bank",
  "bank_code_type": "SWIFT",
  "bank_identifier_code": "CHASUS33",
  "bank_account_number": "1234567890"
}
'

shell

Example Request Body

{
  "name": "Workspace Operating Account",
  "bank_name": "JPMorgan Chase Bank",
  "bank_code_type": "SWIFT",
  "bank_identifier_code": "CHASUS33",
  "bank_account_number": "1234567890"
}

json

application/json

Example Responses

{
  "data": {
    "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
    "type": "fiat_bank",
    "name": "Operating Account - EU",
    "bank_name": "Chase Bank",
    "bank_code_type": "SWIFT",
    "bank_identifier_code": "CHASUS33",
    "created_at": "2024-03-02T14:30:00.000Z",
    "updated_at": "2024-03-02T14:30:00.000Z"
  }
}

json

application/json

Create a new ledger account

POST

https://sandbox.tesserx.co

/v1/accounts/ledgers

Create a ledger account linked to an external liquidity provider.

Supported Providers:

CIRCLE_MINT: Circle Mint USDC accounts for institutional settlement
KRAKEN: Kraken exchange accounts for cryptocurrency liquidity

Ledger accounts are virtual accounts managed by the provider. They enable fast settlement without on-chain transactions.

Ownership: Use tenant_id OR counterparty_id to link the account. Omit both for a workspace-level ledger account.

Create a new ledger account › Request Body

name

string · minLength: 1 · maxLength: 255 · required

Human-readable name for the ledger account

provider

string · enum · required

Liquidity provider that manages this ledger account. CIRCLE_MINT for Circle Mint accounts, KRAKEN for Kraken exchange accounts.

Enum values:

CIRCLE_MINT

KRAKEN

tenant_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Tenant ID (mutually exclusive with counterparty_id). Links this ledger account to a specific tenant.

counterparty_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Counterparty ID (mutually exclusive with tenant_id). Links this ledger account to a specific counterparty.

Create a new ledger account › Responses

Ledger account created successfully

object · required

POST/v1/accounts/ledgers

curl --request POST \
  --url https://sandbox.tesserx.co/v1/accounts/ledgers \
  --header 'Content-Type: application/json' \
  --data '
{
  "tenant_id": "7a1f5c9e-3b2d-4e68-b0a4-6e9c1f3d8a2b",
  "name": "Circle Settlement Account",
  "provider": "CIRCLE_MINT"
}
'

shell

Example Request Body

{
  "tenant_id": "7a1f5c9e-3b2d-4e68-b0a4-6e9c1f3d8a2b",
  "name": "Circle Settlement Account",
  "provider": "CIRCLE_MINT"
}

json

application/json

Example Responses

{
  "data": {
    "id": "770e8400-e29b-41d4-a716-446655440006",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": null,
    "type": "ledger",
    "name": "Circle Settlement Account",
    "provider": "CIRCLE_MINT",
    "created_at": "2024-03-01T10:00:00.000Z",
    "updated_at": "2024-03-01T10:00:00.000Z"
  }
}

json

application/json

Create a new wallet account

POST

https://sandbox.tesserx.co

/v1/accounts/wallets

Create a new stablecoin wallet account.

Supported Networks:

stablecoin_ethereum - Ethereum/Polygon stablecoin wallet
stablecoin_solana - Solana stablecoin wallet
stablecoin_stellar - Stellar stablecoin wallet

Wallet Types:

Managed (is_managed=true) - Tesser-managed wallet, requires signature
Unmanaged (is_managed=false, default) - External wallet, requires wallet_address

Ownership: Optionally link to a tenant or counterparty using tenant_id or counterparty_id.

Create a new wallet account › Request Body

name

string · minLength: 1 · maxLength: 255 · required

Human-readable name for the wallet account

type

string · enum · required

Stablecoin network type. Determines which blockchain network the wallet operates on.

Enum values:

stablecoin_ethereum

stablecoin_solana

stablecoin_stellar

tenant_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Tenant ID (mutually exclusive with counterparty_id). Links this wallet to a specific tenant.

counterparty_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Counterparty ID (mutually exclusive with tenant_id). Links this wallet to a specific counterparty.

signature

string

is_managed

boolean

Default: false

wallet_address

string

Blockchain wallet address. Required for unmanaged wallets (is_managed=false). Auto-generated for managed wallets.

Create a new wallet account › Responses

Wallet account created successfully

object · required

POST/v1/accounts/wallets

curl --request POST \
  --url https://sandbox.tesserx.co/v1/accounts/wallets \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Treasury Wallet (Omnibus)",
  "type": "stablecoin_ethereum",
  "is_managed": true,
  "signature": "eyJwdWJsaWNLZXkiOiJwdWJfZXhhbXBsZSIsInNpZ25hdHVyZSI6InNpZ19leGFtcGxlIiwic2NoZW1lIjoiRUQyNTUxOSJ9"
}
'

shell

Example Request Body

{
  "name": "Treasury Wallet (Omnibus)",
  "type": "stablecoin_ethereum",
  "is_managed": true,
  "signature": "eyJwdWJsaWNLZXkiOiJwdWJfZXhhbXBsZSIsInNpZ25hdHVyZSI6InNpZ19leGFtcGxlIiwic2NoZW1lIjoiRUQyNTUxOSJ9"
}

json

application/json

Example Responses

{
  "data": {
    "id": "7a3d8f2e-6b4c-4a91-b8e5-2f9c1d7e3a0b",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": null,
    "type": "stablecoin_ethereum",
    "name": "Treasury Wallet - Ethereum",
    "crypto_wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE0B",
    "is_managed": true,
    "assets": [
      {
        "currency": "USDC",
        "network": "POLYGON",
        "available_balance": "0"
      },
      {
        "currency": "USDT",
        "network": "POLYGON",
        "available_balance": "0"
      }
    ],
    "created_at": "2024-03-01T10:00:00.000Z",
    "updated_at": "2024-03-01T10:00:00.000Z"
  }
}

json

application/json

Get an account by ID

GET

https://sandbox.tesserx.co

/v1/accounts/{id}

Retrieve a specific account by its unique identifier.

Get an account by ID › path Parameters

id

string · required

Account ID (UUID)

Get an account by ID › query Parameters

include_secure

boolean

Include masked secure fields (e.g., bank account number)

Get an account by ID › Responses

Account retrieved successfully

object · required

GET/v1/accounts/{id}

curl --request GET \
  --url https://sandbox.tesserx.co/v1/accounts/:id

shell

Example Responses

{
  "data": {
    "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
    "type": "fiat_bank",
    "name": "Operating Account - EU",
    "bank_name": "Chase Bank",
    "bank_code_type": "SWIFT",
    "bank_identifier_code": "CHASUS33",
    "created_at": "2024-03-02T14:30:00.000Z",
    "updated_at": "2024-03-02T14:30:00.000Z",
    "bank_account_number": "•••6789"
  }
}

json

application/json

Update an account

PATCH

https://sandbox.tesserx.co

/v1/accounts/{id}

Update an existing account's information.

Update an account › path Parameters

id

string · required

Account ID (UUID)

Update an account › Request Body

name

string · minLength: 1

New account name

Update an account › Responses

Account updated successfully

object · required

PATCH/v1/accounts/{id}

curl --request PATCH \
  --url https://sandbox.tesserx.co/v1/accounts/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Updated Operating Account"
}
'

shell

Example Request Body

{
  "name": "Updated Operating Account"
}

json

application/json

Example Responses

{
  "data": {
    "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
    "type": "fiat_bank",
    "name": "Updated Operating Account",
    "bank_name": "Chase Bank",
    "bank_code_type": "SWIFT",
    "bank_identifier_code": "CHASUS33",
    "created_at": "2024-03-02T14:30:00.000Z",
    "updated_at": "2024-03-01T12:00:00.000Z"
  }
}

json

application/json

Currencies