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

# Get a supplier

`GET /companies/{companyId}/suppliers/{supplierId}`

## Request

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

Retrieve the information of the supplier with the matching supplierId.

**Scope:** `suppliers:read`

## Response `200`

Supplier found

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

## Other responses

- `404`: Supplier 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)