---
title: "Get invoice settlements"
method: GET
path: "/companies/{companyId}/invoices/{invoiceId}/settlements"
tags: ["invoices"]
---

# Get invoice settlements

`GET /companies/{companyId}/invoices/{invoiceId}/settlements`

Get all settlements for the invoice. Use the query parameters to filter and navigate through the results.

**Scope:** `invoices:read`

## Query parameters

- `page` integer
- `pageSize` integer
- `query` string

## Response `200`

List of settlements

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` InvoiceSettlementRead[]
    - `id` string, uuid — The unique identifier of the settlement
    - `invoiceId` string, uuid — The unique identifier of the invoice this settlement belongs to
    - `type` 'currency' | 'bankFee' | 'badDebt' | 'balanceAdjustment' | 'paymentServiceFee' — The type of the settlement. - Currency adjustments are for changes in exchange rates. Currency gain or currency loss is reflected in `sumBaseCurrency` being positive or negative respectively. - Bank fees are for charges from banks or payment providers. - Bad debts are for uncollectible invoices. - Balance adjustments are for correcting discrepancies on invoices without affecting bookkeeping. - Payment service fees are for charges from payment service providers (e.g. Stripe). Available for Swedish companies only. Supports different VAT schemes for domestic, EU, non-EU, and VAT-exempt transactions.
    - `invoiceSettlementDetails` union — The settlement details specific to the settlement type
      - StandardSettlementDetails
        - `date` string, date, required — The date of the settlement
        - `sumBaseCurrency` number, required — The settlement amount in base currency
      - PaymentServiceFeeSettlementDetails
        - `date` string, date, required — The date of the settlement
        - `sumBaseCurrency` number, required — The settlement amount in base currency. Must be greater than zero.
        - `vatScheme` 'domestic' | 'eu' | 'nonEu' | 'vatExempt', required — The VAT scheme for the payment service fee. Determines how VAT is handled in the bookkeeping. - `domestic` — No reverse charge VAT. The fee is booked as a domestic expense. - `eu` — EU reverse charge. The fee is booked with reverse charge VAT (output VAT on account 2645, input VAT on account 2614). - `nonEu` — Non-EU reverse charge. Same VAT treatment as EU but booked to a different expense account. - `vatExempt` — VAT exempt. The fee is booked as a general administrative expense with no VAT.
    - `journalEntryRef` object, nullable
      - `id` string, uuid

## Other responses

- `404` — The requested resource was not found

---

[API](https://skmtc.net/bokio/apis/company-api.md) · [All operations](https://skmtc.net/bokio/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bokio/company-api/revisions/1bb5d09ce15e/schema)