Get Journal Entries | Open Ledger Documentation

curl -G https://api-staging.openledger.com/v1/ledger/journal-entries \
     -H "Authorization: Bearer <token>" \
     -d entityId=ent_1234567890abcdef \
     -d month=3 \
     -d year=2024 \
     -d startDate=2024-01-01 \
     -d endDate=2024-12-31 \
     -d page=1 \
     -d limit=20

{
  "entries": [
    {
      "id": "je_1234567890abcdef",
      "date": "2024-03-15T10:30:00Z",
      "created_at": "2024-03-15T10:30:00Z",
      "description": "Monthly rent payment",
      "debit_account_id": "acc_1234567890abcdef",
      "debit_account_name": "Rent Expense",
      "debit_account_type": "EXPENSE",
      "credit_account_id": "acc_0987654321fedcba",
      "credit_account_name": "Cash - Operating Account",
      "credit_account_type": "ASSET",
      "amount": "250000",
      "status": "POSTED",
      "transaction_type": "journal_entry",
      "reference": "INV-2024-001",
      "memo": "Office rent for March 2024"
    }
  ],
  "totalEntries": 150,
  "totalPages": 8,
  "currentPage": 1
}

Retrieve journal entries for an entity with optional filtering by date range

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

entityIdstringRequired

The ID of the entity to get journal entries for

monthintegerOptional1-12

Filter by month (1-12)

yearintegerOptional

Filter by year

startDatestringOptionalformat: "date"

Start date for filtering (YYYY-MM-DD)

endDatestringOptionalformat: "date"

End date for filtering (YYYY-MM-DD)

pageintegerOptional>=1

Page number for pagination

limitintegerOptional1-100

Number of entries per page

Response

Journal entries retrieved successfully

entrieslist of objects

totalEntriesinteger

totalPagesinteger

currentPageinteger

Errors

400

Bad Request Error

404

Not Found Error

500

Internal Server Error