Authentication

The Cuprice API v1 uses API keys for authentication. Public endpoints (Share, Receipt, Checkout) don’t require authentication.

Getting an API Key

Go to Settings

Open Dashboard → Settings → API Keys

Create a key

Click Create API key, give it a name and choose permissions:

Copy the key

The key is shown only once. Copy it immediately.

API keys are shown only once at creation time. Store them securely. If you lose a key, revoke it and create a new one.

Pass the key in the Authorization header:

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

All Cuprice API keys start with cpk_ followed by a random string:

cpk_qdC2ul3mn-j0ywEvn9QznOoBhtJ4_e8Y1rv6JRUPa6U

Permission	Can do
`read`	List and read projects, features, plans
`read_write`	Everything above + create, update, delete

Scope	Limit
Per key	100 requests/minute
Per user	500 requests/minute

Status	Meaning
`401`	Invalid or missing API key
`403`	Key doesn’t have write permission
`404`	Resource not found
`400`	Bad request (missing fields, validation error)