{"openapi":"3.0.3","info":{"title":"Storefront Vendor API","version":"1.0.0"},"servers":[{"url":"https://my.showgrow.com/api/v1"}],"security":[{"bearerAuth":[]}],"paths":{"/locations":{"get":{"operationId":"listLocations","tags":["Inventory"],"summary":"List storefront locations.","description":"List storefront locations.","x-required-permission":"inventory:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/locations"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inventory":{"get":{"operationId":"pageInventory","tags":["Inventory"],"summary":"List sellable products and available quantities for a location.","description":"Reuse the same locationId for every page. Continue until nextCursor is null, even if a page is empty. Availability can change before checkout.","x-required-permission":"inventory:read","parameters":[{"name":"locationId","in":"query","required":false,"schema":{"type":"string","description":"Location ID from GET /locations. Required when the storefront has multiple locations."}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"Page size. Defaults to 50.","minimum":1,"maximum":200}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","description":"Opaque nextCursor from the previous page."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inventory"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/carts/{cartId}":{"put":{"operationId":"createCart","tags":["Carts"],"summary":"Open a draft with your own stable cart reference.","description":"Retry with the same cart ID and create body to recover the existing cart. Drafts use version 0 and can expire under the storefront’s cart rules.","x-required-permission":"cart:write","parameters":[{"name":"cartId","in":"path","required":true,"schema":{"type":"string","description":"Your stable cart reference, up to 80 letters, numbers, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_-]{1,80}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cart"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locationId":{"type":"string","description":"Location ID from GET /locations. Required when the storefront has multiple locations."},"customerId":{"type":"string","description":"Customer ID issued to this integration."}},"additionalProperties":false},"example":{"locationId":"STORE_ID"}}}}},"get":{"operationId":"getCart","tags":["Carts"],"summary":"Read totals, line items, status, and the current version.","description":"Read totals, line items, status, and the current version.","x-required-permission":"cart:read","parameters":[{"name":"cartId","in":"path","required":true,"schema":{"type":"string","description":"Your stable cart reference, up to 80 letters, numbers, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_-]{1,80}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cart"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/carts/{cartId}/products/{productId}":{"put":{"operationId":"setCartItem","tags":["Carts"],"summary":"Set the total quantity of a product in a draft.","description":"Set the total quantity of a product in a draft.","x-required-permission":"cart:write","parameters":[{"name":"cartId","in":"path","required":true,"schema":{"type":"string","description":"Your stable cart reference, up to 80 letters, numbers, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_-]{1,80}$"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string","description":"Product ID from inventory."}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","description":"Unique per cart mutation, 8 to 128 letters, numbers, dots, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_.-]{8,128}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cart"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"integer","description":"Version from the last cart response.","minimum":0},"quantity":{"type":"integer","description":"New total quantity for this product.","minimum":1,"maximum":250}},"required":["version","quantity"],"additionalProperties":false},"example":{"version":0,"quantity":2}}}}}},"/carts/{cartId}/items/{lineId}":{"delete":{"operationId":"deleteCartItem","tags":["Carts"],"summary":"Remove a line from a draft by its line ID.","description":"Remove a line from a draft by its line ID.","x-required-permission":"cart:write","parameters":[{"name":"cartId","in":"path","required":true,"schema":{"type":"string","description":"Your stable cart reference, up to 80 letters, numbers, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_-]{1,80}$"}},{"name":"lineId","in":"path","required":true,"schema":{"type":"string","description":"Line ID from the cart response."}},{"name":"version","in":"query","required":true,"schema":{"type":"integer","description":"Version from the last cart response.","minimum":0}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","description":"Unique per cart mutation, 8 to 128 letters, numbers, dots, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_.-]{8,128}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cart"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/carts/{cartId}/submit":{"post":{"operationId":"submitCart","tags":["Orders"],"summary":"Submit a pickup order from a draft.","description":"Provide customerId if the cart has no customer. Submission checks current inventory and purchase limits. The customer pays at pickup.","x-required-permission":"cart:submit","parameters":[{"name":"cartId","in":"path","required":true,"schema":{"type":"string","description":"Your stable cart reference, up to 80 letters, numbers, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_-]{1,80}$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","description":"Unique per cart mutation, 8 to 128 letters, numbers, dots, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_.-]{8,128}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cart"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"integer","description":"Version from the last cart response.","minimum":0},"customerId":{"type":"string","description":"Customer ID issued to this integration."},"ageConfirmed":{"type":"boolean","description":"Confirm that the customer is eligible to purchase."},"orderNotes":{"type":"string","description":"Pickup notes.","maxLength":500}},"required":["version","ageConfirmed"],"additionalProperties":false},"example":{"version":1763496000000,"customerId":"CUSTOMER_ID","ageConfirmed":true}}}}}},"/orders/{orderId}":{"get":{"operationId":"getOrder","tags":["Orders"],"summary":"Track a submitted order by its stable order ID.","description":"Use the orderId returned at submission. The storefront owns fulfillment and cancellation.","x-required-permission":"orders:read","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string","description":"Order ID returned at submission."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/order"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/customers":{"post":{"operationId":"createCustomer","tags":["Customers"],"summary":"Create a customer for your integration.","description":"Retry with the same phone to recover a record created by this key. Existing records owned elsewhere return a conflict. Customer creation leaves marketing unsubscribed.","x-required-permission":"customer:write","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/customer"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phone":{"type":"string","description":"US phone number."},"firstName":{"type":"string","description":"First name.","minLength":1,"maxLength":80},"lastName":{"type":"string","description":"Last name.","maxLength":80},"email":{"type":"string","description":"Email address. An empty string clears it.","maxLength":254}},"required":["firstName","phone"],"additionalProperties":false},"example":{"firstName":"Sam","lastName":"Rivera","phone":"2025550100"}}}}}},"/customers/{customerId}":{"get":{"operationId":"getCustomer","tags":["Customers"],"summary":"Read a customer created by this integration.","description":"Read a customer created by this integration.","x-required-permission":"customer:read","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","description":"Customer ID issued to this integration."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/customer"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"updateCustomer","tags":["Customers"],"summary":"Update a customer’s name or email.","description":"Supply at least one field. The phone number is fixed.","x-required-permission":"customer:write","parameters":[{"name":"customerId","in":"path","required":true,"schema":{"type":"string","description":"Customer ID issued to this integration."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/customer"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, expired, or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Content type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request limit reached","headers":{"Retry-After":{"schema":{"type":"integer","description":"Seconds until requests are allowed again.","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"firstName":{"type":"string","description":"First name.","minLength":1,"maxLength":80},"lastName":{"type":"string","description":"Last name.","maxLength":80},"email":{"type":"string","description":"Email address. An empty string clears it.","maxLength":254}},"additionalProperties":false},"example":{"firstName":"Samuel"}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error."},"code":{"type":"string","description":"Stable error category."},"requestId":{"type":"string","description":"Request reference for support."}}},"locations":{"type":"object","properties":{"locations":{"type":"array","items":{"type":"object","properties":{"locationId":{"type":"string","description":"Location ID from GET /locations. Required when the storefront has multiple locations."},"name":{"type":"string","description":"Location name."}}}}}},"inventory":{"type":"object","properties":{"locationId":{"type":"string","description":"Location ID from GET /locations. Required when the storefront has multiple locations."},"items":{"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Product ID from inventory."},"name":{"type":"string","description":"Product name."},"brand":{"type":"string","description":"Brand."},"category":{"type":"string","description":"Category."},"price":{"type":"number"},"availableQuantity":{"type":"integer","description":"Sellable quantity at time of reading.","minimum":0}}}},"nextCursor":{"type":"string","description":"Pass as cursor for the next page.","nullable":true}}},"cart":{"type":"object","properties":{"cart":{"type":"object","properties":{"cartId":{"type":"string","description":"Your stable cart reference, up to 80 letters, numbers, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_-]{1,80}$"},"orderId":{"type":"string","description":"Order ID returned at submission."},"locationId":{"type":"string","description":"Location ID from GET /locations. Required when the storefront has multiple locations."},"status":{"type":"string","description":"Storefront cart or order status."},"subtotal":{"type":"number"},"discount":{"type":"number"},"tax":{"type":"number"},"total":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"lineId":{"type":"string","description":"Cart line ID."},"productId":{"type":"string","description":"Product ID from inventory."},"name":{"type":"string","description":"Product name."},"quantity":{"type":"integer","description":"Units.","minimum":1},"price":{"type":"number"}}}},"version":{"type":"integer","description":"Version from the last cart response.","minimum":0},"customerId":{"type":"string","description":"Customer ID issued to this integration.","nullable":true}}},"replayed":{"type":"boolean"}}},"order":{"type":"object","properties":{"order":{"type":"object","properties":{"cartId":{"type":"string","description":"Your stable cart reference, up to 80 letters, numbers, hyphens, or underscores.","pattern":"^[a-zA-Z0-9_-]{1,80}$"},"orderId":{"type":"string","description":"Order ID returned at submission."},"locationId":{"type":"string","description":"Location ID from GET /locations. Required when the storefront has multiple locations."},"status":{"type":"string","description":"Storefront cart or order status."},"subtotal":{"type":"number"},"discount":{"type":"number"},"tax":{"type":"number"},"total":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"lineId":{"type":"string","description":"Cart line ID."},"productId":{"type":"string","description":"Product ID from inventory."},"name":{"type":"string","description":"Product name."},"quantity":{"type":"integer","description":"Units.","minimum":1},"price":{"type":"number"}}}},"submittedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}},"customer":{"type":"object","properties":{"customer":{"type":"object","properties":{"customerId":{"type":"string","description":"Customer ID issued to this integration."},"phone":{"type":"string","description":"US phone number."},"firstName":{"type":"string","description":"First name.","minLength":1,"maxLength":80},"lastName":{"type":"string","description":"Last name.","maxLength":80},"email":{"type":"string","description":"Email address. An empty string clears it.","maxLength":254}}}}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}