Filter Employees

POST 
/v1/open-api/employee/filter

List the employees of the company the token belongs to — paginated, with optional search and account-status filters. Use it to resolve the selectable values of EMPLOYEE-typed CRM fields (see GET /v1/open-api/crm-field) and to map the responsibleById / createdByIds IDs used across the API.

Only IN_COMPANY employees are returned; the internal Tizim account is excluded. Every body field is optional — {} returns the first page with the default ordering.

Unlike the resource endpoints, this one requires no specific grant — any valid, non-expired token is accepted.

Request

Responses

200

Page of matching employees.

400

Validation error (400). Field-level failures are listed in errors[] and error is null; a malformed / unparsable JSON body is the inverse — error.messageCode is 3705 and errors[] is empty.

401

Invalid, revoked or expired token (401) — also returned when the connection was revoked or the company is blocked.

Produced by the authentication filter, so the body is a reduced envelope: no error, no requestId, and errors is null rather than []. Every cause yields the same fixed English message.

429

Rate limit of 60 requests/minute exceeded (429). Like 401, this comes from the authentication filter: reduced envelope, fixed English message, no error object and no Retry-After header.