> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cuprice.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Projects

> Retrieve all projects for the authenticated user

Returns all projects belonging to the authenticated user, including feature and plan counts.

## Endpoint

```
GET /api/v1/projects
```

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer token with your API key. Requires `read` or `read_write` permission.
</ParamField>

## Response

<ResponseField name="projects" type="array">
  List of project objects.

  <Expandable title="Project object">
    <ResponseField name="id" type="number">
      Unique project ID
    </ResponseField>

    <ResponseField name="name" type="string">
      Project display name
    </ResponseField>

    <ResponseField name="slug" type="string">
      URL-friendly project identifier
    </ResponseField>

    <ResponseField name="description" type="string">
      Short project description
    </ResponseField>

    <ResponseField name="shareId" type="string">
      Public share identifier used for the embed widget
    </ResponseField>

    <ResponseField name="currency" type="string">
      Currency code (e.g. `"USD"`, `"EUR"`)
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      Whether the project is active
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 creation timestamp
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 last-updated timestamp
    </ResponseField>

    <ResponseField name="_count" type="object">
      Aggregate counts for related resources
    </ResponseField>

    <ResponseField name="_count.features" type="number">
      Number of features in the project
    </ResponseField>

    <ResponseField name="_count.pricingPlans" type="number">
      Number of pricing plans in the project
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash theme={null}
curl https://cuprice.io/api/v1/projects \
  -H "Authorization: Bearer cpk_your_key_here"
```

```json theme={null}
{
  "projects": [
    {
      "id": 42,
      "name": "My SaaS App",
      "slug": "my-saas-app",
      "description": "AI-powered project management tool",
      "shareId": "nTZ7axXQHU",
      "currency": "USD",
      "isActive": true,
      "createdAt": "2025-09-15T10:30:00.000Z",
      "updatedAt": "2025-11-02T14:22:00.000Z",
      "_count": {
        "features": 8,
        "pricingPlans": 3
      }
    },
    {
      "id": 67,
      "name": "Design Studio",
      "slug": "design-studio",
      "description": "Collaborative design platform",
      "shareId": "kR4mPwL9vB",
      "currency": "EUR",
      "isActive": true,
      "createdAt": "2025-10-20T08:15:00.000Z",
      "updatedAt": "2025-12-01T09:45:00.000Z",
      "_count": {
        "features": 12,
        "pricingPlans": 4
      }
    }
  ]
}
```