---
title: "List second-degree connections"
method: GET
path: "/api/v1/connections/second-degree"
tags: ["Network"]
---

# List second-degree connections

`GET /api/v1/connections/second-degree`

## Request

- Base URL: `https://app.usehomie.com`
- URL: `https://app.usehomie.com/api/v1/connections/second-degree`
- Auth: HTTP bearer

People connected to one of the authenticated user's first-degree contacts, whom they don't know directly. Requires a user-scoped MCP token; organization API keys are rejected with 403. Coverage is bounded to the warmest first-degree contacts unless viaConnectorId is given — see `capped` and `scannedBridges`.

## Query parameters

- `limit` integer
- `offset` integer, nullable
- `viaConnectorId` string: Only list people reachable through this first-degree contact

## Response `200`

Paginated list of second-degree connections

- object
  - `data` SecondDegreeConnectionsResult, required
    - `connections` object[], required
      - `id` string, required
      - `name` string, required
      - `linkedinId` string
      - `position` string
      - `currentCompany` string
      - `warmness` number
      - `viaConnector` object, required
        - `id` string, required
        - `name` string, required
    - `totalCount` number, required: Distinct people within the scanned window, not the whole network
    - `returnedCount` number, required
    - `limit` number, required
    - `offset` number, required
    - `nextOffset` number
    - `hasMore` boolean, required
    - `scannedBridges` number, required: How many first-degree contacts were scanned
    - `capped` boolean, required: True when the scan hit its cap, so more of the network exists

## Other responses

- `401`: Unauthorized
- `403`: Plan required or org-scoped API key

---

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