List departments

Departments are the organizational units jobs are assigned to (e.g. Engineering, Marketing). Each organization maintains its own department tree, with parent_id linking a department to its immediate parent and null marking top-level departments. Use this endpoint to discover department ids and external_id mappings before referencing them on jobs, candidate filters, or custom field scoping.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

integer
1 to 500
Defaults to 100

Number of results per page

ids
array of integers
length ≤ 50

Comma separated list

ids
created_at
object
updated_at
object
fields
array of strings
length ≤ 50

Comma separated list of fields to return

fields
Allowed:
integer

Return only departments whose immediate parent is this department id. Omit to list every department regardless of position in the tree.

string

Return only the department whose external_id matches this value exactly. Useful for reconciling departments against an HRIS or other external system without an extra name lookup.

Response

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json