Skip to main content
GET
List employees

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

code
integer

Find Employee by code

dni
string

Find Employee by dni

email
string<email>

Find Employee by email

departmentIds
string<uuid>[]

Find Employee by department Ids

officeIds
string<uuid>[]

Find Employee by office Ids

entityGroupIds
string<uuid>[]

Find Employee by entity group Ids

limit
integer

Limit employees

page
integer

Request a specific page

orderBy
string

field1 asc, field2 desc

status
enum<string>

Supported operators: in
Example: status[in]=active,inactive
By default, only active employees are returned

Available options:
active,
inactive
createdAt[gt]
string<date-time>

Only employees created strictly after this moment (exclusive). Accepts ISO 8601 with Z or an offset (e.g. 2026-09-01T10:00:00Z or 2026-09-01T12:00:00%2B02:00, encoding + as %2B), or a date or date-time without zone, which is read as UTC. Compared to the second, as the API returns it; fractions of a second (e.g. .000Z) are accepted and applied exactly. A value that is not a valid date returns 422. Use it with updatedAt for incremental synchronizations.

createdAt[gte]
string<date-time>

Only employees created at or after this moment (inclusive). Accepts ISO 8601 with Z or an offset (e.g. 2026-09-01T10:00:00Z or 2026-09-01T12:00:00%2B02:00, encoding + as %2B), or a date or date-time without zone, which is read as UTC. Compared to the second, as the API returns it; fractions of a second (e.g. .000Z) are accepted and applied exactly. A value that is not a valid date returns 422.

createdAt[lt]
string<date-time>

Only employees created strictly before this moment (exclusive). Accepts ISO 8601 with Z or an offset (e.g. 2026-09-01T10:00:00Z or 2026-09-01T12:00:00%2B02:00, encoding + as %2B), or a date or date-time without zone, which is read as UTC. Compared to the second, as the API returns it; fractions of a second (e.g. .000Z) are accepted and applied exactly. A value that is not a valid date returns 422.

createdAt[lte]
string<date-time>

Only employees created at or before this moment (inclusive). Accepts ISO 8601 with Z or an offset (e.g. 2026-09-01T10:00:00Z or 2026-09-01T12:00:00%2B02:00, encoding + as %2B), or a date or date-time without zone, which is read as UTC. Compared to the second, as the API returns it; fractions of a second (e.g. .000Z) are accepted and applied exactly. A value that is not a valid date returns 422.

updatedAt[gt]
string<date-time>

Only employees last updated strictly after this moment (exclusive). Accepts ISO 8601 with Z or an offset (e.g. 2026-09-01T10:00:00Z or 2026-09-01T12:00:00%2B02:00, encoding + as %2B), or a date or date-time without zone, which is read as UTC. Compared to the second, as the API returns it; fractions of a second (e.g. .000Z) are accepted and applied exactly. A value that is not a valid date returns 422. Note that updatedAt also changes when an employee clocks in, so combine it with createdAt to cover every case.

updatedAt[gte]
string<date-time>

Only employees last updated at or after this moment (inclusive). Accepts ISO 8601 with Z or an offset (e.g. 2026-09-01T10:00:00Z or 2026-09-01T12:00:00%2B02:00, encoding + as %2B), or a date or date-time without zone, which is read as UTC. Compared to the second, as the API returns it; fractions of a second (e.g. .000Z) are accepted and applied exactly. A value that is not a valid date returns 422.

updatedAt[lt]
string<date-time>

Only employees last updated strictly before this moment (exclusive). Accepts ISO 8601 with Z or an offset (e.g. 2026-09-01T10:00:00Z or 2026-09-01T12:00:00%2B02:00, encoding + as %2B), or a date or date-time without zone, which is read as UTC. Compared to the second, as the API returns it; fractions of a second (e.g. .000Z) are accepted and applied exactly. A value that is not a valid date returns 422.

updatedAt[lte]
string<date-time>

Only employees last updated at or before this moment (inclusive). Accepts ISO 8601 with Z or an offset (e.g. 2026-09-01T10:00:00Z or 2026-09-01T12:00:00%2B02:00, encoding + as %2B), or a date or date-time without zone, which is read as UTC. Compared to the second, as the API returns it; fractions of a second (e.g. .000Z) are accepted and applied exactly. A value that is not a valid date returns 422.

Response

200 - application/json

Array of objects

data
object[]
meta
object