Add item to basket

curl --request POST \
  --url https://api.managem.co.uk/basket/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "listingId": "<string>",
  "quantity": 1
}
'

{}

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}

Add item to basket

curl --request POST \
  --url https://api.managem.co.uk/basket/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "listingId": "<string>",
  "quantity": 1
}
'

{}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

The ID of the basket to retrieve

Body

application/json

listingId

string

required

The ID of the listing

quantity

integer

default:1

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

Response

Updated list of items in the basket

{key}

object[]

Show child attributes

Get basket information Update basket item