Overview

Base URL

https://cuprice.io

Two API types

Cuprice has two types of API endpoints: Public Endpoints — No authentication needed. Used by the embed widget. API v1 — Requires an API key. Full CRUD for projects, features, and plans.

Authentication

Endpoint	Auth
Share API	None (public)
Receipt API	None (public, uses project’s Stripe)
Checkout API	None (public, uses project’s Stripe)
API v1 (`/api/v1/*`)	`Authorization: Bearer cpk_...`

Public Endpoints

GET /api/share/{shareId}

Get project data (plans, features, theme)

GET /api/stripe/receipt

Get purchase details from a Stripe session

POST /api/stripe/checkout

Create checkout session for a regular plan

POST /api/stripe/checkout/custom

Create checkout session for a custom plan

API v1 — Projects, Features, Plans

Projects

List, create, update, delete projects. Update theme and custom CSS.

Features

Manage feature backlog — standard, limits, and usage-based features.

Plans

Create, update, delete, and duplicate pricing plans.

Plan Features

Assign features to plans, set multipliers, remove features.

Quick Example

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

# Create a feature
curl https://cuprice.io/api/v1/projects/my-saas/features \
  -X POST \
  -H "Authorization: Bearer cpk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name": "AI Chat", "basePrice": 10}'

# Update theme with custom CSS
curl https://cuprice.io/api/v1/projects/my-saas \
  -X PUT \
  -H "Authorization: Bearer cpk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"theme": {"primaryColor": "#7C3AED", "customCSS": ".cuprice-pricing-card { border-radius: 24px !important; }"}}'

Authentication

Public Endpoints

API v1 — Projects

API v1 — Features

API v1 — Plans

API v1 — Plan Features

Overview

Base URL

Two API types

Authentication

Public Endpoints

GET /api/share/{shareId}

GET /api/stripe/receipt

POST /api/stripe/checkout

POST /api/stripe/checkout/custom

API v1 — Projects, Features, Plans

Projects

Features

Plans

Plan Features

Quick Example

​Base URL

​Two API types

​Authentication

​Public Endpoints

GET /api/share/{shareId}

GET /api/stripe/receipt

POST /api/stripe/checkout

POST /api/stripe/checkout/custom

​API v1 — Projects, Features, Plans

Projects

Features

Plans

Plan Features

​Quick Example

Base URL

Two API types

Authentication

Public Endpoints

API v1 — Projects, Features, Plans

Quick Example