Skip to main content
POST
Create a listing

Authorizations

Authorization
string
header
required

Clerk session token. Use Authorization: Bearer .

Headers

x-listing-pin-token
string
required

PIN verification token. Missing or invalid → 401 PIN_TOKEN_INVALID.

Body

application/json
itemType
enum<string>
required
Available options:
card,
pack
itemId
string
required
type
enum<string>
required
Available options:
sale,
auction,
trade
salePrice
number
openToTradeOffers
boolean
startingBid
number
askingPrice
number
buyNowPrice
number
durationDays
enum<integer>
Available options:
1,
3,
7,
14
reservePrice
integer
Required range: x >= 1
tradeCriteria
object

Response

{ success, data: { listing } }