---
title: "Get allocations for an invoice"
method: GET
path: "/fiscal-document/v1/invoices/{id}/receipts/allocations"
tags: ["Fiscal Documents"]
---

# Get allocations for an invoice

`GET /fiscal-document/v1/invoices/{id}/receipts/allocations`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/fiscal-document/v1/invoices/{id}/receipts/allocations`
- 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 all active allocations for the specified invoice, grouped by transaction ID.
Only includes allocations from receipts with active statuses.

## Path parameters

- `id` string, required

## Headers

- `X-Property-ID` integer, required

## Response `200`

OK

- InvoiceAllocationsResponse
  - `allocations` InvoiceTransactionAllocation[]
    - `transaction_id` integer: Invoice transaction ID that received the allocation
    - `allocated_amount` number: Total amount allocated to this transaction from all receipts

## Other responses

- `400`: Bad Request - Invalid request (document is not an invoice or invalid ID format)
- `404`: Bad Request - Invoice not found

---

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