List company people

Returns a paginated list of people associated with a company (executives and other known roles), current roles first and most-recently-joined first. Each person carries the full Person payload — bio, role history, external profile links, and knowledge-graph cross-reference. Set current_only=false to include historical roles, or filter by role title. Identify the company by slug (e.g., ‘apple’), domain, or ID.

GET /v1/companies/{id}/people

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/companies/{id}/people?limit=25&current_only=true"

200

{
  "data": [
    {
      "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>"
    }
  ],
  "has_more": true,
  "cursor": "<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

Company slug (e.g., 'apple'), domain (e.g., 'apple.com'), or ID

Query Parameters

limit · integer<int64> · default: 25

Results per page

Required range: 1 <= x <= 100

cursor · string

Opaque pagination cursor from previous response

current_only · boolean · default: true

When true (default), only people currently in a role at the company. Set false to include historical roles.

title · string

Case-insensitive substring filter on role title (e.g. 'chief', 'founder').

Example:

"chief"

role · enum<string>

Only people whose role title falls in this contact role class: current roles by default, historical roles too when current_only=false. The classes are the ones a podcast pitching sponsorship would reach (marketing, partnerships, brand, media and advertising, communications, growth, executive); other is a title that matches none of them. Combines with title.

Available options: marketing, brand, partnerships, media_advertising, communications, growth, executive, other

Response

200

application/json

OK

data · object[] | null · required

List of results

Show child attributes

has_more · boolean · required

Whether more results exist

cursor · string

Pass to next request for more results