Customers

My Account

Self-service endpoints used by the shopfront for the currently-authenticated Customer — viewing their charges, credits, memberships, contraindications, payment methods and marketing preferences.

get/customers/my-account

Get My Account Details

getMyAccountDetails

Returns base details about the currently authenticated customer (the holder of the bearer customer token).

Responses

  • 200

    The Customer was successfully retrieved

  • 401

    The user is unauthenticated

get/customers/my-account/charges

Get My Account Charges

listMyAccountCharges

Returns the membership charges that have been billed to the authenticated customer.

Responses

  • 200

    The customer's charges were successfully retrieved

  • 401

    The user is unauthenticated

get/customers/my-account/credits

Get My Account Credits

listMyAccountCredits

Returns the unredeemed, unexpired credits available to the authenticated customer.

By default, only credits which haven't been redeemed and haven't expired are shown. Use the query parameters to include redeemed and/or expired credits. Revoked credits are never returned on this endpoint.

Query parameters

  • redeemedbooleanoptional

    Whether to include redeemed credits

  • expiredbooleanoptional

    Whether to include expired credits

Responses

  • 200

    The customer's credits were successfully retrieved

  • 401

    The user is unauthenticated

get/customers/my-account/marketing-preferences

Get My Account Marketing Preferences

listMyAccountMarketingPreferences

Returns the marketing preferences available to the authenticated customer along with the opt-in state for each.

Responses

  • 200

    The customer's marketing preferences were successfully retrieved

  • 401

    The user is unauthenticated

post/customers/my-account/marketing-preferences/{marketingPreferenceId}

Opt Into a Marketing Preference (My Account)

actionMyAccountMarketingPreferenceOptIn

Opts the authenticated customer into the given marketing preference.

Path parameters

  • The unique identifier of the marketing preference this operation is scoped to.

Responses

  • 200

    The customer's marketing preferences were successfully retrieved

  • 401

    The user is unauthenticated

  • 403

    The authenticated user does not have permission.

  • 404

    The resource couldn't be found

delete/customers/my-account/marketing-preferences/{marketingPreferenceId}

Opt Out of a Marketing Preference (My Account)

actionMyAccountMarketingPreferenceOptOut

Opts the authenticated customer out of the given marketing preference.

Path parameters

  • The unique identifier of the marketing preference this operation is scoped to.

Responses

  • 200

    The customer's marketing preferences were successfully retrieved

  • 401

    The user is unauthenticated

  • 403

    The authenticated user does not have permission.

  • 404

    The resource couldn't be found

get/customers/my-account/memberships

Get My Account Memberships

listMyAccountMemberships

Returns the memberships held by the authenticated customer.

Responses

  • 200

    The customer's memberships were successfully retrieved

  • 401

    The user is unauthenticated

get/customers/my-account/payment-methods

Get My Account Payment Methods

listMyAccountPaymentMethods

Returns the payment methods saved against the authenticated customer.

Responses

  • 200

    The customer's payment methods were successfully retrieved

  • 401

    The user is unauthenticated

  • 404

    The resource couldn't be found

get/shop/my-account/orders

List orders for the authenticated customer

listMyAccountOrders

Returns the authenticated customer's order history — completed baskets along with item details. Intended for the "My Bookings" screens of customer-facing apps and the storefront.

Requires customer authentication; staff API tokens cannot use this endpoint (use GET /shop/orders instead).

Query parameters

  • pageintegeroptional

    The page to retrieve results from

  • per_pageintegeroptional

    The number of results to return per page

Responses

  • 200

    The Orders were successfully retrieved

  • 400

    The request failed.

  • 401

    The user is unauthenticated