Sign in

v1

latestOpenAPI 3.0.0MIT2026-08-043290199.3 KB
Listings

Activate a listing

Activate listing API allows you to activate a listing. A listing is active when it contains an available ask.

put/selling/listings/{listingId}/activate

Path parameters

listingIdstring required

Unique ID for this listing

Request body

amountstring

The amount this product is being listed for

currencyCodestring

The currency code this product is being listed in. If not provided, it will default to USD. Only valid currencies supported on stockx.com are supported via API<br><br>Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"

expiresAtstring

UTC timestamp representing when this Ask should auto-expire. If not provided, it will default to 999 days from today. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

Example request

{
  "amount": "150",
  "currencyCode": "USD",
  "expiresAt": "2021-11-09T12:44:31.000Z"
}

Response

listingIdstring required

Unique ID for this listing

operationIdstring required

Unique ID for this operation

operationType'CREATE' | 'UPDATE' | 'DELETE' | 'ACTIVATE' | 'DEACTIVATE' | 'CANCEL_ORDER' | 'RECLAIM' | 'CANCEL_RECLAIM' | 'TPS_CHECK' required
operationStatus'PENDING' | 'SUCCEEDED' | 'FAILED' required
operationUrlstring nullable required

The URL used for to poll the status of the operation.

operationInitiatedBy'USER' | 'SYSTEM' required
operationInitiatedVia'IOS' | 'ANDROID' | 'WEB' | 'STOCKX-PRO' | 'SCOUT' | 'SHOPIFY' | 'PUBLIC-API' | 'INTERNAL-SYSTEM' required
createdAtstring required

When the listing was created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

updatedAtstring required

When this listing was last updated in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z

errorstring nullable

Error message if the creation failed

Example response

{
  "listingId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "operationId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "operationUrl": "https://api.stockx.com/v2/selling/listings/c0a635ce-322f-49e1-9bfc-f954fc46f6bd/operations/d0a635ce-322f-49e1-9bfc-f954fc46f6be",
  "createdAt": "2021-11-09T12:44:31.000Z",
  "updatedAt": "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"
    }
  }
}