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

# Get items

`GET /companies/{companyId}/items`

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

**Scope:** `items:read`

## Query parameters

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

## Response `200`

Items found

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` Item[]
    - union
      - object
        - `id` string, uuid, nullable — Should not be set for new items
        - `description` string, required
        - `itemType` 'salesItem', required
        - `productType` 'goods' | 'services', required
        - `unitType` 'unspecified' | 'piece' | 'hour' | 'day' | 'month' | 'kilogram' | 'gram' | 'liter' | 'meter' | 'centimeter' | 'millimeter' | 'meterSquared' | 'meterCubic' | 'mile' | 'kilometer' | 'gigabyte' | 'hectar' | 'words' | 'year' | 'week' | 'minute' | 'megabyte' | 'ton', required
        - `unitPrice` number, double, required
        - `taxRate` number, double, required
        - `bookkeepingAccountNumber` integer, nullable — The bookkeeping account number for this item. If not set, the account will be automatically selected based on the item productType, taxRate, customer and company settings.
      - object
        - `id` string, uuid, nullable — Should not be set for new items
        - `description` string, required
        - `itemType` 'descriptionOnlyItem', required

---

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