Skip to main content
GET
List workers

Authorizations

klef.session
string
cookie
required

Cookie-based session. Obtain by completing the /auth/login/{provider} OAuth flow; the /auth/callback response sets the klef.session cookie that subsequent requests send automatically.

Query Parameters

q
string

Case-insensitive search across name, email, employee id, job, and department.

Required string length: 3 - 100
costCenter
string[]

Filter to workers with an assignment in any of these cost center codes.

department
string[]

Filter to workers with an assignment in any of these department codes.

businessUnit
string[]

Filter to workers with an assignment in any of these business unit codes.

license
string[]

Filter to workers holding any of these licenses, by sku part number.

stage
enum<string>[]

Filter to workers in any of these lifecycle stages.

A stage in a worker's lifecycle that a policy configures behavior for.

Available options:
pre_start,
active,
leave,
suspended,
departing,
terminated
account
enum<string>[]

Filter to workers Klef manages an account for on any of these systems.

An external system a workspace can connect to.

Available options:
adp_workforce_now,
oracle_fusion,
microsoft_entra,
gusto,
microsoft365,
google_workspace,
oracle_oci,
worker_model,
aws,
azure,
aws_identity_center,
bamboo_hr,
slack,
github,
github_enterprise,
salesforce,
hubspot,
box,
linear,
dropbox,
openai,
anthropic,
one_password,
keeper,
bitwarden,
atlassian,
notion
from
string

Filter to workers whose effective hire date is on or after this day.

to
string

Filter to workers whose effective hire date is on or before this day.

sort
enum<string>

Order the results by this column (default: name).

Available options:
name,
start_date
dir
enum<string>

Sort direction for sort (default: ascending).

Available options:
asc,
desc
cursor
integer<int32>
limit
integer<int32>

Response

OK

The envelope for a collection response: IReadOnlyList<T> ApiCollectionResponse<T>.Results.

results
object[]
required
errors
object[]
required
pagination
null | object
required

Cursor-pagination metadata shared across every paged read. int? PageInfo.NextCursor is the offset of the next page, null on the last page.