Get an offer

​

Returns your offer with every negotiated item and its proposal history.

Proposals are ordered chronologically. Quantities and original listing prices remain fixed throughout the negotiation.

Only the buyer and seller can access an offer; other accounts receive 404.

The actions array lists operations currently available to you. Requires offers:read.

Path Parameters

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

    A stable, opaque offer ID.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/offers/{offerId}
curl https://public-api.cardnexus.com/v1/offers/665f3a2b1c8d4e9f7a6b5c59 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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"
    }
  ],
  "items": [
    {
      "listingId": "665f3a2b1c8d4e9f7a6b5c52",
      "productId": 50212,
      "productName": "Dark Magician (SDMY-EN001)",
      "imageUrl": "https://images.cardnexus.com/yugioh/SDMY-EN001.png",
      "quantity": 2,
      "originalUnitPrice": {
        "amount": 15,
        "currency": "EUR"
      }
    }
  ],
  "proposals": [
    {
      "id": "665f3a2b1c8d4e9f7a6b5c60",
      "authorRole": "buyer",
      "total": {
        "amount": 25,
        "currency": "EUR"
      },
      "createdAt": "2026-09-10T14:32:00.000Z",
      "status": "pending",
      "items": [
        {
          "listingId": "665f3a2b1c8d4e9f7a6b5c52",
          "offeredUnitPrice": {
            "amount": 12.5,
            "currency": "EUR"
          }
        }
      ]
    }
  ]
}

Offer returned.