# List booked ledger entries

`GET /v1/ledger-entries`

The posted entries in a date range, ordered by date and posting number: VAT is its own entry, as in the reports. Entries reversed by a correction or cancellation are excluded; a corrected transaction shows its current entries. Drafts are excluded. Amounts follow the ledger sign: debit positive, credit negative.

**Scopes:** any of `journal:read`, `read:ledger`

## Request

```bash
curl https://api.numina.app/v1/ledger-entries?from=2026-01-01&to=2026-12-31 \
  -H "Authorization: Bearer numi_YOUR_API_KEY"
```

## Query parameters

- `from` (string, required): First entry date (inclusive, YYYY-MM-DD) (YYYY-MM-DD)
- `to` (string, required): Last entry date (inclusive, YYYY-MM-DD) (YYYY-MM-DD)
- `limit` (integer, optional): Entries per page (default and max: 1000) Default: `1000`. (1–1000)
- `offset` (integer, optional, nullable): Pagination offset; pass next_offset from the last page Default: `0`. (≥ 0)

## Response `200`

A page of booked entries

```json
{
  "entries": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
      "date": "2026-03-14",
      "entry_number": 0,
      "account_number": 4000,
      "account_name": "Kontorartikler",
      "text": "string",
      "amount": 0,
      "amount_dkk": 0,
      "currency": "DKK",
      "is_vat_entry": false,
      "vat_code": "I25",
      "entry_type": "vat_settlement",
      "attachment_id": "550e8400-e29b-41d4-a716-446655440000",
      "attachment_number": 185
    }
  ],
  "has_more": false,
  "next_offset": 0
}
```

## Errors

- `400` Bad Request - Invalid input or validation failed
- `401` Unauthorized - Invalid or missing authentication
- `403` Forbidden - Missing scope, or the company is archived
- `429` Too Many Requests - Rate limit exceeded
- `500` Internal Server Error

See https://developers.numina.app/errors.md for the error format.