---
title: "Look up existing projects"
method: GET
path: "/v1/project"
tags: ["Projects"]
---

# Look up existing projects

`GET /v1/project`

This endpoint allows you to retrieve your existing projects.

## Response `200`

Successful retrieval of projects

- ProjectListResponse
  - `projects` ProjectDetail[]
    - `buckets` BucketDetail[]
      - `bucketId` integer, required
      - `fileCount` integer
      - `fileSize` string
      - `name` string
    - `created` string, date-time
    - `fileCount` integer
    - `fileSize` string
    - `projectId` integer, required
    - `name` string
    - `updated` string, date-time

## Changes

- **2023-10-05** `5ee59ea914aa` — 2 info
  - api tag `Projects` added
  - api tag `Project` removed
- **2023-10-05** `05194fdd107e` — 1 breaking, 1 info
  - the `projects/items/projectId` response's property type changed from `string` to `integer` for status `200`
  - the response property `projects/items/projectId` became required for the status `200`
- **2023-10-05** `006f5c1a8d40` — 1 info
  - the response property `projects/items/buckets/items/bucketId` became required for the status `200`
- **2023-10-04** `7d474e21a108` — 2 info
  - api operation id `getProjects` removed and replaced with `Project_list`
  - api tag `Project` added
- **2023-10-04** `79c42de78d2f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/groundxai/apis/groundx-apis/changes/v1/project/get.md)

---

[API](https://skmtc.dev/groundxai/apis/groundx-apis.md) · [All operations](https://skmtc.dev/groundxai/apis/groundx-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/groundxai/apis/groundx-apis/revisions/5ee59ea914aa?raw)