Sign in
Listings

Create a listing

Create a new orderbook listing for the authenticated organization.

Rate limit: 120 requests burst, 60 requests/minute sustained.

post/listings/create-listing/v1

Request body

productIdstring uuid required
variantIdstring uuid required
quantityinteger required
type'fixed_pricing' | 'premium_percentage_pricing' | 'premium_dollar_pricing' required
priceinteger nullable

Price in cents. Required for fixed_pricing type

premiumPercentnumber
premiumDollarinteger

Premium in cents

sellerNotesstring
activeboolean
expiresAtstring date-time
inventoryIdstring uuid
maxSpotPriceinteger nullable

Max spot price in cents

minSpotPriceinteger nullable

Min spot price in cents

Response

Default Response

successboolean required

Changes

No recorded changes to this endpoint across all 1 revision of this API.