Skip to content

Bulk Orders

You can retrieve information for bulk orders that includes shipping information, shipping status, and a complete manifest of the devices/Gateways included in a bulk order. The schema used in the return for this endpoint mimics the same schema used in the Special/Bulk Order Webhook with additional information on shipping address, name, etc.

For detailed information on this API endpoint and it’s schema, please see our API Reference documentation.

Retrieve Multiple Bulk Orders

Using the GET hwi-bulk-orders endpoint, you can retrieve information for all your bulk orders.

/hwi/hwi-bulk-orders/

Using query parameters you can narrow your scope to show only fulfilled bulk orders or orders yet to be fulfilled.

/hwi/hwi-bulk-orders/?fulfilled=true

All returns from this endpoint are paginated and you can control the page size using a query parameter.

/hwi/hwi-bulk-orders/?fulfilled=true&page_size=50

Retrieve Single Bulk Order

You can also use this API endpoint to fetch information on a single bulk order by passing the bulk order ID in the URL path.

/hwi/hwi-bulk-orders/{id}/

Example JSON Returns

Multiple Bulk Orders

{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": "e48235ab-0358-4b03-bf4a-f69222cbc854",
"created": "2025-08-26T07:10:29.171784Z",
"modified": "2025-08-26T07:14:30.299655Z",
"order_number": "SO-25020",
"shipping_name": "Dr. Ian Russell",
"shipping_address": "1 Cate St #100",
"shipping_city": "Portsmouth",
"shipping_state": "NH",
"shipping_zip_code": "03801",
"shipping_status": "SH",
"shipping_tracking_link": "https://tenovi.com",
"fulfilled": true,
"requested_by": "no-reply@tenovi.com",
"shipped_on": "2025-08-26T07:14:29.498353Z",
"delivered_on": null,
"notify_emails": null,
"contents": [
{
"name": "Gateway",
"quantity": 10,
"kit_id": 0
}
],
"manifest": [
{
"loose_items": [
{
"imei": null,
"gateway_id": "000011113333",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113332",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113331",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113334",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113335",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113336",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113337",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113338",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113339",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113323",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
}
],
"kitted_items": [],
"order_section": "Loose Items"
}
]
}
]
}

Single Bulk Orders

{
"id": "e48235ab-0358-4b03-bf4a-f69222cbc854",
"created": "2025-08-26T07:10:29.171784Z",
"modified": "2025-08-26T07:14:30.299655Z",
"order_number": "SO-25020",
"shipping_name": "Dr. Ian Russell",
"shipping_address": "1 Cate St #100",
"shipping_city": "Portsmouth",
"shipping_state": "NH",
"shipping_zip_code": "03801",
"shipping_status": "SH",
"shipping_tracking_link": "https://tenovi.com",
"fulfilled": true,
"requested_by": "no-reply@tenovi.com",
"shipped_on": "2025-08-26T07:14:29.498353Z",
"delivered_on": null,
"notify_emails": null,
"contents": [
{
"name": "Gateway",
"quantity": 10,
"kit_id": 0
}
],
"manifest": [
{
"loose_items": [
{
"imei": null,
"gateway_id": "000011113333",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113332",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113331",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113334",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113335",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113336",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113337",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113338",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113339",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
},
{
"imei": null,
"gateway_id": "000011113323",
"device_type": "Gateway",
"mac_address": "",
"model_number": null
}
],
"kitted_items": [],
"order_section": "Loose Items"
}
]
}