---
title: "List all projects"
method: GET
path: "/organizations/{organizationID}/projects"
tags: ["Projects"]
---

# List all projects

`GET /organizations/{organizationID}/projects`

Retrieves a list of all projects within the specified organization that the authenticated user has access to.

## Path parameters

- `organizationID` string, required

## Response `200`

A list of projects within the organization

- object
  - `projects` Project[], required — Array of project objects with their metadata
    - `id` string, required — Unique identifier for the project
    - `name` string, required — Human-readable name of the project
    - `createdAt` string, date-time, required — Timestamp when the project was created
    - `updatedAt` string, date-time, required — Timestamp when the project was last updated
    - `configuration` ProjectConfiguration, required — Configuration details for a project, including its scale to zero settings
      - `scaleToZero` ProjectScaleToZeroConfiguration, required — Whether the project branches are configured to scale down to zero when not in use
        - `baseBranches` ScaleToZeroConfiguration, required — Configuration for scaling branches to zero when not in use
          - `enabled` boolean, required — Whether scale to zero is enabled
          - `inactivityPeriodMinutes` integer, required — Duration in minutes after which branches will be hibernated if not accessed
        - `childBranches` ScaleToZeroConfiguration, required — Configuration for scaling branches to zero when not in use
          - `enabled` boolean, required — Whether scale to zero is enabled
          - `inactivityPeriodMinutes` integer, required — Duration in minutes after which branches will be hibernated if not accessed
      - `ipFiltering` IPFilteringConfiguration — Configuration for IP filtering on project branches
        - `enabled` boolean, required — Whether IP filtering is enabled
        - `cidr` CidrEntry[], required
          - `cidr` string, required — IP address or CIDR block (e.g., "192.168.0.0/24")
          - `description` string — Optional label for the CIDR entry

## Other responses

- `400` — Generic error response for most error conditions
- `401` — Error response when authentication or authorization fails
- `5XX` — Unexpected Error
- `default` — Unexpected Error

---

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