Skip to main content

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.

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

EndpointAuth
Share APINone (public)
Receipt APINone (public, uses project’s Stripe)
Checkout APINone (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; }"}}'