Scope: accounting:daily-ledger.read https://api.alladdin.com/api/v2/ledger-entries

Returns a paginated list of ledger entries in your accounting books.
Results are cursor-paginated: the response includes a cursor value and a has_more boolean. Default page size is 50, configurable up to 200 with limit.

Parameters

Query parameters

start_date string<date> required

Filter entries from this date onward

end_date string<date> required

Filter entries up to this date

cursor string optional

Opaque cursor for pagination

limit integer optional = 50

Maximum number of ledger entries to return per page. Defaults to 50, maximum 200.

account integer optional

Filter entries by accounting account number (e.g. 70500001). Returns only entries posted to this exact account.

Request

import requests

url = "https://api.alladdin.com/api/v2/ledger-entries?start_date=2026-01-01&end_date=2026-12-31&cursor=value"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

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

Responses

Response

{
  "items": [
    {
      "id": "string",
      "entry_number": 0,
      "line": 0,
      "date": "string",
      "type": "string",
      "description": "string",
      "doc_description": "string",
      "account": 4300,
      "debit": "100.00",
      "credit": "0.00",
      "tags": [
        "string"
      ],
      "checked": false
    }
  ],
  "cursor": "string",
  "has_more": false
}

Success responses

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

Ledger entry ID — use it to fetch the full entry via GET /ledger-entries/{id}

entry_number integer

Sequential number of the ledger entry

line integer

Line number within the entry

date string

Date of the ledger entry

type string | null

Type of the ledger entry

description string

Description of the entry

doc_description string | null

Description from the linked document

account integer

Account number from the chart of accounts

debit string

Debit amount as a decimal string

credit string

Credit amount as a decimal string

tags[] string[]

List of tags attached to the entry

checked boolean

Whether the entry has been reviewed

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

← PreviousList chart of accounts →

Next →Get a ledger entry →