---
title: "Get available transactions for fiscal documents"
method: GET
path: "/fiscal-document/v1/fiscal-documents/transactions"
tags: ["Fiscal Documents"]
---

# Get available transactions for fiscal documents

`GET /fiscal-document/v1/fiscal-documents/transactions`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/fiscal-document/v1/fiscal-documents/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 a source based on the document type.
- For INVOICE: Returns posted (paid) transactions, and pending transactions when feature.fiscal-document.pending-transactions is enabled
- For CREDIT_NOTE: Returns posted (paid) transactions, and pending transactions when feature.fiscal-document.pending-transactions is enabled
- For PRO_FORMA_INVOICE: Returns both pending transactions and posted (paid) payments
- Transactions already included in fiscal documents are excluded unless show_invoiced=true
- Each transaction includes a status field (PENDING or POSTED)

## Query parameters

- `forDocumentType` 'INVOICE' | 'CREDIT_NOTE' | 'RECEIPT' | 'RECTIFY_INVOICE' | 'PRO_FORMA_INVOICE' | 'REFUND_RECEIPT' | 'INVOICE_RECEIPT' | 'ADVANCE_INVOICE' | 'SETTLEMENT_INVOICE' | 'TAX_WITHHOLDING': Kind of fiscal document
- `documentKind` 'INVOICE' | 'CREDIT_NOTE' | 'RECEIPT' | 'RECTIFY_INVOICE' | 'PRO_FORMA_INVOICE' | 'REFUND_RECEIPT' | 'INVOICE_RECEIPT' | 'ADVANCE_INVOICE' | 'SETTLEMENT_INVOICE' | 'TAX_WITHHOLDING': Kind of fiscal document
- `pageToken` string
- `limit` integer
- `sourceId` integer, required
- `sort` string
- `sourceKind` 'GROUP_PROFILE' | 'RESERVATION' | 'HOUSE_ACCOUNT' | 'ACCOUNTS_RECEIVABLE_LEDGER', required: Kind of the source entity
- `folioIds` integer[]
- `nestTaxes` boolean
- `showInvoiced` 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

## Other responses

- `409`: The source's transactions are being reconciled, or pending transaction discrepancies were found. The list is not safe to act on yet — retry the request.

---

[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)