List pricing groups
Returns the pricing groups enabled on your business as
[{id, title}, …]. Pass all=true to list the full selectable
catalog instead (shared vocabulary, like the provider list).
The three-step recipe to put a branch on tier pricing:
- Create or enable a group here (
POST, orPUTwith ids from?all=true). - Point the branch at it —
price_group_idonupdateBranch. Careful: once set, omittingprice_group_idfrom a later branchPATCHclears the assignment. - Give items a price for that tier —
groupPricesonupdateItemPrice(outer key = group id as string), then the usualsyncMenuToStores+publishMenuround-trip.
Branches without a group (or items without a groupPrices entry
for the branch’s group) fall back to the base prices map.
Authorizations
Authorization: Basic base64(partner_key:secret_key).
Credentials are issued by a klikit operator. The plaintext
secret_key is shown once at issuance and cannot be retrieved
later — store it securely. If lost, ask your operator to rotate
the secret to receive a new one. The old secret stops working
immediately on rotation; there is no overlap window.
Query Parameters
true returns the full catalog, not just your business's groups.
Response
Price group list — data is [{id, title}, …].
Canonical response wrapper. Every response — success or error —
carries the request_id so you can quote one id to klikit
support to correlate a request end-to-end.
"req_4d1b7e3f-..."
Endpoint-specific payload on success.
Machine-readable error code + human message. The code is stable
across releases — switch on code in your client code rather
than parsing the message text.
Common codes you will encounter as a partner: