List Projects

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

Endpoint

GET /api/v1/projects

Authentication

string

required

Bearer token with your API key. Requires read or read_write permission.

Response

array

List of project objects.

Show Project object

number

Unique project ID

string

Project display name

string

URL-friendly project identifier

string

Short project description

Public share identifier used for the embed widget

string

Currency code (e.g. "USD", "EUR")

boolean

Whether the project is active

string

ISO 8601 creation timestamp

string

ISO 8601 last-updated timestamp

object

Aggregate counts for related resources

number

Number of features in the project

number

Number of pricing plans in the project

Example

curl https://cuprice.io/api/v1/projects \
  -H "Authorization: Bearer cpk_your_key_here"

{
  "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
      }
    }
  ]
}

Overview

Public Endpoints

API v1 — Projects

API v1 — Features

API v1 — Plans

API v1 — Plan Features

Endpoint

Authentication

Response

Example

​Endpoint

​Authentication

​Response

​Example

Endpoint

Authentication

Response

Example