Get organization project list

Returns a list of projects in the organization with filtering and sorting options.

get/v2/organization/{organization}/project-list

Request

Base URL: https://api.zephyr-cloud.io
URL: https://api.zephyr-cloud.io/v2/organization/{organization}/project-list
Auth: HTTP bearer

Path parameters

organizationstring required

Organization unique name (URL-safe slug)

Example:zephyr-cloud

Query parameters

type'all' | 'created_by_me' | 'public' | 'private' | 'removed'

Filter projects by type

Example:all

sort'name_asc' | 'name_desc' | 'latest_updates'

Sort order

Example:latest_updates

namestring

Filter by project name

Example:my-project

limitnumber nullable

Limit results

Example:20

offsetnumber nullable

Offset for pagination

pageinteger

Page number (1-based). When provided, overrides offset.

Example:1

perPageinteger

Number of projects per page

Example:20

latestDaysnumber nullable

Filter by latest days

Example:7

updatedFromstring

Filter projects updated after this ISO 8601 date

Example:2025-01-01T00:00:00.000Z

updatedTostring

Filter projects updated before this ISO 8601 date

Example:2025-12-31T23:59:59.000Z

Response

Paginated list of projects

Example response

{
  "entities": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "main-app",
      "displayName": "Main Application",
      "applications": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440010",
          "name": "web-dashboard"
        }
      ],
      "visibility": "private",
      "deletedAt": null,
      "updatedAt": "2025-12-17T00:00:00.000Z",
      "authorId": "550e8400-e29b-41d4-a716-446655440001",
      "author": {
        "id": "550e8400-e29b-41d4-a716-446655440001",
        "name": "John Doe"
      },
      "counters": {
        "applications": 1,
        "remotes": 0
      },
      "tags": [
        "frontend"
      ],
      "description": "The main application project",
      "organizationId": "550e8400-e29b-41d4-a716-446655440002"
    }
  ],
  "pageMetadata": {
    "total": 100,
    "lastPage": 5,
    "currentPage": 2,
    "perPage": 20,
    "prev": 1,
    "next": 3
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.