Treasury

Get a treasury account

Returns an account by its identifier.

GET
/api/v1/treasury/accounts/{accountId}

Request examples

curl https://app.filmo.io/api/v1/treasury/accounts/acco_8f2a1c \
  --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"
  }
}

Generated from the schema

The BANK ACCOUNT NUMBER is not published: to say which account a payment came in or went out through, the account identifier is enough. Accounts are not created or modified through this API.

Authorizations

Bearer API key with the scope below. treasury:read

Headers

If-None-Matchstring

Conditional read: the ETag of the copy you already have. If the resource has not changed, the response is 304 with no body.

Example:"\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""

Path parameters

accountIdstringRequired

Treasury account identifier.

Limits: min length 1

Response

application/json

Successful response.

Response schema: TreasuryAccountDto

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

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

dataobject

Treasury account. The bank account number is NOT published: to reference the treasury account in a payment its identifier is enough.

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.

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
404not_foundIt does not exist or is outside the scope of the API key.

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