People

This endpoint lets you find people in a particular organization. When filtering by job function or job level, please use the values from our web application.

Successful calls to this endpoint consume API credits from your account. The number of credits used depends on the number of people found. Each person found costs 1 credit.

Find people at an organization

post

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

organizationany ofRequired

Organization to enrich

or

or

limitinteger · min: 1 · max: 250Optional

Maximum number of people to return

Default: 10

offsetinteger · max: 10000Optional

Number of results to skip

Default: 0

filtersany ofRequired

Filters to apply to the people search. Can be either a Filters object or a Query object.

or

Responses

200

Successful Response

application/json

idstring · uuidRequired

credits_usedintegerRequired

credits_remainingintegerRequired

people_countintegerRequired

people_data_urlstring · uri · min: 1 · max: 2083Required

422

Validation Error

application/json

post

/v3/people/find

HTTPcURLJavaScriptPython

POST /v3/people/find HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 190

{
  "organization": {
    "domain": "sumble.com"
  },
  "filters": {
    "job_functions": [
      "Engineer",
      "Operations"
    ],
    "job_levels": [
      "Individual Contributor"
    ],
    "countries": [
      "US",
      "UY"
    ],
    "since": "2023-10-01"
  },
  "limit": 20
}

Example with filtersExample with advanced query

{
  "id": "019980d2-bc85-7571-9d60-7bc1d3084249",
  "credits_used": 3,
  "credits_remaining": 69164,
  "organization": {
    "id": 1726684,
    "slug": "sumble",
    "name": "Sumble",
    "domain": "sumble.com"
  },
  "people_count": 3,
  "people_data_url": "https://sumble.com/l/org/xhXARFaWtJL/people",
  "people": [
    {
      "id": 181438858,
      "url": "https://sumble.com/l/person/MBwjfWREd8Pz",
      "linkedin_url": "https://www.linkedin.com/in/akashagajjar",
      "name": "Akash Gajjar",
      "job_title": "Software Engineer",
      "job_function": "Software Engineer",
      "job_level": "Individual Contributor",
      "location": "Gainesville, Florida, United States",
      "country": "United States",
      "start_date": "2024-08",
      "country_code": "US"
    },
    {
      "id": 169860318,
      "url": "https://sumble.com/l/person/yxGWeupK3yPj",
      "linkedin_url": "https://www.linkedin.com/in/jared-nightingale",
      "name": "Jared Nightingale",
      "job_title": "Business Operations Specialist",
      "job_function": "Operations",
      "job_level": "Individual Contributor",
      "location": "Phoenix, Arizona, United States",
      "country": "United States",
      "start_date": "2025-06",
      "country_code": "US"
    },
    {
      "id": 71121138,
      "url": "https://sumble.com/l/person/J9uHFZVthyOd",
      "linkedin_url": "https://www.linkedin.com/in/loumanglass",
      "name": "Lou Manglass",
      "job_title": "Back End Engineer",
      "job_function": "Software Engineer",
      "job_level": "Individual Contributor",
      "location": "Athens, Georgia, United States",
      "country": "United States",
      "start_date": "2024-09",
      "country_code": "US"
    }
  ]
}