GET

List banking account cash movements

Scope: accounting:banks.read https://api.alladdin.com/api/v2/treasury/accounts/{id}/cash-movements

Returns a cursor-paginated list of ledger entries for a cash-type banking account. Use this endpoint to list cash register movements — entries created manually or automatically from payments linked to a cash account. This endpoint only works for accounts of type cash; for bank, card, or gateway accounts use /api/v2/treasury/accounts/{id}/bank-movements instead (which returns raw bank-statement entries from providers).

Parameters

Path parameters

id string required

Banking account identifier

Query parameters

cursor string optional

Opaque cursor returned by the previous page

limit integer optional = 50

Maximum number of movements per page. Defaults to 50, maximum 200.

start_date string<date> optional

Inclusive lower bound on the movement accounting date (ISO 8601 date or date-time)

end_date string<date> optional

Inclusive upper bound on the movement accounting date (ISO 8601 date or date-time)

Request

python

import requests

url = "https://api.alladdin.com/api/v2/treasury/accounts/507f1f77bcf86cd799439011/cash-movements?cursor=value&limit=50&start_date=2026-01-01"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

json

{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "bankingAccountId": "507f1f77bcf86cd799439012",
      "date": "2024-01-15T10:30:00Z",
      "description": "string",
      "amount": "150.00",
      "currency": "EUR",
      "accountingAccountNumber": 57000001,
      "sign": "in",
      "entryNumber": 42,
      "entryType": "opening"
    }
  ],
  "cursor": "string",
  "has_more": false
}

Success responses

200 List of banking account cash movements application/json object items[] object[] id string

Unique identifier of the ledger entry

bankingAccountId string

Identifier of the cash banking account this movement belongs to

date string<date-time>

Accounting date of the ledger entry as an ISO 8601 timestamp

description string | null

Description of the movement. Null when the entry has no description set (common for auto-generated movements such as payment-linked entries).

amount string

Movement amount (debit minus credit) in the cash account currency. Positive for cash-in, negative for cash-out. Decimal as string.

currency string

ISO 4217 currency code of the cash account

accountingAccountNumber integer

PGC accounting account number linked to the cash register (e.g. 570xxxxx for caja)

sign string

Direction of the movement: 'in' for cash received (positive amount), 'out' for cash paid (negative amount). Zero-amount entries (e.g. reclassifications) are reported as 'in' by convention.

Enum: in out entryNumber integer | null

Accounting entry group number (asiento contable). Null for automatically generated entries.

entryType string

Identifier of the source document or accounting operation that produced this ledger entry. 'opening' and 'closing' are special markers for the opening-balance and year-end closing entries; all other values name the originating document (invoice, payment, expense, salesreceipt, etc.).

Enum: amortization reg pl opening closing entry salesreceipt receiptnote transaction collect purchase invoice expense payment record payroll purchaserefund creditnote prorata_regularization vat_regularization purchaseshipment cursor string | null has_more boolean

Error responses

401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Banking account not found application/json 429 Rate limit exceeded application/json

← PreviousList banking account movements →

Next →Reconcile a bank movement →

Alladdin