Add an accepted offer to your cart

​

Restores an accepted offer's items into the buyer's cart at their agreed quantities. Only the buyer may call this operation.

The offer must be accepted, unexpired, and unspent. Repeating the operation does not add the quantities again. Other cart items are preserved.

After restoration, removing negotiated items or reducing their quantities below the agreement voids the offer. Failed restoration voids this offer and releases its reservation.

Returns the offer summary; GET /v1/cart returns cart contents. Supports an optional Idempotency-Key. Requires offers:write and cart:write.

Path Parameters

  • offerId
    Type: string
    min length:  
    1
    max length:  
    200
    required

    A stable, opaque offer ID.

Body

application/json
Empty object

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/offers/{offerId}/add-to-cart
curl https://public-api.cardnexus.com/v1/offers/665f3a2b1c8d4e9f7a6b5c59/add-to-cart \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{}'

{
  "id": "665f3a2b1c8d4e9f7a6b5c59",
  "status": "pending",
  "viewerRole": "buyer",
  "buyer": {
    "id": "665f3a2b1c8d4e9f7a6b5c4d",
    "username": "alphabay_cards"
  },
  "seller": {
    "id": "665f3a2b1c8d4e9f7a6b5c4e",
    "username": "north_arena_tcg"
  },
  "itemCount": 1,
  "totalQuantity": 2,
  "originalTotal": {
    "amount": 30,
    "currency": "EUR"
  },
  "currentProposal": {
    "id": "665f3a2b1c8d4e9f7a6b5c60",
    "authorRole": "buyer",
    "total": {
      "amount": 25,
      "currency": "EUR"
    },
    "createdAt": "2026-09-10T14:32:00.000Z"
  },
  "awaitingResponseFrom": "seller",
  "buyerProposalCount": 1,
  "voidReason": null,
  "createdAt": "2026-09-10T14:32:00.000Z",
  "updatedAt": "2026-09-10T14:32:00.000Z",
  "expiresAt": null,
  "actions": [
    {
      "id": "cancel",
      "method": "POST",
      "path": "/v1/offers/665f3a2b1c8d4e9f7a6b5c59/cancel"
    }
  ]
}

Offer returned.