---
title: "Get a carrier's relationship graph"
method: GET
path: "/v1/carriers/{dot_number}/connections"
---

# Get a carrier's relationship graph

`GET /v1/carriers/{dot_number}/connections`

Retrieve a carrier's corporate connections graph — shared officers, addresses, phones, emails, and equipment linking it to other carriers.

## Path parameters

- `dot_number` string, required

## Query parameters

- `limit` integer

## Response `200`

Connection graph nodes and edges

- ConnectionsResponse
  - `dot_number` string
  - `total_nodes` integer
  - `total_edges` integer
  - `nodes` ConnectionNode[]
    - `id` string — DOT number
    - `label` string
    - `state` string, nullable
    - `city` string, nullable
    - `isFocal` boolean — True for the queried carrier
  - `edges` ConnectionEdge[]
    - `source` string
    - `target` string
    - `connectionType` string — shared_officer, shared_address, shared_phone, shared_email, shared_truck, shared_trailer, shared_surname
    - `sharedCount` integer

## Other responses

- `401` — Invalid or missing API key
- `404` — Carrier does not exist
- `429` — Too many requests. Check X-RateLimit-Remaining and Retry-After headers.

---

[API](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api.md) · [All operations](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runalphaloops/alphaloops-fmcsa-carrier-data-api/versions/dcfdb73e5778/schema)