Treasury
Get a treasury account
Returns an account by its identifier.
Request examples
curl https://app.filmo.io/api/v1/treasury/accounts/acco_8f2a1c \
--header "Authorization: Bearer $FILMO_API_KEY"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
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
Treasury account identifier.
Limits: min length 1
Response
Successful response.
Response schema: TreasuryAccountDto
Envelope: TreasuryAccountResponse. meta. is present only when the operation is deprecated.
Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag
Treasury account. The bank account number is NOT published: to reference the treasury account in a payment its identifier is enough.
Show child attributesHide child attributes
Treasury account identifier.
Name by which the treasury account is recognized.
Nature of the treasury account: bank (a bank account), cash (a cash box) or manual.
Available options: bank, cash, manual
Currency of the treasury account, as an ISO 4217 code.
Treasury account status: active, needs_reauth (the bank connection must be renewed), disconnected or archived.
Available options: active, needs_reauth, disconnected, archived
Creation date in ISO 8601 UTC.
Last modification date in ISO 8601 UTC.
Additional information about the response.
Show child attributesHide child attributes
Lifecycle warnings; present only when the operation is deprecated.
Show child attributesHide child attributes
Stable warning code.
Available options: deprecated
For people: what is deprecated, until when, and what to use.
Day (YYYY-MM-DD) the operation stops being served.
operationId of the operation to use instead, or null if there is none.
Where the deprecation is documented (the changelog).
Not modified: the If-None-Match sent matches the current ETag. No body; the copy you have is current.
Headers: ETag
No body.
Authentication failed (unauthorized, api_key_invalid, api_key_revoked, api_key_expired, api_key_owner_inactive, api_key_owner_not_admin).
Headers: X-Request-Id · Content-Language
Not allowed (insufficient_scope: the API key does not have the required scope, named in requiredScope; forbidden: the owner of the key lacks the permission the operation requires). insufficient_scope is answered before the request counts against the rate limit, so it carries no RateLimit-* headers; forbidden does.
Headers: X-Request-Id · Content-Language
Resource not found (not_found): it does not exist or is outside the scope of the API key.
Headers: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Rate limit exceeded (rate_limited): retry after Retry-After seconds; RateLimit-* says which quota ran out.
Headers: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Retry-After
Internal error (internal_error).
Headers: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Errors
Deprecation
This operation is not deprecated. Deprecations are announced with a Deprecation header and a sunset date. Versioning policy
Related pages
Link to this section: Related pagesFinance
Treasury account
Treasury account.
Was this page helpful?