Skip to main content

​
Welcome

The Salesive Store API provides a complete e-commerce solution for managing products, customer sessions, shopping carts, orders, shipping, and merchandising. Use this reference to build storefronts, mobile apps, or custom integrations that mirror production Salesive environments.
Quick integration: Use the salesive-api-axios package for typed Axios wrappers with automatic environment detection and token management. Perfect for React, Next.js, Nuxt, and Vite projects.

​
Base URL

https://store.salesive.com/api/v1
All examples use the production host; replace the domain if you are targeting a sandbox or environment-specific endpoint.

​
Authentication

The Salesive Store API uses JWT (JSON Web Token) authentication for protected endpoints.

​
Guest Sessions

Create anonymous guest users via POST /auth/ghost to enable browsing, cart management, and wishlist features without registration.

​
Authenticated Users

For full access, users authenticate via email with OTP (one-time password) verification:
  1. Send OTP to email: POST /auth/authenticate
  2. Verify OTP: POST /auth/verify
  3. Use the returned JWT token in the Authorization header as Bearer <token>

​
Public Endpoints

Product listings, banners, and blog content are publicly accessible without authentication.

​
Headers

HeaderDescription
AuthorizationJWT token as Bearer <token> for authenticated endpoints.
Content-Typeapplication/json when sending JSON payloads.
x-shop-idStorefront identifier to scope requests to a specific shop.

​
Rate limits

Salesive applies per-store throttling. If your integration receives 429 Too Many Requests, retry with exponential backoff. Contact support if you need higher throughput.

​
Collections

  • Authentication — Create guest sessions or authenticate users with email OTP verification.
  • Products — List, filter, search, and retrieve product information with variants.
  • Cart — Manage shopping cart items, quantities, and product variants.
  • Shipping Address — Save, retrieve, and manage delivery addresses with geocoding support.
  • Orders — Create orders from cart, track order status, and manage shipments.
  • Shipping — Get shipping options and track shipments for orders.
  • Wishlist — Save and manage customer wishlists across sessions.
  • Banners — Retrieve merchandising banners for storefronts.
  • Blogs — Access editorial content and announcements.

​
Address Intelligence

The API integrates with Geoapify for enhanced address management:
  • Reverse Geocoding — Convert coordinates to addresses
  • Address Autocomplete — Real-time address suggestions as users type
Continue to the endpoint guides for detailed request/response examples and implementation patterns.