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

# List all projects

`GET /v1/projects`

Returns a list of all projects you've previously created.

## Response `200`

- V1ProjectWithDatabaseResponse[]
  - `id` string, required — Deprecated: Use `ref` instead.
  - `ref` string, required — Project ref
  - `organization_id` string, required — Deprecated: Use `organization_slug` instead.
  - `organization_slug` string, required — Organization slug
  - `name` string, required — Name of your project
  - `region` string, required — Region of your project
  - `created_at` string, required — Creation timestamp
  - `status` 'INACTIVE' | 'ACTIVE_HEALTHY' | 'ACTIVE_UNHEALTHY' | 'COMING_UP' | 'UNKNOWN' | 'GOING_DOWN' | 'INIT_FAILED' | 'REMOVED' | 'RESTORING' | 'UPGRADING' | 'PAUSING' | 'RESTORE_FAILED' | 'RESTARTING' | 'PAUSE_FAILED' | 'RESIZING', required
  - `database` object, required
    - `host` string, required — Database host
    - `version` string, required — Database version
    - `postgres_engine` string, required — Database engine
    - `release_channel` string, required — Release channel

## Other responses

- `401` — Unauthorized
- `403` — Forbidden action
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/supabase/apis/management-api.md) · [All operations](https://skmtc.net/supabase/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/supabase/management-api/versions/a7cb39418064/schema)