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

# Get projects

`GET /api/v1/authenticated/projects`

Returns a list of projects associated with the authenticated user.

## Query parameters

- `include_archived` boolean

## 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

## Changes

- **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/b6d6849481da/schema)