Get single listing

Documentation

Support

Get single listing

Get a listing API allows you to get a listing by its ID.

Request

Security:

api_keyjwt

path Parameters

listingId

required

string

Unique ID for this listing

Responses

200

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

get/selling/listings/{listingId}

Request samples

curl
JavaScript
Node.js

curl -i -X GET \
  https://api.stockx.com/v2/selling/listings/:listingId \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Response samples

application/json

{"listingId": "98e2e748-8000-45bf-a624-5531d6a68318",
"status": "ACTIVE",
"amount": "300",
"currencyCode": "AUD",
"inventoryType": "STANDARD",
"createdAt": "2021-11-09T12:44:31.000Z",
"updatedAt": "2021-11-09T12:44:31.000Z",
"batch": {"batchId": "86378f62-ad0e-4a06-9c8e-642731bb9140",
"taskId": "7083634e-3bc5-4747-a4f3-768093074b5e"
},
"ask": {"askId": "string",
"askCreatedAt": "2021-11-09T12:44:31.000Z",
"askUpdatedAt": "2021-11-09T12:44:31.000Z",
"askExpiresAt": "2021-11-09T12:44:31.000Z"
},
"order": {"orderNumber": "323314425-323214184",
"orderCreatedAt": "2021-11-09T12:44:31.000Z",
"orderStatus": "CREATED"
},
"product": {"productId": "bf364c53-eb77-4522-955c-6a6ce952cc6f",
"productName": "Nike Air"
},
"variant": {"variantId": "bf364c53-eb77-4522-955c-6a6ce952cc6f",
"variantName": "color",
"variantValue": "black"
},
"payout": {"totalPayout": 76.81,
"salePrice": 79,
"totalAdjustments": -7,
"currencyCode": "string",
"adjustments": [{"adjustmentType": "Shipping Fee (10%)",
"amount": 2.13,
"percentage": 0.1
}
]
},
"lastOperation": {"operationId": "bf364c53-eb77-4522-955c-6a6ce952cc6f",
"operationType": "CREATE",
"operationStatus": "PENDING",
"operationInitiatedBy": "USER",
"operationInitiatedVia": "IOS",
"operationCreatedAt": "2021-11-09T12:44:31.000Z",
"operationUpdatedAt": "2021-11-09T12:44:31.000Z",
"changes": {"additions": {"active": true,
"askData": {"amount": "100",
"currency": "USD",
"expiresAt": "2022-08-24T18:06:43.600Z"
}
},
"updates": {"updatedAt": "2021-11-09T12:44:31.000Z"
},
"removals": { }
},
"error": ""
}
}