Treasury

List treasury accounts

Returns the accounts money comes in and goes out through, sorted by name; archived accounts are left out unless requested.

GET
/api/v1/treasury/accounts

Request examples

curl https://app.filmo.io/api/v1/treasury/accounts \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": [
    {
      "id": "treasury_account_9f3a2b",
      "name": "Example treasury account",
      "type": "bank",
      "currency": "EUR",
      "status": "active",
      "createdAt": "2026-09-01T08:00:00.000Z",
      "updatedAt": "2026-09-01T08:00:00.000Z"
    }
  ],
  "pagination": {
    "nextCursor": "eyJvIjoyMH0",
    "hasMore": true,
    "total": 1
  }
}

Generated from the schema

The BANK ACCOUNT NUMBER and the balance are not published: the identifier is enough to say which account a payment went through.

Authorizations

Bearer API key with the scope below. treasury:read

Query parameters

limitintegerdefault:50

Page size (1-500). Defaults to 50.

Limits: min 1, max 500

cursorstring

Opaque cursor of the page to return. Pass the value of pagination.nextCursor from the previous response; treat it as opaque.

Limits: max length 200

sortstring

Sort order: a single field, with a leading "-" for descending (e.g. "-updatedAt"). Sortable fields: name, type, status, currency, createdAt, updatedAt. Defaults to "name". Ties are broken by id, so the order is stable across pages, and a cursor is bound to the sort it was issued with.

Limits: max length 200

typestring

Filter by account type: bank (a bank account), cash (a cash box) or manual.

Available options: bank, cash, manual

statusstring

Filter by status: active, needs_reauth, disconnected or archived. Without it, archived accounts are left out unless includeArchived is true.

Available options: active, needs_reauth, disconnected, archived

currencystring

Filter by currency, as an ISO 4217 code.

Limits: min length 3, max length 3

includeArchivedbooleandefault:false

Set it to true to include archived accounts. Off by default; ignored when status is given.

includeTotalbooleandefault:false

Set it to true to include pagination.total, the number of results that match the filters across all pages. Off by default.

Response

application/json

Successful response.

Response schema: TreasuryAccountDto

Envelope: TreasuryAccountList. meta.warnings is present only when the operation is deprecated.

Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset

dataobject[]

Show child attributes
data.idstring

Treasury account identifier.

data.namestring

Name by which the treasury account is recognized.

data.typestring

Nature of the treasury account: bank (a bank account), cash (a cash box) or manual.

Available options: bank, cash, manual

data.currencystring

Currency of the treasury account, as an ISO 4217 code.

data.statusstring

Treasury account status: active, needs_reauth (the bank connection must be renewed), disconnected or archived.

Available options: active, needs_reauth, disconnected, archived

data.createdAtstring<date-time>

Creation date in ISO 8601 UTC.

data.updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

paginationobject

Opaque-cursor pagination metadata.

Show child attributes
pagination.nextCursorstring | null

Opaque cursor of the next page; null when there are no more results. Pass it as cursor in the next request.

pagination.hasMoreboolean

Whether more results exist beyond this page.

pagination.totalinteger

Number of results matching the filters across all pages. Present only when the request sets includeTotal=true.

Limits: min 0

metaobject

Additional information about the response.

Show child attributes
meta.warningsobject[]

Lifecycle warnings; present only when the operation is deprecated.

Show child attributes
meta.warnings.codestring

Stable warning code.

Available options: deprecated

meta.warnings.messagestring

For people: what is deprecated, until when, and what to use.

meta.warnings.sunsetstring

Day (YYYY-MM-DD) the operation stops being served.

meta.warnings.replacementstring | null

operationId of the operation to use instead, or null if there is none.

Errors

StatusCodesMeaning
400validation_errorMalformed query or body. errors[] lists every offending field with its stable code.

401, 403, 429, 500 can be returned by any operation. Errors

Deprecation

This operation is not deprecated. Deprecations are announced with a Deprecation header and a sunset date. Versioning policy