List a company's people

Lists the people who work at one company, narrowed by people filters such as seniority or department when you send them. Send company as POST /v1/companies/resolve takes it.

For the next page, send the same company and filters with the page’s pagination.nextCursor as cursor. A company nothing matches answers status not_found, with no people, and costs nothing.

Price: $0.0001 per person returned. Before the search runs, limit times $0.0001 is held from your balance, and what the page does not use is released. A page with nothing on it costs nothing. Scope: search. Read-only keys may call it.

POST /v1/companies/people

List a company's people

cURL

curl --request POST \
  --url https://api.outbound.dev/v1/companies/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company": {
    "domain": "maersk.com"
  }
}
'

200

{
  "status": "found",
  "company": {
    "name": "A.P. Moller - Maersk",
    "domain": "maersk.com",
    "linkedinUrl": "linkedin.com/company/maersk-group",
    "logoUrl": "https://logo.example/maersk.com.png"
  },
  "data": [
    {
      "linkedinMemberId": "ACoAAB2cdEF",
      "linkedin_url": "linkedin.com/in/ana-ruiz-ops",
      "full_name": "Ana Ruiz",
      "first_name": "Ana",
      "last_name": "Ruiz",
      "job_title": "Director of Operations",
      "job_title_levels": [
        "director"
      ],
      "job_title_role": "operations",
      "job_company_name": "A.P. Moller - Maersk",
      "job_company_website": "maersk.com",
      "job_company_linkedin_url": "linkedin.com/company/halden-freight",
      "job_company_employee_count": 240,
      "location_name": "lisbon, lisbon, portugal"
    }
  ],
  "pagination": {
    "nextCursor": "c2Nyb2xsXzI",
    "total": 2737
  }
}

Authorizations

Authorization · string · header · required

An API key from the console, starting ob_live_, sent as Authorization: Bearer <key>.

Body

application/json

company · object · required

The company, as POST /v1/companies/resolve takes it. Only the most precise of the values sent is looked up.

Show child attributes

filters · object

People filters to narrow the company's people, such as seniority or department, from GET /v1/people/filters.

Show child attributes

Example:

{ "job_title_levels": ["director"] }

limit · integer · default: 10

People per page, up to 25. The page's most possible cost, limit times $0.0001, is held from your balance first.

Required range: 1 <= x <= 25

cursor · string

The pagination.nextCursor of the page before. Send it with the same search, as the filters the first page answered with.

Required string length: 1 - 4096

Response

200

application/json

One page of the company's people.

status · enum<string> · required

not_found when nothing matches the company: no people, nothing charged.

Available options: found, not_found

company · object | null · required

The company, each field null when unknown. Null when nothing matches.

Show child attributes

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes