---
title: "List connections"
method: GET
path: "/v1/businesses/{business_id}/connections"
tags: ["connections"]
---

# List connections

`GET /v1/businesses/{business_id}/connections`

## Request

- Base URL: `https://api.middesk.com`
- URL: `https://api.middesk.com/v1/businesses/{business_id}/connections`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/middesk/apis/middesk-api/docs/v1/businesses/:business_id/connections/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns businesses connected to the specified business, ordered by confidence score. Each connection includes connecting people, addresses, and businesses that link them. Results are paginated.

## Path parameters

- `business_id` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

connections found

- ConnectionsGetV1BusinessesBusinessIdConnectionsResponse
  - `object` string, required
  - `data` Connection[], required
    - `object` string, required
    - `id` string, uuid, required
    - `name` string, required
    - `confidence` string, required
    - `connected_business_id` string, uuid, nullable
    - `connecting_people` ConnectionConnectingPeopleItem[], required
      - `name` string
      - `titles` string[]
      - `sources` Source[]
        - `id` string, uuid, required
        - `type` string, required: Origin of the resource. `risk_analysis` indicates the resource was discovered by a Risk order; for such sources, `id` is the originating risk_assessment ID.
        - `metadata` object, required
    - `connecting_addresses` ConnectionConnectingAddressesItem[], required
      - `full_address` string
      - `labels` string[]
      - `sources` Source[]
        - `id` string, uuid, required
        - `type` string, required: Origin of the resource. `risk_analysis` indicates the resource was discovered by a Risk order; for such sources, `id` is the originating risk_assessment ID.
        - `metadata` object, required
    - `connecting_businesses` ConnectionConnectingBusinessesItem[], required
      - `name` string
      - `titles` string[]
      - `sources` Source[]
        - `id` string, uuid, required
        - `type` string, required: Origin of the resource. `risk_analysis` indicates the resource was discovered by a Risk order; for such sources, `id` is the originating risk_assessment ID.
        - `metadata` object, required
  - `url` string
  - `has_more` boolean
  - `total_count` integer

## Other responses

- `403`: feature not enabled for account

## Changes

- **2026-10-20** `410a449f7a40`: 1 breaking
  - the `data/items/confidence` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
- **2026-09-17** `4c9cd4e834ba`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `bearer_auth` was added to the API
- **2026-09-12** `668373c892ce`: 1 info
  - api operation id `listConnections` removed and replaced with `connections_listConnections`
- **2026-09-03** `ac0d9be94846`: 1 info
  - added the optional property `errors/items/parameter` to the response with the `403` status

[Operation history](https://skmtc.dev/middesk/apis/middesk-api/changes/v1/businesses/:business_id/connections/get.md)

---

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