basket

Add item to basket

Adds a listing to the basket and gives you the updated basket state back.

Typical usage:

  • user clicks "Add to basket" on a listing page
  • client sends listingId and quantity
  • UI refreshes from the returned basket payload

Why this response is handy:

  • You can re-render the whole basket immediately without an extra read call.

Important behavior:

  • Requires authentication.
  • If stock is unavailable (or the listing is invalid), the API returns structured listing errors.
post/basket/{id}

Request

  • Base URL: https://api.managem.co.uk
  • URL: https://api.managem.co.uk/basket/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The ID of the basket to retrieve

Request body

listingIdstring required

The ID of the listing

quantityinteger

The quantity of the item in the basket, defaults to 1

Response

Updated list of items in the basket

object required

Changes

No recorded changes to this operation across all 248 revisions of this API.