---
title: "Get projects"
method: GET
path: "/api/v1/authenticated/projects"
tags: ["OAuth2-specific"]
---

# Get projects

`GET /api/v1/authenticated/projects`

Returns a list of projects associated with the authenticated user. Requires an OAuth2 access token with the `read` scope in the Bearer header.

## Query parameters

- `include_archived` boolean
- `projects` string
- `since` string, date_time
- `until` string, date_time
- `until_date` string, date_time
- `start` string, date_time
- `end` string, date_time
- `start_date` string, date_time
- `end_date` string, date_time

## Response `200`

successful

- object
  - `projects` object[]
    - `name` string
    - `total_seconds` number
    - `most_recent_heartbeat` string, date_time, nullable
    - `languages` string[]
    - `archived` boolean

## Other responses

- `401` — unauthorized — Returned when the OAuth access token is missing or invalid.
- `403` — insufficient scope

## Changes

> 27 revisions in range; 2 could not be searched.

- **2026-06-07** (v1) `10d87f00ef0b` — 4 info
  - the endpoint scheme security `Bearer` was added to the API
  - the endpoint scheme security `Bearer AND ApiKeyAuth` was removed from the API
  - api tag `OAuth2-specific` added
  - api tag `Authenticated` removed
- **2026-02-15** (v1) `a71a54c28264` — 8 info
  - added the new optional `query` request parameter `end`
  - added the new optional `query` request parameter `end_date`
  - added the new optional `query` request parameter `projects`
  - added the new optional `query` request parameter `since`
  - …4 more
- **2026-01-27** (v1) `b6d6849481da` — 8 warning, 4 info
  - deleted the `query` request parameter `end`
  - deleted the `query` request parameter `end_date`
  - deleted the `query` request parameter `projects`
  - deleted the `query` request parameter `since`
  - …8 more

[Change history](https://skmtc.dev/hackclub/apis/hackatime-api/changes/api/v1/authenticated/projects/get.md)

---

[API](https://skmtc.dev/hackclub/apis/hackatime-api.md) · [All operations](https://skmtc.dev/hackclub/apis/hackatime-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hackclub/hackatime-api/revisions/172c35ec816f/schema)