Skip to main content
GET
Get the shopper's library

Request

Headers

A guest session (the anonymous user from POST /auth/ghost) or a request with no token gets 403 with code: "login_required". Send the shopper through the login flow, then call this again. Buying a digital item also needs a real account, because access is tied to the buyer’s email. The response is sent with Cache-Control: no-store because every downloadUrl carries a credential.

Response fields

data.items has one row per title. When several purchases reach the same title (for example a lifetime copy and the all-access pass), the best one is shown. data.pass is the store’s current all-access pass, or null, so the library page can offer a renewal without a second call.

Successful response

Renewing

A pass is renewed by buying it again: add { "digitalId": "<productId>", "mode": "pass" } (or { "allAccess": true } when renewMode is all_access) with Add item to cart and check out as usual. The new purchase extends the same access record, adding 30 days to whatever is left.

Error response

Other codes: 400 shop_required (no store context) and 500 library_error.

Authorizations

Authorization
string
header
required

JWT issued by the Salesive Store API for authenticated shoppers.

x-shop-id
string
header
required

Optional storefront identifier sent as a header to scope responses to a specific shop. Try It requests remember this value once provided.

Headers

x-shop-id
string

Optional identifier that scopes responses to a specific storefront when the referer cannot be inferred.

Response

The shopper's library.

status
integer
Example:

200

success
boolean
Example:

true

message
string
Example:

"Library retrieved"

data
object
Example: