---
title: "List Projects"
method: GET
path: "/projects"
tags: ["Projects"]
---

# List Projects

`GET /projects`

## Request

- Base URL: `https://app.lettr.com/api`
- URL: `https://app.lettr.com/api/projects`
- Auth: HTTP bearer

Retrieve a paginated list of projects for the authenticated team.

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

Projects retrieved successfully

- ListProjectsResponse
  - `message` string, required
  - `data` object, required
    - `projects` ProjectView[], required
      - `id` integer, required
      - `name` string, required
      - `emoji` string, nullable
      - `team_id` integer, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `pagination` ProjectsPagination, required
      - `total` integer, required
      - `per_page` integer, required
      - `current_page` integer, required
      - `last_page` integer, required

## Other responses

- `401`: Unauthorized
- `422`: Validation error
- `503`: Service unavailable - the API key could not be verified, so the request was not processed. This does not mean the key is invalid; retry after the delay given in the Retry-After header.

---

[API](https://skmtc.dev/lettr/apis/lettr-api.md) · [All operations](https://skmtc.dev/lettr/apis/lettr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lettr/apis/lettr-api/revisions/48ef0dac1ebd?raw)