v23

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-0127977.1 KB
OAuth2-specific

Get projects

Returns a list of projects associated with the authenticated user. Requires an OAuth2 access token (Bearer header).

get/api/v1/authenticated/projects

Query parameters

include_archivedboolean

Include archived projects (true/false)

projectsstring

Comma-separated list of project names

sincestring date_time

Project discovery start time (ISO 8601)

untilstring date_time

Project discovery end time (ISO 8601)

until_datestring date_time

Alias for until

startstring date_time

Stats start time (ISO 8601)

endstring date_time

Stats end time (ISO 8601)

start_datestring date_time

Alias for start

end_datestring date_time

Alias for end

Response

successful

Example response

{
  "projects": [
    {
      "name": "hackatime",
      "total_seconds": 3600,
      "most_recent_heartbeat": "2024-03-20T15:30:00Z",
      "languages": [
        "Ruby"
      ]
    }
  ]
}