---
title: "Get list of transactions for a given fiscal document id"
method: GET
path: "/fiscal-document/v1/fiscal-documents/{id}/transactions"
tags: ["Fiscal Documents"]
---

# Get list of transactions for a given fiscal document id

`GET /fiscal-document/v1/fiscal-documents/{id}/transactions`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/fiscal-document/v1/fiscal-documents/{id}/transactions`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.cloudbeds.com/auth/oauth/authorize`
    - Token URL: `https://api.cloudbeds.com/auth/oauth/token` scopes: `read:reservation`

Retrieves a paginated list of available transactions for fiscal document id.

## Path parameters

- `id` string, required

## Query parameters

- `pageToken` string
- `includeLinkedDocumentTransactions` boolean
- `sort` string
- `limit` integer
- `folioIds` integer[]
- `nestTaxes` boolean
- `currency` string

## Headers

- `X-Property-ID` integer, required

## Response `200`

OK

- FiscalDocumentTransactionsPaginated
  - `transactions` FiscalDocumentTransactionResponse[]
    - `id` string
    - `propertyId` string
    - `sourceId` string
    - `sourceIdentifier` string
    - `sourceKind` 'GROUP_PROFILE' | 'RESERVATION' | 'HOUSE_ACCOUNT' | 'ACCOUNTS_RECEIVABLE_LEDGER': Kind of the source entity
    - `transactionDate` string, date-time
    - `guestName` string
    - `description` string
    - `internalCode` string
    - `amount` number
    - `availableAmount` number
    - `documentFiscalizedAmount` number: Will be null if filter is not by document id
    - `currency` string: Original transaction currency code.
    - `displayCurrency` string: Currency code used for the display amounts in this response.
    - `displayAmount` number: Amount converted to the display currency.
    - `displayAvailableAmount` number: Available amount converted to the display currency.
    - `displayDocumentFiscalizedAmount` number: Document fiscalized amount converted to the display currency. Without a requested currency, set for a document issued in another currency, at the exchange rate locked when it was issued.
    - `folioId` string
    - `status` 'PENDING' | 'POSTED': Status of the transaction - PENDING for unpaid transactions, POSTED for paid transactions
    - `paidAmount` number
    - `allocations` FiscalDocumentTransactionAllocation[]
      - `receiptNumber` string
    - `taxes` FiscalDocumentTransactionResponse[]: Child VAT taxes of this transaction. Populated only when nestTaxes=true; taxes not classified as VAT are never nested here and are returned as top-level transactions instead.
    - `invoicedStatus` 'NOT_INVOICED' | 'PARTIALLY_INVOICED' | 'FULLY_INVOICED'
  - `nextPageToken` string: Token for fetching the next page of results

---

[API](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/revisions/9c2a47775e5e?raw)