---
title: "Get Billing Document Breakdown"
method: GET
path: "/v1/billing-documents/{billing_document_id}/breakdown"
tags: ["Billing Documents"]
---

# Get Billing Document Breakdown

`GET /v1/billing-documents/{billing_document_id}/breakdown`

Get billing document breakdown

## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage invoices (`invoices`) | View invoices (`invoices:read`) | Manage invoices (`invoices:write`) |

## Path parameters

- `billing_document_id` string, required

## Query parameters

- `type` string

## Response `200`

Success

- BillingDocumentBreakdownResponse — Information about a billing document breakdown
  - `data` object, required
    - `billing_document_breakdown` BillingDocumentBreakdownItem[], required
      - `country_code` string, required — Country code according to ISO 3166-1 3-digit alphabetic codes.
      - `description` string, required — A human-readable description of this cost item.
      - `employment_id` string, uuid, required — Identifier of the employment being terminated.
      - `fx_rate` string, required — The foreign exchange rate applied to convert from the source currency to the invoice currency.
      - `invoice_amount` integer, required — Invoice amount in cents
      - `invoice_currency` string, nullable, required — Currency code of the SWIFT fee. Only present when processing_fee is set.
      - `invoice_number` string, required — The invoice number associated with this breakdown item.
      - `invoice_period` string, required — The invoice period in YYYY-MM format.
      - `source_amount` integer, required — Source amount in cents
      - `source_currency` string, nullable, required — Currency code of the SWIFT fee. Only present when processing_fee is set.
      - `type` string, required — The cost category (e.g., "Base Salary", "Employer Contributions", "Benefits").
      - `variance_from_invoice` string, nullable, required — A human-readable note about any variance between the breakdown amount and the invoiced amount, typically due to FX rounding.
      - `variance_from_invoice_amount` integer, nullable, required — Variance from invoice amount in cents

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Unprocessable Entity

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)