---
title: "Returns a list of transactions"
method: GET
path: "/finance/v0-nsfw/accounts/transactions"
tags: ["SubLedger"]
---

# Returns a list of transactions

`GET /finance/v0-nsfw/accounts/transactions`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/finance/v0-nsfw/accounts/transactions`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `subledger.read`, `accounting.read`, `admin`

<br>You must have at least one of these scopes: 'subledger.read, accounting.read'.<br>For fine-grained clients, you must have this permission: 'core.subledger_accounts.read'.

## Query parameters

- `propertyId` string, required
- `reference` string, required
- `referenceType` 'House' | 'Guest' | 'External' | 'Booking'
- `accountingSchema` 'Simple' | 'Extended'
- `pageNumber` integer
- `pageSize` integer

## Response `200`

Success.

- PageableAccountingTransactionListModel
  - `transactions` AccountingTransactionModel[], required: The list of transactions
    - `timestamp` string, date-time, required: Timestamp with time zone information, when the booking was done<br />A date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
    - `date` string, date, required: The business date when the booking was done
    - `debitedAccount` ExportAccountModel, required
      - `name` string, required: The account name
      - `number` string, required: The account number
      - `parentNumber` string, nullable: The number of the parent account
      - `type` 'Revenues' | 'Payments' | 'Liabilities' | 'Receivables' | 'Vat' | 'House' | 'AccountsReceivable' | 'CityTaxes' | 'TransitoryItems' | 'VatOnLiabilities' | 'LossOfAccountsReceivable' | 'SecondCityTax' | 'GuestLevies', required: The account type
    - `creditedAccount` ExportAccountModel, required
      - `name` string, required: The account name
      - `number` string, required: The account number
      - `parentNumber` string, nullable: The number of the parent account
      - `type` 'Revenues' | 'Payments' | 'Liabilities' | 'Receivables' | 'Vat' | 'House' | 'AccountsReceivable' | 'CityTaxes' | 'TransitoryItems' | 'VatOnLiabilities' | 'LossOfAccountsReceivable' | 'SecondCityTax' | 'GuestLevies', required: The account type
    - `command` 'PostCharge' | 'PostPayment' | 'MoveLineItem' | 'PostPrepayment' | 'PostToAccountsReceivables' | 'PostPrepaymentVat' | 'PostToLossOfAccountsReceivables' | 'System', required: The type of business transaction which triggered the booking
    - `amount` PreciseMonetaryValueModel, required: Use this model in all accounting reports
      - `amount` number, double, required
      - `currency` string, required
    - `receipt` ReceiptModel
      - `type` 'Custom' | 'Reservation' | 'Invoice' | 'PspReference': The type of receipt.
      - `number` string, required: The receipt number.
    - `entryNumber` string, required: All transactions having the same number form one booking
    - `reference` string, required: The reference for the transactions, reservation id for guest folios, folio id for external folios, property code for the house folio
    - `referenceType` 'House' | 'Guest' | 'External' | 'Booking', required: Does this transaction belong to a reservation, a house or an external folio
    - `entryGroupNumber` string, required: All transactions triggered by the same business transaction share one group number
  - `count` integer, required: Total count of items

## Other responses

- `204`: No Content
- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

---

[API](https://skmtc.dev/apaleo/apis/apaleo-finance-api-not-safe-for-work.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-finance-api-not-safe-for-work/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-finance-api-not-safe-for-work/revisions/72cbd31f02f4?raw)