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

# Get supplier invoices

`GET /companies/{companyId}/supplier-invoices`

## Request

- Base URL: `https://api.bokio.se/v1`
- URL: `https://api.bokio.se/v1/companies/{companyId}/supplier-invoices`
- Auth: HTTP bearer

Get all supplier invoices for the company. Use the query parameters to filter and navigate through the results.

**Scope:** `supplier-invoices:read`

## Query parameters

- `page` integer
- `pageSize` integer
- `projectId` string, uuid
- `query` string

## Response `200`

Supplier invoices found

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` SupplierInvoiceGet[]
    - `id` string, uuid
    - `supplierRef` object, required
      - `id` string, uuid, required
      - `name` string
    - `invoiceNumber` string
    - `invoiceDate` string, date, required
    - `dueDate` string, date, required
    - `totalAmount` number, double, required
    - `remainingAmount` number, double
    - `currency` string
    - `currencyRate` number, double
    - `journalEntryRef` object, nullable
      - `id` string, uuid
    - `lineItems` SupplierInvoiceLineItem[]: Line items for the supplier invoice. **Preview:** This field is in preview and may change or be removed before general availability. [Read the full preview policy](/reference/versioning#preview)
      - `id` string, uuid: Server-generated identifier. On update, include `id` to match an existing line item; omit it to add a new line item.
      - `description` string, required
      - `quantity` number, double
      - `unitPrice` number, double, required
      - `unitType` string
      - `taxRate` number, double, nullable
      - `projectRef` ProjectRef, nullable: Reference to a project. **Preview:** This field is in preview and may change or be removed before general availability. [Read the full preview policy](/reference/versioning#preview)
        - `id` string, uuid, nullable
        - `projectName` string
        - `projectNumber` string
      - `costCenterRef` CostCenterRef, nullable: Reference to a cost center tag value. Should be a valid dimension 1 tag value. **Preview:** This field is in preview and may change or be removed before general availability. [Read the full preview policy](/reference/versioning#preview)
        - `tagId` string, uuid, nullable
        - `tagName` string
    - `uploadRefs` UploadRef[]
      - `id` string, uuid: Unique identifier of an existing upload

## Other responses

- `400`: Invalid filter or project identifier

## Changes

- **2026-11-03** `9395020f3da2`: 3 info
  - added the new optional `query` request parameter `projectId`
  - added the non-success response with the status `400`
  - added the optional property `allOf[subschema #2]/items/items/lineItems` to the response with the `200` status

[Operation history](https://skmtc.dev/bokio/apis/company-api/changes/companies/:companyId/supplier-invoices/get.md)

---

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