*MCP › Reference › Finance › Treasury*

# List treasury payments

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

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.

TOOL `filmo_treasury_payments_list` · `treasury:read` · 120/min · Server annotation: Read-only · Server annotation: Idempotent

## Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | No | Page size (1-500). Defaults to 50. = `50` |
| `cursor` | string | No | Opaque cursor of the page to return. Pass the value of `pagination.nextCursor` from the previous response; treat it as opaque. |
| `sort` | string | No | 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. |
| `direction` | string | No | Filter by direction: in (money coming in) or out (money going out). `in`, `out` |
| `type` | string | No | Filter by payment type: normal, deposit (an advance payment) or transfer (an internal transfer between treasury accounts). `normal`, `deposit`, `transfer` |
| `types` | string[] | No | 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. `normal`, `deposit`, `transfer` |
| `treasuryAccountId` | string | No | Filter by the treasury account the payment goes through. |
| `contactId` | string | No | Filter by the customer or supplier of the payment. |
| `invoiceId` | string | No | Filter by the invoice the payment is assigned to. |
| `creditNoteId` | string | No | Filter by the credit note the payment is assigned to. |
| `orderId` | string | No | Filter by the order the payment is assigned to. |
| `reconciled` | boolean | No | Filter by bank reconciliation: true for reconciled payments, false for the ones still pending. Absent means no filter. |
| `includeTotal` | boolean | No | Set it to true to include `pagination.total`, the number of results that match the filters across all pages. Off by default. = `false` |
| `dateFilters` | object | No | 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. |
| `dateFilters.date` | object | No |  |
| `dateFilters.date.gte` | string | No | From this day or instant, inclusive. |
| `dateFilters.date.lte` | string | No | Up to this day or instant, inclusive. |
| `dateFilters.date.gt` | string | No | Strictly after; a bare day means after the end of that day. |
| `dateFilters.date.lt` | string | No | Strictly before; a bare day means before the start of that day. |
| `dateFilters.date.on` | string | No | 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`.

| Name | Type | Description |
| --- | --- | --- |
| `id` | string | Payment identifier. |
| `direction` | string | in when money comes in (a collection) and out when it goes out (a payment). |
| `amount` | string | Payment amount as a decimal string, in the indicated currency. |
| `currency` | string | Payment currency, as an ISO 4217 code. |
| `date` | string<date-time> | Payment date in ISO 8601 UTC. |
| `type` | string | normal, or deposit when it is an advance payment. |
| `treasuryAccountId` | string | Treasury account the payment goes through. |
| `contactId` | string | Customer or supplier of the payment; null if not declared. |
| `reference` | string | External reference of the payment; null if it has none. |
| `linkedDocuments` | object[] | Documents the payment is assigned to; empty if it is not linked to any. |
| `linkedDocuments.type` | string | Kind of the linked document. `invoice`, `creditNote`, `supplierInvoice`, `quote`, `proforma`, `salesReceipt`, `simpleCreditNote`, `purchaseOrder` |
| `linkedDocuments.id` | string | Identifier of the linked document. |
| `linkedDocuments.amount` | string | Amount of this payment assigned to the document, as a decimal string. |
| `createdAt` | string<date-time> | Creation date in ISO 8601 UTC. |
| `updatedAt` | string<date-time> | Last modification date in ISO 8601 UTC. |

*Call · filmo_treasury_payments_list*

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

*Result (generated from the schema)*

```json
{
  "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
      }
    }
  }
}
```

## The same operation by REST

This tool runs [`GET /api/v1/treasury/payments`](https://docs.filmo.io/rest-api/endpoint-reference/treasury/list-treasury-payments).

---

Canonical URL: https://docs.filmo.io/mcp/tools/treasury/filmo-treasury-payments-list  
Last updated: 2026-10-25