---
title: "GET /v1/projects"
method: GET
path: "/v1/projects"
tags: ["projects"]
---

# GET /v1/projects

`GET /v1/projects`

## Query parameters

- `externalId` string
- `limit` number
- `cursor` string

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, required
    - `created` string, required
    - `updated` string, required
    - `ownerId` string, required
    - `displayName` string, required
    - `notifyStatus` union, required
      - 'NEVER'
      - 'ALWAYS'
      - 'NEW_ISSUE'
    - `platformId` string, required
    - `externalId` string
    - `usage` object, required
      - `tasks` number, required
      - `teamMembers` number, required
    - `plan` object, required
      - `id` string, required
      - `created` string, required
      - `updated` string, required
      - `projectId` string, required
      - `name` string, required
      - `minimumPollingInterval` number, required
      - `piecesFilterType` union, required
        - 'NONE'
        - 'ALLOWED'
      - `pieces` string[], required
      - `connections` number, required
      - `teamMembers` number, required
      - `tasks` number, required
  - `next` string, nullable — Cursor to the next page
  - `previous` string, nullable — Cursor to the previous page

## Changes

- **2026-07-13** `225ff954244e` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2024-09-03** `b95c8c8e8262` — 1 info
  - endpoint added
- **2024-07-04** `6067892aa453` — 1 breaking
  - api path removed without deprecation
- **2024-07-04** `719995374e3d` — 1 info
  - added `subschema #3` to the `data/items/notifyStatus` response property `anyOf` list for the response status `200`
- **2024-04-05** `8ff3eaeb8161` — 3 breaking, 2 warning, 3 info
  - removed the required property `data/items/plan/flowPlanName` from the response with the `200` status
  - removed the required property `data/items/plan/stripeCustomerId` from the response with the `200` status
  - removed the required property `data/items/plan/subscriptionStartDatetime` from the response with the `200` status
  - removed the optional property `data/items/plan/stripeSubscriptionId` from the response with the `200` status
  - …4 more

[Full history](https://skmtc.dev/rantirai/apis/activepieces-documentation/changes/v1/projects/get.md)

---

[API](https://skmtc.dev/rantirai/apis/activepieces-documentation.md) · [All operations](https://skmtc.dev/rantirai/apis/activepieces-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rantirai/activepieces-documentation/revisions/225ff954244e/schema)