---
title: "Get client companies"
method: GET
path: "/agencies/{agencyId}/companies"
tags: ["agency-companies"]
---

# Get client companies

`GET /agencies/{agencyId}/companies`

## Request

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

Get all client companies connected to the agency. Use the query parameters to filter and navigate through the results.
**Scope:** `agency-companies:read`

## Query parameters

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

## Response `200`

Client companies found

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` AgencyCompanyGetModel[]
    - `id` string, uuid, required: Unique identifier for the company
    - `name` string, required: Name of the company
    - `organizationNumber` string, required: Organization number of the company
    - `vatNumber` string, nullable: VAT number of the company
    - `companyType` 'proprietorship' | 'limitedCompany' | 'limitedPartnership' | 'partnership' | 'cooperative' | 'nonProfitAssociation' | 'communityAssociation' | 'religiousCommunity', required: Company type of the company
    - `address` Address
      - `line1` string
      - `line2` string, nullable
      - `city` string
      - `postalCode` string
      - `country` string, country: ISO 3166-1 alpha-2 country code

## Other responses

- `404`: Agency not found

---

[API](https://skmtc.dev/bokio/apis/agency-api.md) - [All operations](https://skmtc.dev/bokio/apis/agency-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bokio/apis/agency-api/revisions/2ec5b299f1d5?raw)