Endpoints
Every route of the merchant API, from the OpenAPI document. Shop-page routes take the publishable key in ?key=; the two server routes take the secret key in Authorization: Bearer.
Base URL https://cfg.cutoptim.com · Contract version v1 · OpenAPI 3.1 document
Paths, field names, error codes, header names and code samples stay in English: they are the contract.
All routes
The table is generated from the OpenAPI document; the interactive reference below renders the same document with every schema and code samples. Point your client generator at the document itself.
| Method | Path | Key | What it does |
|---|---|---|---|
| GET | /cfg/v1/config/public | publishable | The shop's published configuration (public projection) |
| GET | /cfg/v1/catalog/search | publishable | Search the shop's catalogue |
| POST | /cfg/v1/preview | publishable | Live plan and price (not billable, no token) |
| POST | /cfg/v1/quote | publishable | Signed quote (billable) |
| POST | /cfg/v1/order | publishable | Redeem a quote once and store the signed order.v1 |
| POST | /cfg/v1/projects | publishable | Save a project |
| GET | /cfg/v1/projects | publishable + project token | The shopper's projects (newest first, without data) |
| GET | /cfg/v1/projects/{id} | publishable + project token | Open one project (with data) |
| POST | /cfg/v1/projects/{id} | publishable + project token | Re-save a project (name and/or data) |
| POST | /cfg/v1/projects/{id}/duplicate | publishable + project token | Copy a project (new id, same data, same owner) |
| POST | /cfg/v1/projects/{id}/reorder | publishable + project token | A new quote from a saved project, at today's prices |
| POST | /cfg/v1/quote/verify | secret | Verify a quote token before the cart (read-only) |
| GET | /cfg/v1/orders/{id} | secret | Check a stored order (no personal data) |
The interactive reference loads below. Without JavaScript, read the table above or the OpenAPI document. /configurator/openapi.json
There is no "try it" button here on purpose: the secret key belongs on your server, never in a browser. The demo shop shows the embed and the order hand-off working end to end.
LegalConfigurator terms ·Data processing agreement ·Shopper privacy notice ·Third-party licences