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

# List inventory

> Retrieve a list of inventory items for the specified retailer.



## OpenAPI

````yaml dropship_inventory.openapi get /v1/retailers/{retailer_id}/inventory/
openapi: 3.0.0
info:
  title: Dropship Inventory API
  version: 1.0.0
  description: >
    Endpoints to retrieve and view Dropship retailer inventory and inventory
    history.
servers:
  - url: https://marketplace-api.fabric.inc
    description: Production server
security:
  - Bearer: []
tags:
  - name: Inventory
    description: Inventory status and history
paths:
  /v1/retailers/{retailer_id}/inventory/:
    get:
      tags:
        - Inventory
      summary: List inventory
      description: Retrieve a list of inventory items for the specified retailer.
      parameters:
        - name: retailer_id
          in: path
          required: true
          description: >-
            The unique retailer ID. In the Dropship UI this is called the
            **Merchant ID**. To find your Merchant ID, click your merchant name
            in the top nav.
          schema:
            type: integer
            example: 1001
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                required:
                  - count
                  - results
                type: object
                properties:
                  count:
                    description: Total number of records
                    example: 2231
                    type: integer
                  next:
                    description: Next page (applicable in a paginated response)
                    example: https://api.example.org/demo/accounts/?page=2
                    type: string
                    format: uri
                    nullable: true
                  previous:
                    description: Previous page (applicable in a paginated response)
                    example: https://api.example.org/demo/accounts/?page=1
                    type: string
                    format: uri
                    nullable: true
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/InventoryHistory'
components:
  schemas:
    InventoryHistory:
      type: object
      required:
        - inventory
      properties:
        id:
          description: Unique identifier for the inventory history record
          example: 9876
          type: integer
          readOnly: true
        updated_at:
          description: Timestamp of when this inventory record was updated
          example: '2024-04-18T14:22:00Z'
          type: string
          format: date-time
          readOnly: true
        inventory:
          description: Inventory level associated with the record
          example: 50
          type: integer
          minimum: -2147483648
          maximum: 2147483647
        event:
          description: Type of event that caused the inventory change (e.g., restock, sale)
          example: restock
          type: string
          readOnly: true
        location:
          description: Inventory location where the event occurred
          example: Main Warehouse
          type: string
          readOnly: true
        user:
          description: User responsible for the inventory update
          example: admin@example.com
          type: string
          readOnly: true
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer

````