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

# List Projects

`GET /v1/projects`

List projects for the authenticated user with basic information only. Use GET /v1/projects/{projectId} to get full project details.

## Query parameters

- `limit` integer
- `offset` integer
- `status` string

## Response `200`

Projects list response

- ApiResponseProjectsList
  - `success` boolean, required
  - `data` object, nullable
    - `projects` ProjectBasic[], required
      - `_id` string, required
      - `name` string, required
      - `description` string, required
      - `status` 'pending' | 'processing' | 'active' | 'error', required
      - `domain` string
      - `logoUrls` LogoUrls
        - `primary` string, uri
        - `secondary` string, uri
        - `favicon` string, uri
      - `screenshotUrl` string, uri
      - `email_create_suggestions` string[] — AI-generated suggestions for email content creation based on the project context
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `pagination` Pagination, required
      - `total` integer, required
      - `limit` integer, required
      - `offset` integer, required
      - `hasMore` boolean, required
  - `error` string, nullable

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/3f3dba69574b/schema)