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

# List connections

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

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

## Headers

- `Authorization` string, required

## Response `200`

connections found

- TypeConnectionsGetV1BusinessesBusinessIdConnectionsResponse
  - `object` string, required
  - `data` TypeConnection[], required
    - `object` string, required
    - `id` string, uuid, required
    - `name` string, required
    - `confidence` number, double, required
    - `connected_business_id` string, uuid, nullable
    - `connecting_people` TypeConnectionConnectingPeopleItem[], required
      - `name` string
      - `titles` string[]
      - `sources` TypeSource[]
        - `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` TypeConnectionConnectingAddressesItem[], required
      - `full_address` string
      - `labels` string[]
      - `sources` TypeSource[]
        - `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` TypeConnectionConnectingBusinessesItem[], required
      - `name` string
      - `titles` string[]
      - `sources` TypeSource[]
        - `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

---

[API](https://skmtc.net/middesk/apis/middesk-api.md) · [All operations](https://skmtc.net/middesk/apis/middesk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/middesk/middesk-api/revisions/9882e52b445b/schema)