List time entries for a project
projects:projects.readhttps://api.holded.com/api/v2/projects/{projectId}/timesReturns a paginated list of time tracking entries for a specific project. Results are paginated with `limit` and `cursor` parameters.
Parameters
Path parameters
stringrequiredProject ID
Query parameters
stringoptionalPagination cursor returned by the previous response. Omit to start from the first page.
integeroptional= 50Maximum number of items to return
string<date>optionalFilter entries on or after this date (ISO 8601, YYYY-MM-DD)
string<date>optionalFilter entries on or before this date (ISO 8601, YYYY-MM-DD)
Request
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
{
"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/jsonUnique identifier
ID of the project the entry belongs to
Duration in seconds
User display name
Description
Cost per hour as a decimal string
User ID
Task ID
Date, formatted according to the account's date settings
Whether the entry is approved
Total cost as a decimal string
Category
Whether there are more items on the next page
Opaque cursor to pass as ?cursor= to fetch the next page. Null on the last page.
Error responses
400Bad requestapplication/json401Invalid or missing API keyapplication/json403Insufficient permissionsapplication/json404Project not foundapplication/json429Rate limit exceededapplication/json