STstockx
Listings

Get single listing operation

Get listing operation API allows you to fetch a listing operation by listing ID and operation ID

get/selling/listings/{listingId}/operations/{operationId}

Request

  • Base URL
    https://api.stockx.com/v2
  • Auth
    API key in header x-api-key and HTTP bearer

Path parameters

listingIdstring required

Unique ID for this listing.

operationIdstring required

Unique ID for this operation.

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
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 2022-01-18T20:20:39Z

errorstring nullable required

Error message if the creation failed

Example response

{
  "listingId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "operationId": "98e2e748-8000-45bf-a624-5531d6a68318",
  "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"
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.