List your offers
Returns your sent and received offers, newest first by creation time.
Filter by role, repeatable status, or creation timestamps. All roles and statuses are included by default.
Follow pagination.nextCursor until it is null. The default limit is 50 and the maximum is 100.
Each result is a summary; fetch an offer for its items and proposal history. Requires offers:read.
Query Parameters
- Type: stringcursor
- Type: integerlimitmin:1max:100
Integer numbers.
- Type: stringenumrole
Filter by your role; omitted includes both roles.
values- buyer
You received this because you're the buyer.
- seller
You received this because you're the seller.
- buyer
- status
Filter by status. Repeat the parameter to include multiple statuses; omitted includes all statuses.
- Type: stringenum
The state of your negotiation.
values- pending
The opening proposal awaits a response.
- countered
A counterproposal awaits a response.
- accepted
The proposal was accepted; redemption is subject to its deadline and whether it has been spent.
- declined
The current proposal was rejected.
- cancelled
The negotiation was withdrawn or closed by CardNexus.
- voided
The offer can no longer be redeemed.
- pending
- Type: Format: date-timecreated
From An ISO 8601 date-time in UTC, e.g.
2024-08-14T10:23:11.000Z. - Type: Format: date-timecreated
To An ISO 8601 date-time in UTC, e.g.
2024-08-14T10:23:11.000Z.
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
curl 'https://public-api.cardnexus.com/v1/offers?limit=50&role=buyer' \
--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"
}
]
}
],
"pagination": {
"nextCursor": null
}
}