Skip to main content
GET
/
v1
/
companies
/
{id}
/
people
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/companies/{id}/people?limit=25&current_only=true"
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "current_role": {
        "company": {
          "id": "<string>",
          "name": "<string>",
          "image_url": "<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>"
          },
          "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>",
            "image_url": "<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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.particle.pro/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
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"

Response

OK

​
data
object[] | null
required

List of results

​
has_more
boolean
required

Whether more results exist

​
cursor
string

Pass to next request for more results