Docs

List transaction accounts

GET /api/v1/programmatic/accounts

GET/api/v1/programmatic/accounts
Walletsv1wallets:read

Returns active asset accounts that can be used as transaction source or destination identifiers.

Parameters

NameInType Description
pagequerynumberOptional One-based result page. <page>
limitquerynumberOptional Maximum resources returned per page. <limit>

Code examples

curl --request GET \
  --url 'https://api.tetri.app/api/v1/programmatic/accounts?page=<page>&limit=<limit>' \
  --header 'Authorization: Bearer $TETRI_API_TOKEN'

Responses

200Active asset accounts and pagination metadata.
{
  "data": [
    {
      "type": "accounts",
      "id": "<uuid>",
      "attributes": {
        "name": "Checking (USD)",
        "type": "asset",
        "account_role": "defaultAsset",
        "currency_id": "<uuid>",
        "currency_code": "USD",
        "currency_symbol": "$",
        "currency_decimal_places": 2,
        "current_balance": "1250.00",
        "native_current_balance": "1250.00",
        "active": true,
        "notes": "<string>",
        "liability_type": "<string>",
        "iban": "<string>",
        "account_number": "<string>",
        "bic": "<string>",
        "opening_balance": "0.00",
        "opening_balance_date": "2025-01-01",
        "virtual_balance": "0.00",
        "include_net_worth": true,
        "credit_card_type": "<string>",
        "first_payment_date": "2026-05-15",
        "payment_day_of_month": 15,
        "interest": "0.00",
        "interest_period": "monthly",
        "scheduled_payment_amount": "1066.20",
        "liability_direction": "<string>",
        "expected_settle_date": "2026-09-15",
        "order": 0,
        "icon": "<string>",
        "icon_color": "#3366ff",
        "group_id": "<uuid>",
        "group_name": "<string>",
        "wallet_id": "<uuid>"
      }
    }
  ],
  "meta": {
    "pagination": "<string>"
  }
}
400Request parameters or payload failed validation. Inspect `code` and `message`.
{
  "statusCode": 400,
  "code": "PROGRAMMATIC_PAGINATION_MODE_CONFLICT",
  "message": "<string>",
  "error": "Bad Request",
  "request_id": "8cf64dcc-0f73-4f8d-a845-3d80c1040475"
}
401The personal access token is missing, invalid, expired, or revoked.
{
  "statusCode": 400,
  "code": "PROGRAMMATIC_PAGINATION_MODE_CONFLICT",
  "message": "<string>",
  "error": "Bad Request",
  "request_id": "8cf64dcc-0f73-4f8d-a845-3d80c1040475"
}
403The token lacks the required scope or no longer has workspace access.
{
  "statusCode": 400,
  "code": "PROGRAMMATIC_PAGINATION_MODE_CONFLICT",
  "message": "<string>",
  "error": "Bad Request",
  "request_id": "8cf64dcc-0f73-4f8d-a845-3d80c1040475"
}
429The credential exceeded its request rate limit.
{
  "statusCode": 400,
  "code": "PROGRAMMATIC_PAGINATION_MODE_CONFLICT",
  "message": "<string>",
  "error": "Bad Request",
  "request_id": "8cf64dcc-0f73-4f8d-a845-3d80c1040475"
}