---
title: "List Projects that the current API Token has permission to view"
method: GET
path: "/v1/projects"
tags: ["Projects"]
---

# List Projects that the current API Token has permission to view

`GET /v1/projects`

Lists all projects that the current API Token has permission to view.

## Query parameters

- `page` number
- `perPage` number
- `sortBy` 'createdAt' | 'updatedAt' | 'name' | 'key' | 'propertyKey'
- `sortOrder` 'asc' | 'desc'
- `search` string
- `createdBy` string

## Response `200`

- Project[]
  - `_id` string, required — A unique Project ID
  - `_organization` string, required — ID of the Organization owning the Project
  - `_createdBy` string, required — ID of the User who created the project
  - `name` string, required — Project name
  - `key` string, required — A unique key to identify the Project
  - `description` string — A description of the Project
  - `color` string — Project display color, used to highlight different projects on the dashboard. Must use Hex color code.
  - `settings` ProjectSettings, required
    - `edgeDB` EdgeDBSettings, required
      - `enabled` boolean, required
    - `optIn` OptInSettings, required
      - `enabled` boolean, required
      - `title` string, required
      - `description` string, required
      - `imageURL` string, required
      - `colors` ColorSettings, required
        - `primary` string, required
        - `secondary` string, required
      - `poweredByAlignment` object, required
    - `sdkTypeVisibility` SDKTypeVisibilitySettings, required
      - `enabledInFeatureSettings` boolean, required
    - `lifeCycle` LifeCycleSettings, required
      - `disableCodeRefChecks` boolean, required
    - `obfuscation` ObfuscationSettings, required
      - `enabled` boolean, required
      - `required` boolean, required
    - `featureApprovalWorkflow` FeatureApprovalWorkflowSettings, required
      - `enabled` boolean, required
      - `allowPublisherBypass` boolean, required
      - `defaultReviewers` string[], required
    - `disablePassthroughRollouts` boolean, required
    - `staleness` StalenessSettings, required
      - `enabled` boolean, required
      - `released` ReleasedStalenessSettings, required
        - `enabled` boolean, required
      - `unmodifiedLong` UnmodifiedLongStalenessSettings, required
        - `enabled` boolean, required
      - `unmodifiedShort` UnmodifiedShortStalenessSettings, required
        - `enabled` boolean, required
      - `unused` UnusedStalenessSettings, required
        - `enabled` boolean, required
      - `email` StalenessEmailSettings, required
        - `enabled` boolean, required
        - `frequency` 'weekly' | 'biweekly' | 'monthly', required
        - `users` string[], required
        - `lastNotification` string, date-time, required
    - `dynatrace` DynatraceProjectSettings, required
      - `enabled` boolean, required
      - `environmentMap` object, required
  - `createdAt` string, date-time, required — The date the Project was created
  - `updatedAt` string, date-time, required — The date the Project was last updated
  - `hasJiraIntegration` boolean, required — Boolean tracking whether this project has a jira integration set up
  - `hasReceivedCodeUsages` boolean, required — Describe if a project has ever received code usages for any variable
  - `hasUserConfigFetch` boolean, required — Boolean indicating whether a user config has been fetched for this project
  - `jiraBaseUrl` string, required — Jira project base url, if the integration is defined
  - `readonly` boolean, required — Controls whether the feature is editable for a given user
  - `vercelEdgeConfigConnections` VercelEdgeConfigConnection[] — Edge Config Connections for the project
    - `edgeConfigName` string, required
    - `configurationId` string, required

## Other responses

- `400` — Invalid request - missing or invalid properties
- `403`

---

[API](https://skmtc.net/devcycle/apis/devcycle-management-api.md) · [All operations](https://skmtc.net/devcycle/apis/devcycle-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devcycle/devcycle-management-api/versions/d4a127a37608/schema)