---
title: "Returns a list of projects."
method: GET
path: "/organization/projects"
tags: ["Projects"]
---

# Returns a list of projects.

`GET /organization/projects`

## Query parameters

- `limit` integer
- `after` string
- `include_archived` boolean

## Response `200`

Projects listed successfully.

- ProjectListResponse
  - `object` 'list', required
  - `data` Project[], required
    - `id` string, required — The identifier, which can be referenced in API endpoints
    - `object` 'organization.project', required — The object type, which is always `organization.project`
    - `name` string, nullable — The name of the project. This appears in reporting.
    - `created_at` integer, required — The Unix timestamp (in seconds) of when the project was created.
    - `archived_at` integer, nullable — The Unix timestamp (in seconds) of when the project was archived or `null`.
    - `status` string, nullable — `active` or `archived`
    - `external_key_id` string, nullable — The external key associated with the project.
    - `residency` 'GLOBAL' | 'US_STORAGE_PROCESSING' | 'EU_STORAGE_PROCESSING' | 'JP_STORAGE' | 'KR_STORAGE' | 'CA_STORAGE' | 'SG_STORAGE' | 'IN_STORAGE' | 'AU_STORAGE' | 'GB_STORAGE' | 'AE_STORAGE' | 'AE_STORAGE_PROCESSING'
  - `first_id` string, nullable
  - `last_id` string, nullable
  - `has_more` boolean, required

## Changes

> 82 revisions in range; 7 could not be searched.

- **2026-08-21** `db5d7478feae` — 1 info
  - added the optional property `data/items/residency` to the response with the `200` status
- **2026-05-13** `74cbcf73838f` — 9 breaking, 4 info
  - the response property `data/items/name` became optional for the status `200`
  - the response property `data/items/status` became optional for the status `200`
  - the response property `first_id` became optional for the status `200`
  - the response property `last_id` became optional for the status `200`
  - …9 more
- **2024-09-26** `548c762fe616` — 2 warning
  - removed the optional property `data/items/app_use_case` from the response with the `200` status
  - removed the optional property `data/items/business_website` from the response with the `200` status
- **2024-09-13** `4c9e3967c707` — 2 info
  - added the optional property `data/items/app_use_case` to the response with the `200` status
  - added the optional property `data/items/business_website` to the response with the `200` status
- **2024-08-06** `8eca3b09b705` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openai/apis/openapi/changes/organization/projects/get.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openai/openapi/revisions/959ef977e135/schema)