---
title: "Gets all projects for the given organization"
method: GET
path: "/v1/organizations/{slug}/projects"
tags: ["Projects"]
---

# Gets all projects for the given organization

`GET /v1/organizations/{slug}/projects`

Returns a paginated list of projects for the specified organization.

This endpoint uses offset-based pagination. Use the `offset` parameter to skip a number of projects and the `limit` parameter to control the number of projects returned per page.

## Path parameters

- `slug` string, required

## Query parameters

- `offset` integer
- `limit` integer
- `search` string
- `sort` 'name_asc' | 'name_desc' | 'created_asc' | 'created_desc'
- `statuses` string

## Response `200`

- OrganizationProjectsResponse
  - `projects` object[], required
    - `ref` string, required
    - `name` string, required
    - `cloud_provider` string, required
    - `region` string, required
    - `is_branch` boolean, required
    - `status` 'INACTIVE' | 'ACTIVE_HEALTHY' | 'ACTIVE_UNHEALTHY' | 'COMING_UP' | 'UNKNOWN' | 'GOING_DOWN' | 'INIT_FAILED' | 'REMOVED' | 'RESTORING' | 'UPGRADING' | 'PAUSING' | 'RESTORE_FAILED' | 'RESTARTING' | 'PAUSE_FAILED' | 'RESIZING', required
    - `inserted_at` string, required
    - `databases` object[], required
      - `infra_compute_size` 'pico' | 'nano' | 'micro' | 'small' | 'medium' | 'large' | 'xlarge' | '2xlarge' | '4xlarge' | '8xlarge' | '12xlarge' | '16xlarge' | '24xlarge' | '24xlarge_optimized_memory' | '24xlarge_optimized_cpu' | '24xlarge_high_memory' | '48xlarge' | '48xlarge_optimized_memory' | '48xlarge_optimized_cpu' | '48xlarge_high_memory'
      - `region` string, required
      - `status` 'ACTIVE_HEALTHY' | 'ACTIVE_UNHEALTHY' | 'COMING_UP' | 'GOING_DOWN' | 'INIT_FAILED' | 'REMOVED' | 'RESTORING' | 'UNKNOWN' | 'INIT_READ_REPLICA' | 'INIT_READ_REPLICA_FAILED' | 'RESTARTING' | 'RESIZING', required
      - `cloud_provider` string, required
      - `identifier` string, required
      - `type` 'PRIMARY' | 'READ_REPLICA', required
      - `disk_volume_size_gb` number
      - `disk_type` 'gp3' | 'io2'
      - `disk_throughput_mbps` number
      - `disk_last_modified_at` string
  - `pagination` object, required
    - `count` number, required — Total number of projects. Use this to calculate the total number of pages.
    - `limit` number, required — Maximum number of projects per page
    - `offset` number, required — Number of projects skipped in this response

## Other responses

- `401` — Unauthorized
- `403` — Forbidden action
- `429` — Rate limit exceeded
- `500` — Failed to retrieve projects

---

[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)