---
title: "Get agency connections"
method: GET
path: "/agency-connections"
tags: ["agency-connections"]
---

# Get agency connections

`GET /agency-connections`

## Request

- Base URL: `https://api.bokio.se/v1`
- URL: `https://api.bokio.se/v1/agency-connections`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/authorize`
    - Client credentials
    - Token URL: `/token` scopes: `agency-connections:read`
  - HTTP bearer

Lists active agency connections owned by the authenticated integration.

**Scope:** `agency-connections:read`

## Query parameters

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

## Response `200`

Agency connections

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` AgencyConnection[]
    - `id` string, uuid, required: Informational connection identifier
    - `agencyId` string, uuid, required
    - `agencyName` string, required
    - `organizationNumber` string, nullable
    - `scopes` string[], required
    - `status` 'active' | 'disconnected', required
    - `connectedDatetime` string, date-time, required

---

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