Lists the transactions of every ledger account

Lists the transactions of every ledger account of the tenant in one feed: its subaccounts and its tenant-level accounts (root, current, fees). Each transaction carries the account_id of the account it belongs to, so both legs of a transfer between two of your accounts appear, one per account. Under each account, the feed lists the same transactions as that account's own listing, GET /v1/ledger/accounts/{account_id}/transactions.

sort[field] selects how the feed is walked:

• inserted (default, ascending by default): the order in which the ledger recorded the transactions. Use it to extract everything recorded since your last run in one pass: store the next_cursor of the last page and send it on the next run, even when has_more is false. It serves transactions about 2 minutes after the ledger records them, so a transaction committed late is never left behind a cursor; for subaccount transactions, the ledger_account_transaction_created webhook delivers them sooner. Once a page in ascending order reaches that delay, its next_cursor moves up to it, even when the page is empty, so the next run does not read the same range again. The transaction_at and origin_transaction_at filters are not accepted in this order.
• transaction_at or origin_transaction_at (descending by default): the transactions by that date, with no delay. A walk in these orders does not come back for a transaction recorded after it passed that transaction's date, so use inserted to extract.

Pagination is by cursor only: next_cursor reads the next page of the same request and is rejected with invalid_cursor if it is sent with another sort or other filters. It is kept even when has_more is false, and it is null only when a first page outside ascending inserted order comes back empty. page_size can change between pages. There are no page numbers nor totals.

reverted_by_id and origin_state are read when the page is served: a transaction already read can be reversed or change its origin state later. A reversal arrives as its own transaction, whose reverts_id points to the transaction it reverts.

In a date order, a range on that same date, such as transaction_at in transaction_at order, narrows what the pages read: set it to skip history you do not need.

curl -X GET "https://api.cert.monoban.co/v1/ledger/transactions"

{
  "pagination": {
    "has_more": true,
    "next_cursor": "AQh3sNQ7c1lB0Y9jdC7bF0ZhAZq3oVhGcgCm6lYw8Xnf",
    "page_size": 100
  },
  "transactions": [
    {
      "account_id": "lacc_5tgliBmzjZ6mpQPRbQjfKj",
      "amount": {
        "amount": 100000000,
        "currency": "COP"
      },
      "description": "Purchase on ABC Commerce",
      "id": "ltx_5tgliBmzjZ6mpQPRbQjfKj",
      "id_in_origin": "ctx_02vc3Wvuv6WaaDM81m8Utv",
      "operation_type": "debit",
      "origin": "card_transaction",
      "origin_state": "approved",
      "origin_transaction_at": "2022-01-01T01:00:00Z",
      "reverted_by_id": "ltx_5tgliBmzjZ6mpQPRbQjfKj",
      "reverts_id": "ltx_5tgliBmzjZ6mpQPRbQjfKj",
      "transaction_at": "2022-01-01T01:00:00Z"
    }
  ]
}

{
  "code": "400 Bad Request",
  "errors": [
    {
      "error_code": "invalid_cursor",
      "message": "The cursor is malformed or was issued for another sort or other filters.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Malformed request"
}

{
  "code": "401 Unauthorized",
  "errors": [
    {
      "error_code": "missing_authorization_header",
      "message": "`Authorization` header is missing.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Authorization header is missing or invalid."
}

{
  "code": "403 Forbidden",
  "errors": [
    {
      "error_code": "not_authorized",
      "message": "Not authorized to have access to this resource.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Not authorized to have access to this resource"
}

{
  "code": "422 Unprocessable Content",
  "errors": [
    {
      "error_code": "invalid_account_id",
      "message": "An account id doesn't belong to the client's ledger accounts.",
      "path": "#/path/to/field",
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Validation errors"
}