---
title: "Get recognized journal entries"
method: GET
path: "/accounting-api/journal-entries"
tags: ["Accounting (only available for accounting add-on users)"]
---

# Get recognized journal entries

`GET /accounting-api/journal-entries`

## Request

- Base URL: `https://open-api.guesty.com/v1`
- URL: `https://open-api.guesty.com/v1/accounting-api/journal-entries`
- Auth: API key in header `authorization`

Retrieves recognized journal entries matching the specified parameters

## Query parameters

- `transactionDate` object, required
  - `operator` '@in_future' | '@in_past' | '@in_next_days' | '@is_after_days' | '@in_past_days' | '@is_before_days' | '@on' | '@between' | '@lt' | '@today', required: Comparison operator
  - `value` union, required: List of available date operators: - `@in_future` - boolean value, Example: `{ "operator": "@in_future", "value": true }` - `@in_past` - boolean value, Example: `{ "operator": "@in_past", "value": true }` - `@in_next_days` - numeric value, Example: `{ "operator": "@in_next_days", "value": 2 }` - `@is_after_days` - numeric value, Example: `{ "operator": "@is_after_days", "value": 2 }` - `@in_past_days` - numeric value, Example: `{ "operator": "@in_past_days", "value": 2 }` - `@is_before_days` - numeric value, Example: `{ "operator": "@is_before_days", "value": 2 }` - `@on` - Date string value, Example: `{ "operator": "@on", "value": "2022-07-03T12:00:00+03:00" }` - `@between` - array of two Date string values, Example: `{ "operator": "@between", "value": ["2022-07-03T12:00:00+03:00", "2022-07-08T12:00:00+03:00"] }` - `@lt` - Date string value, Example: `{ "operator": "@lt", "value": "2022-07-03T12:00:00+03:00" }}` - `@gte` - Date string value, Example: `{ "operator": "@gte", "value": "2022-07-03T12:00:00+03:00" }}` - `@today` - boolean value, Example: `{ "operator": "@today", "value": true }`
    - string: Supported by `@gte`, `@lt`, `@on` operators
    - boolean: Supported by `@today`, `@is_before_days`, `@in_past`, `@in_future` operators. Only `true` is acceptable
    - number: Supported by `@is_before_days`, `@in_past_days`, `@is_after_days`, `@in_next_days` operators
    - string[]: Supported only by `@between` operator in array format `["2024-07-03", "2024-07-10"]`
- `name` string
- `description` string
- `reservationConfirmationCodes` string[]
- `ledger` string[]
- `guests` string[]
- `vendors` string[]
- `owners` string[]
- `listings` string[]
- `chargeCode` string[]
- `triggers` string[]
- `skip` number
- `limit` number
- `sortByDate` 'ASC' | 'DESC'

## Response `200`

Journal entries response

- object
  - `skip` number, required
  - `limit` number, required
  - `current` number, required
  - `total` number, required
  - `data` object[], required
    - `id` number, required
    - `transactionId` number, required
    - `date` string, required
    - `description` string, required
    - `ledger` string, required
    - `guest` object, required
      - `id` string, required
      - `name` string, required
    - `vendor` object, required
      - `id` string, required
      - `name` string, required
    - `owner` object, required
      - `id` string, required
      - `name` string, required
    - `amount` object, required
      - `value` number, required
      - `currency` string, required
    - `name` string, required
    - `listing` object, required
      - `href` string, required
      - `title` string, required
      - `target` string, required
    - `chargeType` string, required
    - `reservationConfirmationCode` object, required
      - `href` string, required
      - `title` string, required
      - `target` string, required
    - `paymentConfirmationCode` string, required
    - `chargeCode` string, required
    - `trigger` string, required
    - `attachments` object[], required
      - `id` number, required
      - `url` string, required
      - `urlThumbnail` string, required
      - `uploadedBy` string, required
      - `uploadedAt` number, required
      - `originalFilename` string, required
      - `originalExtension` string, required
    - `recognized` boolean, required

## Other responses

- `400`: Payload validation failed
- `403`: Accounting feature flow disabled
- `500`: Unhandled exception. Something went wrong on server

## Changes

- **2026-11-03** `3122b8618183`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/guesty/apis/guesty-open-api/changes/accounting-api/journal-entries/get.md)

---

[API](https://skmtc.dev/guesty/apis/guesty-open-api.md) - [All operations](https://skmtc.dev/guesty/apis/guesty-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/guesty/apis/guesty-open-api/revisions/3122b8618183?raw)