---
title: "List projects"
method: GET
path: "/client/projects"
tags: ["Projects"]
---

# List projects

`GET /client/projects`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/projects`
- Auth: HTTP bearer

## Response `200`

Projects

- ProjectList
  - `data` ProjectListItem[], required
    - `id` string, uuid, required
    - `name` string, required
    - `status` 'active' | 'archived', required
    - `spendLimitUsd` string, nullable, required: Decimal USD as a string
    - `budgetPeriod` 'day' | 'week' | 'month' | 'total', required
    - `hardCap` boolean, required
    - `alertAtPct` integer, required
    - `createdAt` string, date-time, required
    - `spendUsd` number, required: Spend in the project's current budget period
    - `pctUsed` number, nullable, required: Null when the project has no cap
    - `keys` integer, required
    - `apps` integer, required
    - `members` integer, required
    - `permissions` ProjectPermissions, required
      - `role` 'viewer' | 'developer' | 'manager', nullable, required
      - `canCreateKey` boolean, required
      - `canDeploy` boolean, required
      - `canListSecrets` boolean, required
      - `canWriteSecrets` boolean, required
      - `canManageSecrets` boolean, required
      - `canManageMembers` boolean, required
      - `canViewContent` boolean, required
      - `canQueryData` boolean, required
      - `canWriteData` boolean, required
      - `canRestoreData` boolean, required
      - `canSetBudget` boolean, required

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)