Search people by taxonomy - Arxena Documentation

Find people at a company by standardized function and grade — useful when you already know the taxonomy filters you want.

The strategy

Inspect which data sources are enabled for your workspace
Resolve function and grade values from the taxonomy endpoints (or use known values)
Search with POST /people-api/people/search using dataSource: "index"

How to run it

1. Check enabled sources

curl -H 'Authorization: Bearer YOUR_API_KEY_TOKEN' \
  https://app.arxena.com/people-api/data-sources

Confirm index has "configured": true before searching with taxonomy filters.

2. Browse taxonomy (optional)

curl -H 'Authorization: Bearer YOUR_API_KEY_TOKEN' \
  'https://app.arxena.com/people-api/taxonomy/functions?function_root=engineering'

curl -H 'Authorization: Bearer YOUR_API_KEY_TOKEN' \
  'https://app.arxena.com/people-api/taxonomy/grades?grade_level=leadership'

3. Search

curl -X POST \
  -H 'Authorization: Bearer YOUR_API_KEY_TOKEN' \
  -H 'Content-Type: application/json' \
  https://app.arxena.com/people-api/people/search \
  -d '{
    "dataSource": "index",
    "companyName": "Stripe",
    "stdFunction": "engineering",
    "stdGrade": "leadership",
    "country": "United States",
    "limit": 20,
    "offset": 0
  }'

Try the same request in the interactive playground: Search people.

Expand titles then search — when you start from a natural-language job title
Authentication

​The strategy

​How to run it

​1. Check enabled sources

​2. Browse taxonomy (optional)

​3. Search

​Related

The strategy

How to run it

1. Check enabled sources

2. Browse taxonomy (optional)

3. Search

Related