Reference
Storefront API
Catalog, carts and checkout, for headless storefronts and custom buying flows. 31 endpoints in version 2026-11.
Basics
- Base URL
https://api.storelyne.com- Version
- In the path:
/storefront/2026-11/. Inside a version we only add things. How versions work. - Authentication
- Send a public storefront token in the
Storefront-Tokenheader. Issue one with the Admin API. It can only read the catalog and run a checkout, so it is safe in a browser. Authentication. - Format
- JSON in and out, UTF-8. Timestamps are ISO 8601 in UTC. IDs carry a prefix, for example
prd_for products. - Money
- Integers in the smallest unit (paise for INR) with a
currency:49900is ₹499.00. - Lists
?limit=&after=and{ data, has_more, next_cursor }. Pagination.- Retries
- Every POST takes an
Idempotency-Key. Idempotent requests. - Errors
- One shape with a stable
codeand atrace_id. Error codes. - Limits
RateLimit-*headers on every response. Rate limits.
Resources
Cart
Carts and their lines.
Checkout
Checkout attempts, payment methods and what happened in each attempt.
- POST
/storefront/2026-11/checkouts - GET
/storefront/2026-11/checkouts/{id} - PATCH
/storefront/2026-11/checkouts/{id} - POST
/storefront/2026-11/checkouts/{id}/attempts - GET
/storefront/2026-11/checkouts/{id}/attempts/{attempt_id} - POST
/storefront/2026-11/checkouts/{id}/attempts/{attempt_id}/confirm - POST
/storefront/2026-11/checkouts/{id}/attempts/{attempt_id}/test-payment - POST
/storefront/2026-11/checkouts/{id}/place
Storefront
The catalog, collections, pages and the shop as buyers see them.
- GET
/storefront/2026-11/checkouts/{id}/after - POST
/storefront/2026-11/checkouts/{id}/conversion - GET
/storefront/2026-11/checkouts/{id}/downloads - POST
/storefront/2026-11/downloads/{token}/claim - GET
/storefront/2026-11/media/{file_id} - GET
/storefront/2026-11/page-previews/{token} - GET
/storefront/2026-11/pages/{slug} - POST
/storefront/2026-11/pages/{slug}/checkout - GET
/storefront/2026-11/platform - GET
/storefront/2026-11/policies/{kind} - GET
/storefront/2026-11/product-pages - GET
/storefront/2026-11/products - GET
/storefront/2026-11/products/{handle} - GET
/storefront/2026-11/products/{handle}/images/{file_id} - GET
/storefront/2026-11/shop - GET
/storefront/2026-11/theme - GET
/storefront/2026-11/theme/media/{file_id}