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

# Get Stock Batch Results

`GET /api/v1/results/stocks`

## 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/stocks/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

- StockBatchResultsResponseSchema
  - `batchRequestId` string, uuid, required: Unique identifier (UUID)
  - `status` 'pending' | 'processing' | 'completed' | 'retry' | 'failed', required
  - `items` UpdateStockResultItemSchema[], required: List of result items for stock update
    - `requestItem` UpdateStockItemSchema, required
      - `sku` string, required: Stock Keeping Unit identifier
      - `quantity` integer, required: Quantity to update
      - `valid_at` string, date-time, nullable: Merchant-reported timestamp indicating when this stock data was valid. Used for stale data detection to prevent older updates from overwriting newer data.
    - `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)