Skip to main content

Check product availability with subscription status by external product and variant ID (requires user auth)

POST 
/api/v1/sdk/cart/store/:storeId/availability-with-subscription

This endpoint checks product availability and includes the authenticated customer's back-in-stock subscription status. Enhanced version of availability check with personalization.

Authentication: Requires customer authentication (JWT token with verified phone). Optional API key for additional store validation.

Response Data (includes all from basic availability plus):

  • In-stock status and available quantity
    • Current pricing and product details
    • isSubscribedToBackInStock - Whether this customer is subscribed to notifications
    • subscriptionDate - When customer subscribed (if applicable)

Use Cases:

  • Personalized product pages showing subscription status
    • Managing back-in-stock notification UI state
    • Customer-specific availability checking

Error Scenarios:

  • 404 NOT FOUND - Product variant not found (Error code: VARIANT_NOT_FOUND)
    • 400 BAD REQUEST - Invalid request format (Error code: INVALID_REQUEST)
    • 401 UNAUTHORIZED - Customer not authenticated (Error code: UNAUTHORIZED)
    • 403 FORBIDDEN - API key doesn't have access to this store (Error code: NO_STORE_ACCESS)

Request​

Responses​

Product availability with subscription status retrieved successfully