# List inventory transfer orders

Returns all inventory transfer orders for the merchant.

See the Pagination section in the API overview above for details on how pagination works.

Endpoint: GET /inventory_transfer_orders
Version: 2.0.0
Security: BearerAuth

## Query parameters:

  - `limit` (integer)
    Number of items to return per page (for pagination)

  - `created_at[gt]` (string)
    Filter results created after this date (ISO 8601 format)

  - `created_at[lt]` (string)
    Filter results created before this date (ISO 8601 format)

  - `created_at[gte]` (string)
    Filter results created on or after this date (ISO 8601 format)

  - `created_at[lte]` (string)
    Filter results created on or before this date (ISO 8601 format)

## Response 200 fields (application/json):

  - `data` (array)

  - `data.completed_at` (string,null)
    When the inventory transfer order was completed

  - `data.created_at` (string, required)
    When the inventory transfer order was created

  - `data.destination_id` (integer, required)
    The ID of the destination warehouse

  - `data.documents` (array, required)
    List of documents associated with the inventory transfer order

  - `data.documents.id` (integer, required)
    Document ID

  - `data.documents.name` (string,null, required)
    Document name

  - `data.documents.url` (string, required)
    Document URL

  - `data.id` (integer, required)
    Hive's unique identifier for this inventory transfer order

  - `data.items` (array, required)
    List of items in the inventory transfer order

  - `data.items.id` (integer, required)
    Hive's unique identifier for this item

  - `data.items.inventory_batch` (object,null)

  - `data.items.inventory_batch.expiry_date` (string,null)
    Expiration date of the batch

  - `data.items.inventory_batch.id` (integer, required)
    Batch ID

  - `data.items.inventory_batch.name` (string, required)
    Batch name

  - `data.items.quantity` (integer, required)
    The quantity of this item to transfer

  - `data.items.sku_code` (string, required)
    The merchant's SKU identifier - required if sku_id is not provided

  - `data.items.sku_id` (integer, required)
    Hive's SKU identifier - required if sku_code is not provided

  - `data.order` (object,null, required)

  - `data.order.id` (integer,null)
    Order ID

  - `data.order.status` (string,null)
    Order status

  - `data.order_notes` (string,null)
    Notes for the inventory transfer order

  - `data.origin_id` (integer, required)
    The ID of the origin warehouse

  - `data.restocking_shipments` (array, required)
    List of restocking shipments associated with the inventory transfer order

  - `data.restocking_shipments.estimated_arrival_date` (string,null)
    Estimated arrival date

  - `data.restocking_shipments.id` (integer, required)
    Restocking shipment ID

  - `data.restocking_shipments.items` (array, required)
    Items in the restocking shipment

  - `data.restocking_shipments.items.announced_quantity` (integer)
    Quantity of this item in the shipment

  - `data.restocking_shipments.items.arrived_quantity` (integer, required)
    Arrived quantity of this item (after shipment is received)

  - `data.restocking_shipments.items.damaged_quantity` (integer, required)
    Damaged quantity of this item (after shipment is received)

  - `data.restocking_shipments.items.id` (integer)
    Hive's unique identifier

  - `data.restocking_shipments.items.missing_quantity` (integer, required)
    Missing quantity of this item (after shipment is received)

  - `data.restocking_shipments.items.remarks` (string,null)
    Free text for remarks

  - `data.restocking_shipments.items.sku_id` (integer, required)
    Hive SKU identifier - required if sku_code is not provided

  - `data.restocking_shipments.items.total_cost_in_cents` (integer,null)
    Cost in cents

  - `data.restocking_shipments.status` (string, required)
    Restocking shipment status

  - `data.restocking_shipments.tracking_code` (string,null)
    Tracking code

  - `data.restocking_shipments.tracking_url` (string,null)
    Tracking URL

  - `data.shipments` (array, required)
    List of shipments associated with the inventory transfer order

  - `data.shipments.id` (integer, required)
    Shipment ID

  - `data.shipments.issues` (array, required)
    Issues with the shipment

  - `data.shipments.items` (array, required)
    Items in the shipment

  - `data.shipments.items.id` (integer, required)
    Shipment item ID

  - `data.shipments.items.quantity` (integer, required)
    Quantity in the shipment

  - `data.shipments.items.sku_code` (string, required)
    The merchant's SKU code

  - `data.shipments.items.sku_id` (integer, required)
    The SKU ID

  - `data.shipments.restocking_shipment` (object)

  - `data.shipments.status` (string, required)
    Shipment status

  - `data.status` (string, required)
    Status of the inventory transfer order. Possible values:
- pending: Initial status when the transfer order is created
- created: The transfer order has been created and is ready for processing
- processing: The transfer order is currently being processed
- completed: The transfer order has been successfully completed
- cancelled: The transfer order has been cancelled
    Enum: "pending", "created", "processing", "completed", "cancelled"

  - `data.updated_at` (string, required)
    When the inventory transfer order was last updated

  - `pagination` (object)

  - `pagination.first_page_url` (string)
    URL to fetch the first page of results

  - `pagination.limit` (integer)
    Number of items returned per page

  - `pagination.next_page_url` (string,null)
    URL to fetch the next page of results. If null, there are no more results.

## Response 401 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 403 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 429 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code