---
title: "Get - Catalog Ingestion Status (Beta)"
method: GET
path: "/catalog/ingestion/{ingestionId}"
tags: ["Catalog"]
deprecated: true
---

# Get - Catalog Ingestion Status (Beta)

`GET /catalog/ingestion/{ingestionId}`

## Request

- Base URL: `https://api.stockx.com/v2`
- URL: `https://api.stockx.com/v2/catalog/ingestion/{ingestionId}`
- Auth: API key in header `x-api-key` and HTTP bearer

> **Deprecated.**

<b>Monitor Your Data Integration Status.</b><br>Once you create an ingestion job successfully, you need to poll the get catalog ingestion API to track the progress, whether the entire job or individual updates.

## Path parameters

- `ingestionId` string, required

## Query parameters

- `status` string

## Response `200`

Ok

- GetIngestionItemsReponse
  - `items` GetIngestionItem[], required
    - `ingestionId` string, required: Unique ID used to return the status of an ingestion job.
    - `status` 'In Review' | 'Completed' | 'Rejected', required
    - `input` union, required: The initial items submitted.
      - IngestionSneakersShoesRequestInput
        - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
        - `productTitle` string, required: A string that uniquely identifies the name of the product.
        - `brand` string, required: The brand of the product.
        - `productImages` string[], required: Public facing links to the products image.
        - `variants` string[], required: The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
        - `retailPrice` string, required: The products retail price.
        - `releaseDate` string, required: The products release date.
        - `countryOfOrigin` string, required: The country in which the product was manufactured in ISO Alpha 2 Format.
        - `partnerProductId` string: An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
        - `tags` string[]: A list of attributes or short descriptors associated with the product.
        - `colorway` string, required: The combinations of colors in which the product is designed. Ex VIOLET ORE/MEDIUM ASH-BLACK-MUSLIN-BURGUNDY CRUSH.
        - `gtin` string, required: The products global trade item number. Length must be 8, 12, 13, 14 or 18.
        - `gender` string, required: The products targeted gender.
        - `styleCode` string, required: The Style Code for the product @example "M990BK5"
        - `productDescription` string: Open text field used for describing the product to the customer.
        - `dimensions` string: A string of the dimensions of the product. @example "2/"x4/"x6/""
        - `weight` string: The weight of the product.
        - `material` string: Brand listed materials.
        - `productURL` string: Official third party product URL.
      - IngestionApparelAccessoriesRequestInput
        - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
        - `productTitle` string, required: A string that uniquely identifies the name of the product.
        - `brand` string, required: The brand of the product.
        - `productImages` string[], required: Public facing links to the products image.
        - `variants` string[], required: The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
        - `retailPrice` string, required: The products retail price.
        - `releaseDate` string, required: The products release date.
        - `countryOfOrigin` string, required: The country in which the product was manufactured in ISO Alpha 2 Format.
        - `partnerProductId` string: An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
        - `tags` string[]: A list of attributes or short descriptors associated with the product.
        - `colorway` string, required: The combinations of colors in which the product is designed.
        - `material` string, required: Brand listed materials.
        - `gender` string, required: The products targeted gender.
        - `styleCode` string: The Style Code for the product @example "M990BK5"
        - `gtin` string: The products global trade item number.
        - `productDescription` string: Open text field used for describing the product to the customer.
        - `dimensions` string: A string of the dimensions of the product.
        - `weight` string: The weight of the product.
        - `productURL` string: Official third party product URL.
        - `productCode` ProductCode
          - `code` string, required: Unique code that identifies the product.
          - `name` 'serial number' | 'mpn', required
      - IngestionCollectiblesRequestInput
        - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
        - `productTitle` string, required: A string that uniquely identifies the name of the product.
        - `brand` string, required: The brand of the product.
        - `productImages` string[], required: Public facing links to the products image.
        - `variants` string[], required: The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
        - `retailPrice` string, required: The products retail price.
        - `releaseDate` string, required: The products release date.
        - `countryOfOrigin` string, required: The country in which the product was manufactured in ISO Alpha 2 Format.
        - `partnerProductId` string: An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
        - `tags` string[]: A list of attributes or short descriptors associated with the product.
        - `colorway` string: The combinations of colors in which the product is designed.
        - `styleCode` string: The Style Code for the product @example "M990BK5"
        - `productDescription` string: Open text field used for describing the product to the customer.
        - `dimensions` string: A string of the dimensions of the product.
        - `weight` string: The weight of the product.
        - `productURL` string: Official third party product URL.
        - `productCode` ProductCode
          - `code` string, required: Unique code that identifies the product.
          - `name` 'serial number' | 'mpn', required
      - IngestionElectronicsRequestInput
        - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
        - `productTitle` string, required: A string that uniquely identifies the name of the product.
        - `brand` string, required: The brand of the product.
        - `productImages` string[], required: Public facing links to the products image.
        - `variants` string[], required: The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
        - `retailPrice` string, required: The products retail price.
        - `releaseDate` string, required: The products release date.
        - `countryOfOrigin` string, required: The country in which the product was manufactured in ISO Alpha 2 Format.
        - `partnerProductId` string: An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
        - `tags` string[]: A list of attributes or short descriptors associated with the product.
        - `colorway` string: The combinations of colors in which the product is designed.
        - `styleCode` string: The Style Code for the product @example "M990BK5"
        - `gtin` string: The products global trade item number.
        - `productDescription` string: Open text field used for describing the product to the customer.
        - `dimensions` string: A string of the dimensions of the product.
        - `weight` string: The weight of the product.
        - `productURL` string: Official third party product URL.
        - `productCode` ProductCode
          - `code` string, required: Unique code that identifies the product.
          - `name` 'serial number' | 'mpn', required
      - IngestionTradingCardsRequestInput
        - `category` 'sneakers' | 'shoes' | 'apparel' | 'accessories' | 'collectibles' | 'electronics' | 'trading cards', required
        - `productTitle` string, required: A string that uniquely identifies the name of the product.
        - `brand` string, required: The brand of the product.
        - `productImages` string[], required: Public facing links to the products image.
        - `variants` string[], required: The product variants available to sell. For example, for sneakers, each different size is a different variant or for electronics like iPhone, each different storage capacity is a different variant.
        - `retailPrice` string, required: The products retail price.
        - `releaseDate` string, required: The products release date.
        - `countryOfOrigin` string, required: The country in which the product was manufactured in ISO Alpha 2 Format.
        - `partnerProductId` string: An external ID that partners will use to reference an internal StockX catalog item if approved. Note that this is the higher level product id, not the variantId.
        - `tags` string[]: A list of attributes or short descriptors associated with the product.
        - `colorway` string: The combinations of colors in which the product is designed.
        - `styleCode` string: The Style Code for the product @example "M990BK5"
        - `gtin` string: The products global trade item number.
        - `productDescription` string: Open text field used for describing the product to the customer.
        - `dimensions` string: A string of the dimensions of the product.
        - `weight` string: The weight of the product.
        - `productURL` string: Official third party product URL.
        - `productCode` ProductCode
          - `code` string, required: Unique code that identifies the product.
          - `name` 'serial number' | 'mpn', required
    - `result` IngestionItemResult, required
      - `brand` string, required: The brand of the product.
      - `title` string, required: A string that uniquely identifies the name of the product.
      - `variantId` string, required: Unique identifier for the product variant.
    - `partnerProductId` string, nullable, required: The external partner ID provided in the request.
    - `rejectionDetails` IngestionItemRejectionDetails, required
      - `reason` string, required
    - `createdAt` string, required: Timestamp when the resource was created.
    - `updatedAt` string, required: Timestamp when the resource was last updated.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

## Changes

- **2026-11-04** `2d70f6b5d01b`: 1 info
  - endpoint deprecated

[Operation history](https://skmtc.dev/stockx/apis/stockx-public-api/changes/catalog/ingestion/:ingestionId/get.md)

---

[API](https://skmtc.dev/stockx/apis/stockx-public-api.md) - [All operations](https://skmtc.dev/stockx/apis/stockx-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stockx/apis/stockx-public-api/revisions/2d70f6b5d01b?raw)