Skip to main content
The Storefront REST API mirrors what the SDK does under the hood. Use it when you are building native mobile apps, server-side integrations, or working in languages outside the JavaScript ecosystem.

Base URL & auth

All storefront endpoints live under /api/v1/locations/{locationId} and require a location-specific API key that you generate in the Crave dashboard.

Example: fetch menus

Example: create and manage a cart

Handling customers & discounts

Want to see more endpoints? Jump to the Storefront REST reference.

Tips for non-JS stacks

  • Retry on 429 – Respect the X-RateLimit-Reset header before retrying.
  • Reuse carts – Persist cart IDs on the client to keep pricing consistent across sessions.
  • Secure API keys – Store keys server-side and proxy requests when you cannot trust the client (e.g., native mobile apps).
  • Log failures – The API returns structured error bodies; log them for observability.
When you need a deeper dive into the payloads and responses, explore the API Reference section in the sidebar.