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

# List Projects

`GET /api/v1/projects/`

List the current user's projects with pagination, status filter, search, and sorting.

## Query parameters

- `status` string, nullable — Filter by project status
- `search` string, nullable — Search by project name or description
- `sort_by` 'created_at' | 'updated_at' | 'name' | 'status' | 'priority' | 'target_delivery_date' — Sort field
- `sort_order` 'asc' | 'desc' — Sort order
- `offset` integer
- `limit` integer

## Response `200`

Successful Response

- PaginatedResponseProjectResponse
  - `items` ProjectResponse[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable
    - `notes` string, nullable
    - `status` string, required
    - `priority` string, required
    - `target_delivery_date` string, date, nullable
    - `shipping_address_id` string, uuid, nullable
    - `user_id` string, uuid, required
    - `part_count` integer, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `submitted_at` string, date-time, nullable
    - `order_placed_at` string, date-time, nullable
    - `expected_delivery_date_min` string, date, nullable
    - `expected_delivery_date_max` string, date, nullable
  - `total` integer, required
  - `offset` integer, required
  - `limit` integer, required
  - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

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