---
title: "List projects"
method: GET
path: "/projects"
---

# List projects

`GET /projects`

## Request

- Base URL: `https://api-postcards.designmodo.com/api/v1`
- URL: `https://api-postcards.designmodo.com/api/v1/projects`
- Auth: HTTP bearer

## Query parameters

- `page` integer
- `per_page` integer
- `folder_id` string

## Response `200`

A page of projects.

- ProjectList
  - `data` Project[]
  - `meta` PageMeta
    - `page` integer
    - `per_page` integer
    - `total` integer
    - `total_pages` integer

## Other responses

- `401`: Missing or invalid API key.
- `429`: Rate limit reached: 60 read requests per minute per key.

---

[API](https://skmtc.dev/designmodo/apis/postcards-api.md) - [All operations](https://skmtc.dev/designmodo/apis/postcards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/designmodo/apis/postcards-api/revisions/6690712e9f37?raw)