# Get a restocking shipment

Returns a specific restocking shipment.

Endpoint: GET /restocking_shipments/{id}
Version: 2.0.0
Security: BearerAuth

## Path parameters:

  - `id` (integer, required)
    Restocking Shipment ID

## Response 200 fields (application/json):

  - `arrived_at` (string,null)
    When the shipment was arrived

  - `barcode` (string,null)
    The barcode of the shipment

  - `created_at` (string)
    When the shipment was created

  - `delivery_option` (string)
    Delivery option for the restocking shipment. Possible values:
- courier: Delivered by courier service
- dropoff: Dropped off at designated location
- hive_freight: Delivered using Hive freight service
- postal: Delivered via postal service
    Enum: "courier", "dropoff", "hive_freight", "postal"

  - `estimated_arrival_date` (string,null)
    Estimated arrival date

  - `id` (integer, required)
    Hive's unique identifier

  - `po_number` (string,null)
    Purchase order number

  - `restocking_shipment_items` (array, required)
    A list of items in the shipment. See RestockingShipmentItem.

  - `restocking_shipment_items.announced_quantity` (integer)
    Quantity of this item in the shipment

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

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

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

  - `restocking_shipment_items.remarks` (string,null)
    Free text for remarks

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

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

  - `restocking_shipment_items.total_cost_in_cents` (integer,null)
    Cost in cents

  - `status` (string, required)
    Restocking shipment status. Possible values:
  - arrived: Hive completed the arrival documentation, checked packing slip, picture of shipment and documents are uploaded
  - cancelled: the restocking shipment is cancelled by merchant
  - created: the restocking shipment is created and not yet shipped
  - processing: the restocking shipment is getting unpacked and its items are getting restocked into storage boxes and pallets
  - received: the restocking shipment is delivered to the fulfillment center, but its content is not verified yet
  - restocked: the restocking shipment is fully processed in the fulfillment center and its items are completely restocked
  - shipped: initial status meaning that restocking shipment is on the way
    Enum: "arrived", "cancelled", "created", "processing", "received", "restocked", "shipped"

  - `supplier_name` (string,null)
    Supplier name

  - `tracking_code` (string,null)
    Shipment tracking code

  - `updated_at` (string)
    When the shipment was last updated

  - `warehouse_id` (integer, required)
    The ID of the Hive destination warehouse

## 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 404 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