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

# List item movements

> Get stock movement history for the specified item.



## OpenAPI

````yaml /openapi.json get /items/{itemId}/movements
openapi: 3.0.1
info:
  title: Connector
  version: '1.0'
  description: Manage orders, articles, inbounds, shipments and returns in The Connector.
  contact:
    name: Quivo Support
    email: support@quivo.co
    url: https://quivo.co
  license:
    name: Proprietary
    url: https://quivo.co/terms
  termsOfService: https://quivo.co/terms
servers:
  - url: https://api.quivo.co/v2
    description: Production API server for Quivo Connector
security:
  - bearerAuth: []
tags:
  - name: addresses
    description: Manage stored addresses in the seller's address book
  - name: articles
    description: Create and manage product articles
  - name: bundles
    description: Manage product bundles
  - name: carriers
    description: Get carrier information
  - name: contacts
    description: Manage contact information
  - name: countries
    description: Get country information
  - name: currencies
    description: Get currency information
  - name: customerInquiries
    description: Manage customer inquiries
  - name: files
    description: Manage file uploads and downloads
  - name: fulfillmentPlans
    description: Manage fulfillment plans
  - name: inbounds
    description: Manage inbound shipments
  - name: invoices
    description: List and download invoices
  - name: items
    description: Monitor and manage inventory items
  - name: languages
    description: Get language information
  - name: orders
    description: Create and manage fulfillment orders
  - name: ping
    description: Health check endpoint
  - name: returnApp
    description: Manage return applications
  - name: returnLinks
    description: Manage return links
  - name: returns
    description: Manage returns
  - name: sellers
    description: Get seller information
  - name: shipments
    description: Book and manage shipments
  - name: shippingServiceGroups
    description: Get shipping service groups
  - name: shopOrders
    description: Manage shop orders
  - name: shops
    description: Manage shops
  - name: status
    description: Get system status
  - name: storedAddresses
    description: Manage stored addresses
  - name: subscriptionPackages
    description: Manage subscription packages
  - name: subscriptions
    description: Manage webhook subscriptions
  - name: transports
    description: Manage transport services
  - name: warehouses
    description: Get warehouse information
paths:
  /items/{itemId}/movements:
    get:
      tags:
        - items
      summary: List item movements
      description: Get stock movement history for the specified item.
      operationId: itemGetMovements
      parameters:
        - name: itemId
          in: path
          required: true
          schema:
            type: integer
            format: int64
          description: The unique identifier for an inventory item.
        - name: page
          in: query
          schema:
            type: integer
            format: int64
          description: >-
            The page number to retrieve when using offset-based pagination.
            Ignored if 'searchAfter' is provided.
        - name: pageSize
          in: query
          schema:
            type: integer
            format: int64
          description: >-
            The maximum number of items to return per page. Used for both offset
            and cursor-based pagination.
        - name: movementFrom
          in: query
          schema:
            type: string
          description: >-
            The start date/time for filtering item history movements. Format:
            ISO 8601 datetime.
        - name: movementTo
          in: query
          schema:
            type: string
          description: >-
            The end date/time for filtering item history movements. Format: ISO
            8601 datetime.
        - name: nextPageToken
          in: query
          schema:
            type: string
        - name: includeInternal
          in: query
          description: Also return internal storage relocations (Qore only); off by default
          schema:
            type: boolean
      responses:
        '200':
          description: >-
            Returns the stock movement history for the specified item, including
            chronological records of movements, allocations, and adjustments
            with timestamps.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ItemMovements'
        '400':
          description: >-
            Bad request - the request payload is invalid, missing required
            fields, or contains invalid data.
        '401':
          description: >-
            Unauthorized - authentication credentials are missing, invalid, or
            expired.
        '404':
          description: >-
            Not found - the requested resource does not exist or is not
            accessible.
        '500':
          description: Internal server error - an unexpected error occurred on the server.
components:
  schemas:
    ItemMovements:
      type: object
      properties:
        warehouseName:
          type: string
          description: The name of the warehouse
        itemMovements:
          type: array
          items:
            $ref: '#/components/schemas/ItemMovementGet'
          description: Array of item movement
        nextPageToken:
          type: string
      description: >-
        Detailed movement history for an inventory item. Contains chronological
        records of stock movements, allocations, and adjustments.
    ItemMovementGet:
      type: object
      properties:
        movementDate:
          type: string
          format: date
          description: The movement date
        warehouseIdentifier:
          type: string
          description: The unique identifier for the warehouseentifier
        reference:
          type: string
          description: Reference number or identifier for the item
        adjustmentQuantity:
          type: integer
          format: int32
          description: Quantity or amount
        movementType:
          type: string
          enum:
            - ORDER
            - MOVEMENT
            - ADJUSTMENT
            - RETURN
            - INBOUND
        typeReference:
          type: string
        lot:
          type: string
        expirationDate:
          type: string
          format: date
        movementAt:
          type: string
          format: date-time
        storage:
          type: string
        serialNumbers:
          type: array
          items:
            type: string
        carton:
          type: boolean
      description: Response object containing itemmovement details
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Access token from POST /v2/oauth2/token, requested with an API
        credential. See https://api-docs.quivo.co/api-reference/authentication.

````

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