Get a Person

Returns the comprehensive Person payload including display name, slug, headshot, curated bio, the Person’s company-role history (most recent first), known third-party profile links, and an optional knowledge-graph cross-reference. The parameter accepts the Person slug (recommended) or the encoded Person UUID.

GET /v1/people/{id}

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/people/{id}"

200

{
  "id": "<string>",
  "name": "<string>",
  "current_role": {
    "company": {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "domain": "<string>",
      "image_mode": "AUTOMATIC",
      "image_url": "<string>",
      "slug": "<string>",
      "ticker": "<string>"
    },
    "is_current": true,
    "ended_at": "2023-11-07T05:31:56Z",
    "started_at": "2023-11-07T05:31:56Z",
    "title": "<string>"
  },
  "description": "<string>",
  "detailed_description": "<string>",
  "external_links": [
    {
      "platform": {
        "display_name": "<string>",
        "name": "<string>",
        "type": "podcast_directory"
      },
      "attributes": [
        {
          "name": "<string>",
          "value": "<unknown>",
          "category": "<string>",
          "observed_at": "2023-11-07T05:31:56Z"
        }
      ],
      "identifier": "<string>",
      "url": "<string>"
    }
  ],
  "image_url": "<string>",
  "knowledge_graph_entity": {
    "id": "<string>",
    "slug": "<string>",
    "wikipedia_url": "<string>"
  },
  "roles": [
    {
      "company": {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "domain": "<string>",
        "image_mode": "AUTOMATIC",
        "image_url": "<string>",
        "slug": "<string>",
        "ticker": "<string>"
      },
      "is_current": true,
      "ended_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "title": "<string>"
    }
  ],
  "slug": "<string>"
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id · string · required

Person identifier. Accepts the Person slug (recommended) or the encoded Person UUID returned as 'id' on every Person payload.

Response

200

application/json

OK

id · string · required

Encoded Person identifier

name · string · required

Display name

current_role · object

The Person's most recent company role, when known.

Show child attributes

description · string

Short bio (one-liner) curated for the Person.

detailed_description · string

Longer Wikipedia-grounded bio when available.

external_links · object[] | null

Known third-party profiles (LinkedIn, Wikipedia, social). Discovered asynchronously; a freshly-resolved Person may not yet have all platforms populated.

Show child attributes

image_url · string

Canonical headshot URL when one is known for the Person

knowledge_graph_entity · object

Linked knowledge graph entity, when one exists. Secondary identifier — most callers should rely on id/slug.

Show child attributes

roles · object[] | null

All known company roles, ordered most-recent first. Includes the current role at index 0.

Show child attributes

slug · string

Stable human-readable handle (e.g. 'satya-nadella'). Recommended canonical identifier on every Particle Pro person surface.