> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blazemonitors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Item Restocks

> Gets when products restocked, newest first, with the price of what restocked. Products that Blaze can't find are left out.



## OpenAPI

````yaml GET /items/restocks
openapi: 3.0.0
info:
  title: Companion API
  version: 2.0.0
  description: Companion API for Blaze Monitors
servers:
  - url: https://api.blazemonitors.com
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Items
    description: Monitored product management
  - name: Products
    description: Product search and discovery
  - name: Monitor
    description: Site monitoring information
  - name: Stores
    description: Monitored store management
paths:
  /items/restocks:
    get:
      tags:
        - Items
      summary: List Item Restocks
      description: >-
        Gets when products restocked, newest first, with the price of what
        restocked. Products that Blaze can't find are left out.
      parameters:
        - name: site
          in: query
          required: true
          schema:
            type: string
          example: walmart
        - name: item
          in: query
          required: true
          description: Product SKU or identifier. Repeat for up to 100 items.
          style: form
          explode: true
          schema:
            type: array
            minItems: 1
            maxItems: 100
            items:
              type: string
          example:
            - '5113183757'
        - name: days
          in: query
          required: false
          description: How many days back to include.
          schema:
            type: integer
            minimum: 1
            maximum: 365
            default: 90
      responses:
        '200':
          description: Each found item's restocks, keyed by the item as requested
          content:
            application/json:
              schema:
                type: object
                properties:
                  site:
                    $ref: '#/components/schemas/Site'
                  results:
                    type: object
                    additionalProperties:
                      type: object
                      properties:
                        restocks:
                          type: array
                          description: Empty when the item hasn't restocked in the window.
                          items:
                            type: object
                            properties:
                              restockedAt:
                                type: integer
                                format: int64
                                description: When it restocked, in epoch milliseconds.
                              price:
                                type: number
                                description: >-
                                  The price it restocked at. Set for items
                                  without sellers, variants or stores.
                              offers:
                                type: array
                                description: >-
                                  The sellers whose offers restocked, each at
                                  its price.
                                items:
                                  type: object
                                  properties:
                                    sellerId:
                                      type: string
                                      example: Walmart.com
                                    price:
                                      type: number
                                      example: 29.97
                              variants:
                                type: array
                                description: >-
                                  The sizes or colours that restocked, each at
                                  its price.
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    sizeLabel:
                                      type: string
                                      example: '10'
                                    colorLabel:
                                      type: string
                                      example: Black
                                    width:
                                      type: string
                                      example: Wide
                                    price:
                                      type: number
                                      example: 120
                              stores:
                                type: array
                                description: >-
                                  The stores it restocked at, with what
                                  restocked there: its sizes or colours, each at
                                  its price, or the price for items without
                                  them. Sites where you choose stores list only
                                  your monitored stores.
                                items:
                                  type: object
                                  properties:
                                    storeId:
                                      type: string
                                      example: '2005'
                                    price:
                                      type: number
                                      example: 39.99
                                    variants:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          id:
                                            type: string
                                          sizeLabel:
                                            type: string
                                            example: '10'
                                          colorLabel:
                                            type: string
                                            example: Black
                                          width:
                                            type: string
                                            example: Wide
                                          price:
                                            type: number
                                            example: 120
        '400':
          description: No items, more than 100, or days out of range
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Site:
      type: object
      properties:
        platformName:
          type: string
          example: amazon
        siteId:
          type: string
          example: amazon.com
        siteName:
          type: string
          example: AmazonUS
        siteUrl:
          type: string
          example: https://amazon.com
        siteCurrency:
          type: string
          example: USD
        capabilities:
          $ref: '#/components/schemas/SiteCapabilities'
        queryType:
          type: string
          example: productSku
        notificationTypes:
          type: array
          items:
            type: string
          example:
            - Restock
        altNames:
          type: array
          items:
            type: string
          example:
            - amazon
            - amz
            - amzus
        sellers:
          type: array
          items:
            type: string
          description: Seller IDs the site supports.
          example:
            - Amazon.com
      required:
        - platformName
        - siteId
        - siteName
        - siteUrl
        - siteCurrency
        - capabilities
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
        message:
          type: string
    SiteCapabilities:
      type: object
      properties:
        lists:
          type: boolean
          example: true
        products:
          type: boolean
          example: true
        releases:
          type: boolean
          example: false
        sellers:
          type: boolean
          example: false
        stores:
          type: boolean
          example: false
          description: Alerts cover only the stores your workspace monitors.
      required:
        - lists
        - products
        - releases
        - sellers
        - stores
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: API key for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.