HomeGuidesAPI ReferenceChangelogDiscussions
API Reference
These docs are for v2024-10-01. Click to read the latest docs for v2025-01-01.

Reads all Project workers

What does it do?

This endpoint reads and retrieves a list of project workers. You can utilize URL parameters to filter the results.

Is it related to other entities?

A project_worker is always related to a project and a employee. Only a project worker is able to add time to a project using the time_record entity.

Who can use it?

Only companies who have enabled the projects_management feature and users with the permission to read project workers.

Log in to see full request history
Query Params
ids[]
array of integers

Retrieve only the project workers that matches the ids provided in the request.

ids[]
project_ids[]
array of integers

Retrieve only the project workers that matches the project_ids provided in the request.

project_ids[]
subproject_ids[]
array of integers

Retrieve only the project workers that matches the subproject_ids provided in the request.

subproject_ids[]
boolean

Retrieve the project workers that are not assigned to any subproject (can be combined with subproject_ids).

employee_ids[]
array of integers

Retrieve only the project workers that are related to the employee_ids provided in the request.

employee_ids[]
boolean

Retrieve project workers that are assigned if true or in not-assigned status if false.

boolean

Retrieve the project workers that are assigned to active projects if turew or closed projects if false.

string

Retrieve only the project workers that matches the given employee's name provided in the request.

boolean

If true we will perform the minutes calculations and will be return the total inputed_minutes. If false, 0 will be returned and no minutes calculations will be performed.

boolean
string

Retrieve only the project workers that were created or updated after the date provided in the request.

boolean
Response

Response body
array of objects
object
integer
required

id of the project worker.

integer
required

id of the project.

integer
required

id of the employee.

boolean
required

true if the employee is assigned to the project, false otherwise.

integer

total inmputed minutes of the employee in the project.

integer

total project currency labor cost of the employee in the project.

integer

total spending cost of the employee in the project.

Language
Credentials
URL
Click Try It! to start a request and see the response here! Or choose an example:
application/json