---
title: "List a person's network"
method: GET
path: "/api/v1/people/network"
tags: ["Network"]
---

# List a person's network

`GET /api/v1/people/network`

## Request

- Base URL: `https://app.usehomie.com`
- URL: `https://app.usehomie.com/api/v1/people/network`
- Auth: HTTP bearer

The people a given person is connected to, warmest first: 'who does this person know'. Identify them with `name` (fuzzy), `linkedinId`, or `personId`. The subject must be in the organization's network (a member, or someone a member is directly connected to); 403 otherwise. Always read `coverage` before describing the result: 'synced' means their own connections were imported, 'derived' means only the slice observed through the people around them, and 'none' means their network is not mapped, so an empty list there never means they know nobody. People the organization has already requested an intro to are excluded and counted in `excludedIntroRequested` unless includeIntroRequested is true.

## Query parameters

- `personId` string: Homie person id
- `linkedinId` string: LinkedIn handle/id
- `name` string: Person's name, fuzzy-matched. Best-connected match wins a tie.
- `limit` integer
- `offset` integer, nullable
- `includeIntroRequested` 'true' | 'false': Default false. Include people the org already asked for an intro to, annotated.

## Response `200`

Paginated slice of the person's network

- object
  - `data` PersonNetworkResult, required
    - `person` object, required
      - `id` string, required
      - `name` string, required
      - `linkedinId` string
      - `position` string
      - `currentCompany` string
    - `connections` object[], required
      - `id` string, required
      - `name` string, required
      - `linkedinId` string
      - `position` string
      - `currentCompany` string
      - `city` string
      - `country` string
      - `warmness` number
      - `warmnessSignals` string[]
      - `introRequested` boolean: True when someone in the organization has already requested an intro to this person
      - `introStatus` string: IntroStatus of that request: ACTIVE, WON, LOST, or NOT_TRACKABLE
      - `introRequestedBy` string: Org member who asked
      - `introRequestedAt` string
    - `totalCount` number, required
    - `returnedCount` number, required
    - `limit` number, required
    - `offset` number, required
    - `nextOffset` number
    - `hasMore` boolean, required
    - `excludedIntroRequested` number, required: How many people were withheld because an intro was already requested
    - `coverage` 'synced' | 'derived' | 'none', required: How complete this network is in Homie. 'synced' = the person is a Homie user whose own connections were imported, so this is their network. 'derived' = their connections are known indirectly, through the people around them, so this is the observed slice rather than the whole network. 'none' = Homie has no connections for them at all, so an empty list means 'not mapped', never 'they know nobody'.

## Other responses

- `400`: No identifier given, or no matching person
- `401`: Unauthorized
- `403`: Plan required, or the person is outside the organization's network

---

[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)