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

# GET /v1/projects/

`GET /v1/projects/`

## Query parameters

- `externalId` 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'
    - `type` union, required
      - 'PLATFORM_MANAGED'
      - 'STANDALONE'
    - `platformId` string
    - `externalId` string
    - `plan` object, required
      - `id` string, required
      - `created` string, required
      - `updated` string, required
      - `projectId` string, required
      - `stripeSubscriptionId` string, nullable
      - `subscriptionStartDatetime` string, required
      - `flowPlanName` string, required
      - `minimumPollingInterval` number, required
      - `connections` number, required
      - `teamMembers` number, required
      - `tasks` number, required
      - `tasksPerDay` number, nullable
    - `usage` object, required
      - `id` string, required
      - `created` string, required
      - `updated` string, required
      - `projectId` string, required
      - `consumedTasks` number, required
      - `connections` number, required
      - `teamMembers` number, required
      - `consumedTasksToday` number, required
      - `nextResetDatetime` string, required
  - `next` string, nullable — Cursor to the next page
  - `previous` string, nullable — Cursor to the previous page

## Changes

- **2023-12-17** `e4e2ec56a169` — 4 breaking
  - the response property `data/items/plan/stripeSubscriptionId` became optional for the status `200`
  - the response property `data/items/plan/tasksPerDay` became optional for the status `200`
  - the response property `next` became optional for the status `200`
  - the response property `previous` became optional for the status `200`
- **2023-12-09** `8a2f0946c574` — 1 warning, 1 info
  - deleted the `query` request parameter `platformId`
  - added the new optional `query` request parameter `externalId`
- **2023-12-06** `c5ff28051098` — 2 breaking, 4 info
  - the response property `next` became nullable for the status `200`
  - the response property `previous` became nullable for the status `200`
  - the response property `next` became required for the status `200`
  - the response property `previous` became required for the status `200`
  - …2 more
- **2023-12-03** `7b0cc60eed56` — 2 breaking, 1 warning, 1 info
  - removed the required property `data/items/plan` from the response with the `200` status
  - removed the required property `data/items/usage` from the response with the `200` status
  - deleted the `query` request parameter `externalId`
  - added the new optional `query` request parameter `platformId`

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

---

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