public

POST `/v1/public/cart`

Open an anonymous cart.

Authentication

This endpoint is public. It takes no credential and no organisation — it is what our own marketing site and AI answer engines read.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X POST https://api.zinndigital.com/v1/public/cart \
  -H "Content-Type: application/json" \
  -d '{  }'

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

Creates an empty cart with no organization and no user and returns its opaque bearer token. The token is returned only here — nothing can re-derive it from the cart afterwards, so a client that loses it has lost the cart. It is a credential: treat it like one. The cart expires at expires_at (24 hours). Cross-origin callers. Besides zinndigital.com, this route answers the browsers of the hosting sites' on-page free trial — zinnhosting.com, zinnhosting.co.uk and the zinndigital country sites (engine.api.trial_cors, list generated from the product-sites registry into engine/engine/api/trial_origins.json). Exact origins only, never credentials; the route's own budgets, Turnstile and trial guard apply unchanged (docs/749 §16).

Request body

Name	Type	Required	What it is
`currency`	`CurrencyCode`	No	ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
`product_line`	`string`	No	—

Response

Name	Type	Required	What it is
`id`	`Uuid`	Yes	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`token`	`string`	No	The bearer token. Returned only from `createPublicCart` — it is absent on every subsequent read, because only its digest is stored.
`status`	`string<open, converted, expired>`	Yes	—
`currency`	`CurrencyCode`	Yes	ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
`product_line`	`string`	No	—
`expires_at`	`string`	Yes	After this the cart is gone — reads 404 whether or not it has been purged.
`items`	`PublicCartItem[]`	Yes	—
`totals`	`PublicCartTotals`	Yes	Pre-tax totals. Tax appears on the order, once a billing country exists.

Errors this endpoint can return

422 · 429

POST /v1/public/cart