Get a person

GET /api/v1/people/{id}

Fetch one person by their Homie person id (as returned by the people, warm-paths, or connections endpoints). Only returns people in your organization's network (1st or 2nd degree) — a person outside your network returns 404, so the endpoint never reveals that someone exists outside your graph.

Path parameters

Example

curl -H "Authorization: Bearer $KEY" \"https://app.usehomie.com/api/v1/people/person_..."

Response

{
  "data": {
    "id": "person_...",
    "name": "Alex Johnson",
    "linkedinId": "alexjohnson",
    "position": "VP Engineering",
    "city": "San Francisco",
    "currentCompany": {
      "id": "company_...",
      "name": "Stripe",
      "industry": "Fintech"
    },
    "connectionsCount": 1482,
    "degree": "first",
    "warmness": 84,
    "warmnessBreakdown": { "currentCompanyMatch": 65, "sameCity": 5 },
    "warmnessSignals": ["Working together at Acme", "3 mutual connections"],
    "introRequested": true,
    "introStatus": "ACTIVE",
    "introRequestedBy": "Sarah Chen",
    "introRequestedAt": "2026-09-10T12:00:00.000Z"
  }
}

degree is "first" when someone in your org is directly connected, "second" when reachable via a 2nd-degree edge. warmness, warmnessBreakdown, and warmnessSignals are only present on first-degree connections.

When the organization has already requested an introduction, the response includes introRequested, introStatus, introRequestedBy, and introRequestedAt. These fields are omitted when no request exists. The endpoint returns { "error": "...", "code": "not_found" } with status 404 when the person isn't in your network.