Skip to content

Get a kitting request

Request

Returns a specific kitting request.

Security
BearerAuth
Path
idinteger, (int64)required

Kitting request ID

curl -i -X GET \
  'https://hive-merchant-api.redocly.app/_mock/merchant-api-v2/mapi_v2_oas31/kitting_requests/{id}' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

A kitting request

Bodyapplication/json
completed_atstring or null, (date-time)read-onlyrequired

When the produced kits were restocked and the request completed; null until then

componentsArray of objects(KittingRequestComponent)read-onlyrequired

The component SKUs one kit is assembled from, in the order of the kit definition

created_atstring, (date-time)read-onlyrequired

When the kitting request was created

idinteger, (int64)read-onlyrequired

Hive's unique identifier for this kitting request

kit_definition_idinteger, (int64)read-onlyrequired

The kit definition (components and assembly instructions) this request uses; pass it to POST /kitting_requests to request the same kit again

produced_quantityinteger or null, (int32)read-onlyrequired

Number of kits produced and restocked; null until the request is completed

production_date_requiredbooleanread-onlyrequired

Whether the warehouse records a production date for the produced kits (only for kit SKUs with batch tracking)

quantityinteger, (int32)read-onlyrequired

Number of kits requested

restocking_shipment_idinteger or null, (int64)read-onlyrequired

The restocking shipment, created with the request, that brings the produced kits back into stock and is readable through GET /restocking_shipments/{id}; null for requests created before November 2025

sku_codestring or nullread-onlyrequired

The merchant's SKU identifier of the kit SKU being produced

sku_idinteger, (int64)read-onlyrequired

Hive's SKU identifier of the kit SKU being produced

statusstring(KittingRequestStatus)read-onlyrequired

Status of the kitting request. Possible values:

  • requested: Created and waiting for Hive's review of the kit
  • approved: Reviewed by Hive and waiting for the components to be picked
  • processing: The components are being picked and assembled, or the kits are being restocked
  • completed: The produced kits are back in stock; produced_quantity holds their number
  • cancelled: The request was cancelled
Enum:"requested""approved""processing""completed""cancelled"
updated_atstring, (date-time)read-onlyrequired

When the kitting request was last updated

warehouse_idinteger, (int64)read-onlyrequired

The ID of the warehouse that assembles the kits

Response
{
  "id": 11842,
  "status": "completed",
  "quantity": 500,
  "produced_quantity": 498,
  "production_date_required": false,
  "warehouse_id": 4,
  "sku_id": 586004,
  "sku_code": "GIFTBOX-XMAS",
  "kit_definition_id": 9311,
  "components": [
    { … },
    { … }
  ],
  "restocking_shipment_id": 66241,
  "created_at": "2026-09-01T09:12:44.512+02:00",
  "updated_at": "2026-09-04T16:03:10.871+02:00",
  "completed_at": "2026-09-04T16:03:10.000+02:00"
}