---
title: "List all projects"
method: GET
path: "/api/v3.1/org/project/list"
tags: ["Projects", "Organization Management"]
---

# List all projects

`GET /api/v3.1/org/project/list`

Retrieves projects belonging to the authenticated organization by default, or all organizations the authenticated user belongs to when list_all_org_projects is true. Projects are returned in descending order of creation date (newest first). This endpoint is useful for displaying project selection in dashboards or for integrations that need to list all available projects.

## Query parameters

- `list_all_org_projects` boolean, nullable — List projects from all organizations the authenticated user belongs to
- `limit` integer
- `cursor` string

## Response `200`

Projects retrieved successfully with pagination. Returns an array of project objects with their complete details and pagination info.

- object
  - `data` object[], required
    - `id` string, projectId, required — Unique identifier for the project
    - `org_id` string, orgId, required — Identifier of the organization that owns this project
    - `name` string, required — Name of the project
    - `email` string, required — Email address associated with the project
    - `created_at` string, required — ISO timestamp when the project was created
    - `updated_at` string, required — ISO timestamp when the project was last updated
    - `webhook_url` string, uri, nullable, required — DEPRECATED: Use GET /api/v3/webhook_subscriptions instead. Legacy project-level webhook URL.
    - `event_webhook_url` string, uri, nullable, required — DEPRECATED: No longer used.
    - `webhook_secret` string, nullable, required — DEPRECATED: Use GET /api/v3/webhook_subscriptions instead. Legacy project-level webhook secret.
    - `triggers_enabled` boolean — Whether triggers are enabled for this project
    - `last_subscribed_at` string, date-time, nullable — ISO timestamp when the project last subscribed to updates
    - `is_new_webhook` boolean — Deprecated: Please refer to webhook_version instead. True indicates if the webhook configuration is using the previous new format (V2). False indicates the oldest format (V1)
    - `webhook_version` 'V1' | 'V2' | 'V3', required — Payload format version for Pusher real-time events only. For webhook configuration, use GET /api/v3/webhook_subscriptions.
    - `deleted` boolean, required — Whether this project has been soft-deleted
  - `next_cursor` string, nullable
  - `total_pages` number, required
  - `current_page` number, required
  - `total_items` number, required

## Other responses

- `400` — Bad request. This may occur if there are invalid query parameters or the request is malformed.
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `500` — Internal server error. An unexpected error occurred while processing the request.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)