List connections
API reference for GET /api/v1/connections: list the authenticated user's first-degree LinkedIn connections with offset pagination.
GET /api/v1/connectionsList 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
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | no | 1-50, default 20. |
offset | number | no | 0-based offset. Pass the previous response's nextOffset to fetch the next page. |
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.
Search warm paths
API reference for GET /api/v1/search/warm-paths: find warm intro paths from anyone in your organization to a person or a company.
List second-degree connections
API reference for listing second-degree connections: people your first-degree contacts know, with the connector who could introduce you.