---
title: "Get a person by id"
method: GET
path: "/api/v1/people/{id}"
tags: ["Network"]
---

# Get a person by id

`GET /api/v1/people/{id}`

## Request

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

Fetch one person's profile, current company, network size, and the organization's warmness to them. Only returns people in the organization's network (1st or 2nd degree); 404 otherwise.

## Path parameters

- `id` string, required

## Response `200`

The person

- object
  - `data` PersonDetail, required
    - `id` string, required
    - `name` string, required
    - `linkedinId` string
    - `position` string
    - `email` string
    - `city` string
    - `country` string
    - `avatarUrl` string
    - `currentCompany` object
      - `id` string, required
      - `name` string, required
      - `industry` string
      - `logoUrl` string
    - `connectionsCount` number
    - `followersCount` number
    - `degree` 'first' | 'second', required
    - `warmness` number
    - `warmnessBreakdown` object: Free-form map of warmness factor names to values
    - `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

## Other responses

- `401`: Unauthorized
- `403`: Plan required or insufficient scope
- `404`: Person not found in the 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)