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

# List projects

`GET /projects`

Fetch a list of projects. Ratelimit: 5 reqs/min, 20 reqs/min if searching.

## Query parameters

- `page` integer
- `limit` integer
- `query` string

## Response `200`

A paginated list of projects

- object
  - `projects` Project[]
    - `id` integer
    - `title` string
    - `description` string
    - `repo_url` string
    - `demo_url` string
    - `readme_url` string
    - `ai_declaration` string
    - `ship_status` string
    - `devlog_ids` integer[]
    - `banner_url` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `pagination` Pagination
    - `current_page` integer
    - `total_pages` integer
    - `total_count` integer
    - `next_page` integer, nullable

## Other responses

- `400` — Invalid request parameters
- `401` — Missing or invalid API key
- `429` — Rate limit exceeded

---

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