---
title: "Get an agency connection"
method: GET
path: "/agency-connections/{agencyId}"
tags: ["agency-connections"]
---

# Get an agency connection

`GET /agency-connections/{agencyId}`

## Request

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

Gets this integration's active connection to the agency.

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

## Response `200`

Agency connection

- 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

## Other responses

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