List connections

GET /api/v1/connections

List the authenticated user's own first-degree LinkedIn connections with offset pagination. Unlike the search endpoints, this one is scoped to the token's user personally — it requires a user-scoped MCP token, and organization API keys are rejected with 403.

Query parameters

Example

curl -H "Authorization: Bearer $TOKEN" \"https://app.usehomie.com/api/v1/connections?limit=10"

Response

{
  "data": {
    "connections": [
      {
        "id": "person_...",
        "name": "Alex Johnson",
        "linkedinId": "alexjohnson",
        "position": "VP Engineering",
        "currentCompany": "Stripe"
      }
    ],
    "totalCount": 1482,
    "returnedCount": 10,
    "limit": 10,
    "offset": 0,
    "nextOffset": 10,
    "hasMore": true
  }
}

Each connection has person fields only: id, name, linkedinId, position, currentCompany. Results are ordered by name. Connections whose warmness hasn't been computed yet are included — warmness is enrichment, not a membership filter. When hasMore is false, nextOffset is omitted.