Scope: accounting:remittances.read https://api.alladdin.com/api/v2/treasury/remittances

Returns a paginated list of bank remittances for the account, filterable by direction (type), processing status, date range, treasury bank account, creditor (SWIFT/IBAN/SEPA id) or issuer. Use when the user asks to list, view, or filter their remittances. This endpoint returns remittance batches only; for individual invoices use the invoices list, and for individual payments not grouped into a remittance use the payments list.

Parameters

Query parameters

type string optional

Filter by remittance direction. inbound returns collection remittances received from customers. outbound returns payment remittances issued to suppliers.

"inbound" "outbound" status string optional

Filter by processing status

"pending" "completed" "processing" start_date string<date> optional

Inclusive lower bound on the remittance date (ISO 8601 date, e.g. 2026-01-01)

end_date string<date> optional

Inclusive upper bound on the remittance date (ISO 8601 date, e.g. 2026-12-31)

bank_id string optional

Filter by treasury bank account identifier

creditor_swift string optional

Filter by creditor SWIFT/BIC code (8 or 11 alphanumeric characters)

creditor_iban string optional

Filter by creditor IBAN

creditor_id string optional

Filter by SEPA creditor identifier

issuer_id string optional

Filter by issuer identifier

cursor string optional

Opaque cursor for pagination

limit integer optional = 50

Maximum number of remittances to return per page. Defaults to 25, maximum 100.

Request

import requests

url = "https://api.alladdin.com/api/v2/treasury/remittances?type=value&status=value&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

{
  "items": [
    {
      "id": "string",
      "type": "inbound",
      "treasury_id": "string",
      "description": "string",
      "date": "2024-01-15",
      "mode": "core",
      "iban": "string",
      "swift": "string",
      "creditor_id": "string",
      "issuer_id": "string",
      "total": "1234.56",
      "status": "pending"
    }
  ],
  "cursor": "string",
  "has_more": false
}

Success responses

200 List of remittances application/json object items[] object[] id string

Unique identifier of the remittance

type string

Direction of the remittance

Enum: inbound outbound treasury_id string

Identifier of the treasury account used

description string | null

Free-text description of the remittance

date string<date> | null

Remittance date in ISO 8601 format

mode string | null

SEPA direct debit scheme used for the remittance

Enum: core cor1 b2b coredto `` iban string

IBAN of the creditor bank account

swift string | null

SWIFT/BIC code of the creditor bank

creditor_id string | null

SEPA creditor identifier

issuer_id string | null

Issuer identifier for the remittance

total string

Total amount of the remittance as a decimal string

status string

Current processing status of the remittance

Enum: pending completed processing cursor string | null has_more boolean

Error responses

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 429 Rate limit exceeded application/json

Next →Get a remittance →