Companies
tier:standard

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

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/companies/{id}/people
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

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

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

current_onlyboolean

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

titlestring

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

Example:chief
role'marketing' | 'brand' | 'partnerships' | 'media_advertising' | 'communications' | 'growth' | 'executive' | 'other'

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.

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

No recorded changes to this operation across all 2 revisions of this API.