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

# Get - Catalog Ingestion Status (Beta)

`GET /catalog/ingestion/{ingestionId}`

<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

---

[API](https://skmtc.net/stockx/apis/stockx-public-api.md) · [All operations](https://skmtc.net/stockx/apis/stockx-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockx/stockx-public-api/versions/5b4ba84182d7/schema)