---
title: "Get Product Batch Results"
method: GET
path: "/api/v1/results/products"
tags: ["Results"]
---

# Get Product Batch Results

`GET /api/v1/results/products`

## Request

- The document declares no server URL.
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/aboutyou/apis/sellers-center-api/docs/api/v1/results/products/get.ts> (a function with typed inputs; its response is checked against the schema)

**Rate limit:** 200 requests per minute

## Query parameters

- `batch_request_id` string, uuid, required

## Response `200`

OK

- UpsertProductBatchResultsResponseSchema
  - `batchRequestId` string, uuid, required: Unique identifier (UUID)
  - `status` 'pending' | 'processing' | 'completed' | 'retry' | 'failed', required
  - `items` UpsertProductResultItemSchema[], required
    - `requestItem` UpsertProductItemSchema, required
      - `style_key` string, required: Unique style key for the product.
      - `sku` string, required
      - `ean` string, nullable: EAN-13 barcode (13 digits with valid GS1 prefix and checksum)
      - `hs_code` string, nullable
      - `name` string, nullable: Include only the product/design name. Don't add categories, colors, materials etc. If there is no specific design name, leave the field empty.
      - `description` string, nullable: Use descriptions instead
      - `descriptions` LocalizedDescriptionSchema: Schema for handling localized descriptions with locale keys.
      - `color` integer, required: ID (integer) of this property
      - `size` integer, nullable, required: ID (integer) of this property
      - `second_size` integer, nullable: ID (integer) of this property
      - `brand` integer, required: ID (integer) of this property
      - `category` integer, required: ID (integer) of this property
      - `quantity` integer, nullable: Quantity of the product variant.
      - `weight` integer, required: Weight of the product in grams.
      - `countries` string[], nullable
      - `country_of_origin` string, required: ISO 3166-1 alpha-2 country code
      - `attributes` integer[], required: Additional category-specific attribute IDs; fields already provided as top-level fields (e.g. size, brand, color) can not be repeated here.
      - `material_composition_textile` MaterialCompositionTextileSchema[], nullable
        - `cluster_id` integer, required: ID (integer) of this property
        - `components` TextileMaterialSchema[], required
          - `material_id` integer, required: ID (integer) of this property
          - `fraction` integer, required: Fraction of the material in the composition in percentage.
      - `material_composition_non_textile` MaterialCompositionNonTextileSchema[], nullable
        - `cluster_id` integer, required: ID (integer) of this property
        - `components` NonTextileMaterialSchema[], required
          - `material_id` integer, required: ID (integer) of this property
      - `prices` PriceSchema[], required
        - `country_code` string, required: ISO 3166-1 alpha-2 country code
        - `retail_price` number, required
        - `sale_price` number, nullable
      - `images` string[], required
    - `success` boolean, required
    - `errors` string[], required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `default`

---

[API](https://skmtc.dev/aboutyou/apis/sellers-center-api.md) - [All operations](https://skmtc.dev/aboutyou/apis/sellers-center-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aboutyou/apis/sellers-center-api/revisions/578d18d6e63c?raw)