Skip to main content
GET
Get product by ID

📌 Endpoint

GET /stores/{storeId}/products/{productId} Returns a specific product from the store.

🔐 Authentication & Validations

  • Public route for queries (does not use authentication).
  • ⚠️ Business validation: The store owner must have an active plan.
    • If the plan is inactive/expired, returns 403 NO_ACTIVE_SUBSCRIPTION.

🧾 Route parameters


✅ Example request


Standard snippet (cURL)

Use the cURL example from the Request example section above as the official snippet.

📦 Success response (200)


⚠️ Possible errors

  • 400 INVALID_DATA → invalid parameters (storeId or productId empty or > 50 characters)
  • 401 UNAUTHENTICATED → could not identify the subscription user
  • 403 NO_ACTIVE_SUBSCRIPTION → inactive or expired plan
  • 404 STORE_NOT_FOUND → store not found
  • 404 PRODUCT_NOT_FOUND → product not found (including when productId is up to 50 characters but not a valid UUID)
  • 429 RATE_LIMIT_EXCEEDED → rate limit per minute exceeded
  • 500 INTERNAL_SERVER_ERROR → internal error
  • 503 SERVICE_UNAVAILABLE → service or database unavailable

Path Parameters

storeId
string
required
Required string length: 1 - 50
productId
string
required
Required string length: 1 - 50

Response

Get product by ID.

code
string
required
Example:

"PRODUCT_FETCHED"

product
object
required

Store product.