> ## 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.

# Get Project

> Retrieve a single project with all its details

Returns a single project including its theme settings, features (with countable data), and pricing plans (with plan features and feature details).

## Endpoint

```
GET /api/v1/projects/{slug}
```

## Authentication

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

## Path Parameters

<ParamField path="slug" type="string" required>
  The project's URL-friendly slug identifier.
</ParamField>

## Response

<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="pricingPageDescription" type="string">
  Pricing page header description
</ResponseField>

<ResponseField name="shareId" type="string">
  Public share identifier
</ResponseField>

<ResponseField name="currency" type="string">
  Currency code
</ResponseField>

<ResponseField name="annualDiscount" type="number">
  Discount percentage for annual billing (e.g. `0.2` = 20% off)
</ResponseField>

<ResponseField name="annualDiscountEnabled" type="boolean">
  Whether annual discount is enabled
</ResponseField>

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

<ResponseField name="themeSettings" type="object">
  Visual customization settings (colors, fonts, CSS, layout)
</ResponseField>

<ResponseField name="features" type="array">
  All features in the project, each including `countableData` for usage-based features
</ResponseField>

<ResponseField name="pricingPlans" type="array">
  All pricing plans, each including `planFeatures` with nested feature details
</ResponseField>

## Example

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

```json theme={null}
{
  "id": 42,
  "name": "My SaaS App",
  "slug": "my-saas-app",
  "description": "AI-powered project management tool",
  "pricingPageDescription": "Simple, transparent pricing for teams of all sizes.",
  "shareId": "nTZ7axXQHU",
  "currency": "USD",
  "annualDiscount": 0.2,
  "annualDiscountEnabled": true,
  "isActive": true,
  "themeSettings": {
    "fontFamily": "Inter",
    "primaryColor": "#298558",
    "hoverColor": "#1E6B44",
    "buttonTextColor": "#FFFFFF",
    "borderRadius": "8px",
    "pricingBackgroundColor": "#FFFFFF",
    "pricingBorderColor": "#E5E7EB",
    "customCSS": ""
  },
  "features": [
    {
      "id": 101,
      "name": "AI Prompts",
      "description": "Monthly AI prompt allowance",
      "basePrice": 10,
      "featureType": "Limits",
      "isCountable": true,
      "countableData": {
        "usageCount": 500,
        "condition": "Up to",
        "countPrice": 0.02,
        "eventAggregationMethod": "count"
      }
    },
    {
      "id": 102,
      "name": "Team Members",
      "description": "Number of team seats",
      "basePrice": 5,
      "featureType": "Standart",
      "isCountable": false,
      "countableData": null
    }
  ],
  "pricingPlans": [
    {
      "id": 200,
      "name": "Pro",
      "description": "For growing teams",
      "basePrice": 29,
      "isPopular": true,
      "isVisible": true,
      "isFree": false,
      "planFeatures": [
        {
          "id": 301,
          "multiplier": 1,
          "feature": {
            "id": 101,
            "name": "AI Prompts",
            "featureType": "Limits",
            "basePrice": 10
          }
        },
        {
          "id": 302,
          "multiplier": 5,
          "feature": {
            "id": 102,
            "name": "Team Members",
            "featureType": "Standart",
            "basePrice": 5
          }
        }
      ]
    }
  ]
}
```

## Errors

| Status | Description                           |
| ------ | ------------------------------------- |
| `401`  | Invalid or missing API key            |
| `404`  | Project with the given slug not found |