Skip to navigation
OTP Members

List the renewals available for one of the member’s memberships

Lists the renewals the logged-in member may buy for one of their own memberships — never an upgrade, a cancel or an extend, for now; cached up to 5 minutes — as MEMBERSHIP_RENEW products priced at the amount the membership system quoted, in the same item shape as GET /api/membership/alterations. To buy one, send its sku with the same membershipNumber to POST /api/cart/lines, with the member token:

{ "cartId": "cart_…", "lines": [{ "type": "MEMBERSHIP_RENEW", "sku": "<item sku>", "membershipNumber": "MS100005" }] }

Take membershipNumber from GET /api/member/me; a number that is not one of the member’s own unblocked memberships answers 404, whatever the reason. Requires the member token from POST /api/member/session.

Authentication

AuthorizationBearer

OTP member token, browser-safe. Obtain one from POST /api/member/session with the 6-digit code POST /api/member/login emailed to the shopper; valid 30 minutes, for one store and one proven email, and it reads only that member’s own data. Sent as Authorization: Bearer <token>. Not interchangeable with the BearerAuth client token in either direction.

Headers

x-entriastringRequired

Identifies which store this request is for. Required on every store-scoped route. It is not authentication and not a secret — it grants no privileges and is safe to send from a browser. You receive the value once your Entria backend has been created and configured. Missing header returns 400; an unknown store returns 404.

Query parameters

membershipNumberstringRequired>=1 character

One of the member’s own membership numbers, from GET /api/member/me.

localestringOptional

BCP 47 locale code (e.g. da-DK, en-US). Defaults to DEFAULT_LOCALE env binding.

Response

The options for this membership, as MEMBERSHIP_RENEW products. An empty array means it currently has none.

skustring or null
titlestring
descriptionstring
handlestring
medialist of objects
pricedouble or null
basePricedouble or null
subscriptionboolean or null
membershipLegalTextstring or null
lifecycleActionstring
addonobject or nullOptional
validFromstring or nullOptional
validUntilstring or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
502
Bad Gateway Error
503
Service Unavailable Error