Treasury

List treasury payments

Returns the collections and payments recorded in treasury, newest first, with the same projection as their GET.

Tool

filmo_treasury_payments_list

Readtreasury:read

treasury:read
120/min
Server annotation: Read-only
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_treasury_payments_list",
    "arguments": {
      "limit": 20
    }
  }
}

{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "direction": "<direction>",
        "amount": "1234.50",
        "currency": "EUR",
        "date": "2026-09-01T08:00:00Z",
        "type": "<type>",
        "treasuryAccountId": "trea_8f2a1c",
        "contactId": "cont_8f2a1c",
        "reference": "<reference>",
        "linkedDocuments": [
          {
            "type": "invoice",
            "id": "id_8f2a1c",
            "amount": "1234.50"
          }
        ],
        "createdAt": "2026-09-01T08:00:00Z",
        "updatedAt": "2026-09-01T08:00:00Z"
      }
    ],
    "pagination": {
      "nextCursor": "eyJvIjo1MH0",
      "hasMore": true,
      "total": 1
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generated from the schema

Filter by direction, type, treasury account, contact, linked invoice, credit note or order, bank reconciliation and payment date. Notes and the reconciliation state are not published.

Arguments

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: date, amount, createdAt, updatedAt. Defaults to "-date". 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

directionstring

Filter by direction: in (money coming in) or out (money going out).

Available options: in, out

typestring

Filter by payment type: normal, deposit (an advance payment) or transfer (an internal transfer between treasury accounts).

Available options: normal, deposit, transfer

typesstring[]

Filter by type, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

Available options: normal, deposit, transfer

Limits: min 1 items, max 50 items

treasuryAccountIdstring

Filter by the treasury account the payment goes through.

Limits: min length 1, max length 100

contactIdstring

Filter by the customer or supplier of the payment.

Limits: min length 1, max length 100

invoiceIdstring

Filter by the invoice the payment is assigned to.

Limits: min length 1, max length 100

creditNoteIdstring

Filter by the credit note the payment is assigned to.

Limits: min length 1, max length 100

orderIdstring

Filter by the order the payment is assigned to.

Limits: min length 1, max length 100

reconciledboolean

Filter by bank reconciliation: true for reconciled payments, false for the ones still pending. Absent means no filter.

includeTotalbooleandefault:false

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

dateFiltersobject

Date filters by field. A bare day (YYYY-MM-DD) is read in the business timezone; an ISO 8601 instant with offset is applied as is by gte, lte, gt and lt, while on widens it to the whole business day that contains it. Fields: date.

Show child attributes

dateFilters.dateobject

Show child attributes

dateFilters.date.gtestring

From this day or instant, inclusive.

dateFilters.date.ltestring

Up to this day or instant, inclusive.

dateFilters.date.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.date.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.date.onstring

Exactly that day; an instant means the whole business day that contains it.

Result

On success the result carries structuredContent with data and meta. These are the attributes of data.

Show the attributes of data

idstring

Payment identifier.

directionstring

in when money comes in (a collection) and out when it goes out (a payment).

amountstring

Payment amount as a decimal string, in the indicated currency.

Limits: pattern ^-?\d+\.\d{2}$

currencystring

Payment currency, as an ISO 4217 code.

datestring<date-time>

Payment date in ISO 8601 UTC.

typestring

normal, or deposit when it is an advance payment.

treasuryAccountIdstring

Treasury account the payment goes through.

contactIdstring | null

Customer or supplier of the payment; null if not declared.

referencestring | null

External reference of the payment; null if it has none.

linkedDocumentsobject[]

Documents the payment is assigned to; empty if it is not linked to any.

Show child attributes

linkedDocuments.typestring

Kind of the linked document.

Available options: invoice, creditNote, supplierInvoice, quote, proforma, salesReceipt, simpleCreditNote, purchaseOrder

linkedDocuments.idstring

Identifier of the linked document.

linkedDocuments.amountstring

Amount of this payment assigned to the document, as a decimal string.

Limits: pattern ^-?\d+\.\d{2}$

createdAtstring<date-time>

Creation date in ISO 8601 UTC.

updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

An error is a result with isError: true and the problem in content[0].text; there is no structuredContent. See Errors.

The same operation by REST

This tool runs GET /api/v1/treasury/payments.

Treasury
List treasury payments
Returns the collections and payments recorded in treasury, newest first, with the same projection as their GET.
Guides
Safe writes
An assistant that can write can also write the wrong thing. Decide which tools need a person, retry without duplicating, and know what a write sets in motion.
Guides
Errors
A tool error is a result with isError: true and the problem in the first text block. Branch on its code.

Was this page helpful?