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

# [Preview] Get suppliers

`GET /companies/{companyId}/suppliers`

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

**Scope:** `suppliers:read`

## Query parameters

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

## Response `200`

Suppliers found

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` Supplier[]
    - `id` string, uuid
    - `name` string, required
    - `orgNumber` string
    - `vatNumber` string
    - `currency` string — ISO 4217 currency code. Defaults to SEK if not provided. Sets the currency for the supplier, which determines the currency used when creating supplier invoices. When a non-SEK currency is set, exchange rates are automatically calculated to determine the correct SEK amount — no manual exchange rate lookup is needed. Allowed values depend on whether the company has a Bokio Business Account (BBA): **With Bokio Business Account:** `SEK`, `EUR`, `NOK`, `USD`, `DKK`, `GBP`, `PLN`, `RON`, `CZK`, `HUF`, `ISK`, `CHF` Note: For companies with a Bokio Business Account, only currencies supported by BBA are available. For supplier invoices that cannot be paid via BBA, the currency must be set to `SEK` and exchange rates must be handled manually. **Without Bokio Business Account:** `SEK`, `GBP`, `EUR`, `USD`, `NOK`, `DKK`, `AUD`, `BRL`, `CAD`, `CHF`, `CNY`, `CZK`, `HKD`, `HUF`, `IDR`, `INR`, `ISK`, `JPY`, `KRW`, `MAD`, `MXN`, `NZD`, `PLN`, `RUB`, `SAR`, `SGD`, `THB`, `TRY`, `ZAR`
    - `address` SupplierAddress
      - `line1` string
      - `line2` string, nullable
      - `city` string
      - `postalCode` string
      - `country` string, country — ISO 3166-1 alpha-2 country code. Defaults to SE if not provided.
    - `paymentDetails` union
      - object
        - `type` 'bankgiro', required
        - `bankgiroNumber` string, required — The bankgiro number for the supplier
      - object
        - `type` 'plusgiro', required
        - `plusgiroNumber` string, required — The plusgiro number for the supplier
      - object
        - `type` 'transfer', required
        - `clearingNumber` string, required — Bank clearing number
        - `accountNumber` string, required — Bank account number
      - object
        - `type` 'internationalPayment', required
        - `iban` string, required — International Bank Account Number
        - `bic` string, required — Bank Identifier Code (SWIFT code)

---

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