Skip to content
Management API Reference

List projects of an organization

get/v2/organizations/{slug}/projects

Returns a cursor-paginated list of projects for the specified organization, including their databases.

Use page[after] and page[before] to navigate pages and page[size] to control the number of projects returned per page.

OAuth scopes

  • projects:read

The fine-grained token must include the following permissions to access this endpoint:

  • organization_projects_read

Path parameters

  • slug
    Required
    string

    Organization slug

Query parameters

  • page
    Optional
    object
  • sort
    Optional
    enum

    Sort order by creation time: inserted_at (oldest first) or -inserted_at (newest first). Defaults to inserted_at.

  • search
    Optional
    string

    Case-insensitive substring match on the project name.

Response codes

  • 200
  • 401
  • 403
  • 429

Response (200)

{
  "data": [
    {
      "type": "project",
      "id": "abcdefghijklmnopqrst",
      "attributes": {
        "name": "lorem",
        "status": "INACTIVE",
        "cloud_provider": "lorem",
        "region": "lorem",
        "inserted_at": "lorem",
        "databases": [
          {
            "cloud_provider": "lorem",
            "identifier": "lorem",
            "region": "lorem",
            "status": "ACTIVE_HEALTHY",
            "type": "PRIMARY",
            "infra_compute_size": "pico",
            "disk_volume_size_gb": 42,
            "disk_type": "gp3",
            "disk_throughput_mbps": 42,
            "disk_last_modified_at": "lorem"
          }
        ]
      }
    }
  ],
  "links": {
    "first": "/v2/organizations/my-org/projects?page[size]=10",
    "prev": "/v2/organizations/my-org/projects?page[size]=10&page[before]=019adf7d-4513-74c5-bb9a-f1bc0f7a95d7",
    "next": "/v2/organizations/my-org/projects?page[size]=10&page[after]=019adf7d-4513-7062-b292-78b86cc470a4",
    "last": "/v2/organizations/my-org/projects?page[size]=10&page[after]=019adf7d-4513-71ba-b264-21900edb4295"
  }
}