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

# Get invoice payments

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

## Request

- Base URL: `https://api.bokio.se/v1`
- URL: `https://api.bokio.se/v1/companies/{companyId}/invoices/{invoiceId}/payments`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `/authorize`
    - Client credentials
    - Token URL: `/token` scopes: `invoices:read`

Retrieves all payment records for the specified invoice.

**Scope:** `invoices:read`

## Query parameters

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

## Response `200`

Payments found

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` InvoicePayment[]
    - `id` string, uuid
    - `invoiceId` string, uuid
    - `date` string, date, required
    - `sumBaseCurrency` number, double, required: The amount of the payment in the base currency. Currently the base currency is always SEK.
    - `bookkeepingAccountNumber` integer, required: The bookkeeping number of the payment account. The value must match a chart of accounts account number that has a payment account details.
    - `journalEntryRef` object, nullable
      - `id` string, uuid

## Other responses

- `404`: Invoice not found

---

[API](https://skmtc.dev/bokio/apis/company-api.md) - [All operations](https://skmtc.dev/bokio/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bokio/apis/company-api/revisions/9395020f3da2?raw)
