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

# Get customers

`GET /companies/{companyId}/customers`

## Request

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

Get all customers for the company. Use the query parameters to filter and navigate through the results. Customers are returned in descending customer-number order: alphanumeric values first, followed by purely numeric values in descending numeric order.
**Scope:** `customers:read`

## Query parameters

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

## Response `200`

Customers found

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` Customer[]
    - `id` string, uuid
    - `name` string, required
    - `customerNumber` string, nullable: Customer number. On create, omitting this field or setting it to null automatically suggests the next numeric value. On update, omitting this field or setting it to null preserves the existing value. Supplied values are preserved exactly.
    - `type` 'company' | 'private', required
    - `vatNumber` string
    - `orgNumber` string
    - `paymentTerms` string: Payment terms for the invoices. Payment terms can both take free text or days, in digits, until the payment is due. On the invoice, if a digit is provided it will be suffixed with "days". For example, "30" will be displayed as "30 days" on the invoice. Note that the suffix will, similar to the rest of the invoice, use the language on the customer.
    - `contactsDetails` object[]
      - `id` string, uuid, nullable: Should not be set for new items
      - `name` string
      - `email` string
      - `phone` string
      - `isDefault` boolean
    - `address` AddressWithCountrySubdivision
      - `line1` string, required
      - `line2` string, nullable
      - `city` string, required
      - `postalCode` string, required
      - `country` string, country, required: ISO 3166-1 alpha-2 country code
      - `countrySubdivision` string, nullable: ISO 3166-2 subdivision code (e.g. ENG, SCT, WLS, NIR for GB). Currently required for GB (United kingdom) country.
    - `language` 'sv' | 'en': Default 'sv'
    - `constructionReverseChargeEnabled` boolean: Whether invoices for this customer may use construction reverse charge. This can only be enabled when the customer is a Swedish company. Defaults to false.
    - `modifiedDateTime` string, date-time, nullable: The date and time the customer was last modified. Returns null for customers that were changed before this field was introduced.

## Changes

- **2026-11-03** `9395020f3da2`: 2 info
  - added the optional property `allOf[subschema #2]/items/items/constructionReverseChargeEnabled` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/items/items/customerNumber` to the response with the `200` status

[Operation history](https://skmtc.dev/bokio/apis/company-api/changes/companies/:companyId/customers/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)