Skip to main content
GET

List time entries for a project

Scope:projects:projects.read
https://api.holded.com/api/v2/projects/{projectId}/times

Returns a paginated list of time tracking entries for a specific project. Results are paginated with `limit` and `cursor` parameters.

Parameters

Path parameters

projectIdstringrequired

Project ID

Query parameters

cursorstringoptional

Pagination cursor returned by the previous response. Omit to start from the first page.

limitintegeroptional= 50

Maximum number of items to return

startDatestring<date>optional

Filter entries on or after this date (ISO 8601, YYYY-MM-DD)

endDatestring<date>optional

Filter entries on or before this date (ISO 8601, YYYY-MM-DD)

Request

python
import requests

url = "https://api.holded.com/api/v2/projects/{projectId}/times?cursor=value&limit=50&startDate=2025-01-01"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

json
{
  "items": [
    {
      "id": "string",
      "project_id": "string",
      "duration": 0,
      "user_name": "string",
      "description": "string",
      "cost_per_hour": "25.00",
      "user_id": "string",
      "task_id": "string",
      "date": "string",
      "approved": false,
      "total_cost": "12.50",
      "category": "string"
    }
  ],
  "has_more": false,
  "cursor": "string"
}

Success responses

200List of project time entriesapplication/json
object
items[]object[]required
idstringrequired

Unique identifier

project_idstringrequired

ID of the project the entry belongs to

durationintegerrequired

Duration in seconds

user_namestringrequired

User display name

descriptionstringrequired

Description

cost_per_hourstring<decimal>required

Cost per hour as a decimal string

user_idstringrequired

User ID

task_idstring | nullrequired

Task ID

datestring | nullrequired

Date, formatted according to the account's date settings

approvedbooleanrequired

Whether the entry is approved

total_coststring<decimal>required

Total cost as a decimal string

categorystringrequired

Category

has_morebooleanrequired

Whether there are more items on the next page

cursorstring | nulloptional

Opaque cursor to pass as ?cursor= to fetch the next page. Null on the last page.

Error responses

400Bad requestapplication/json
401Invalid or missing API keyapplication/json
403Insufficient permissionsapplication/json
404Project not foundapplication/json
429Rate limit exceededapplication/json