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.

Note

Bulk orders can only be placed via the Tenovi Web App. The following information describes how to work with bulk orders that have already been placed in the web app.

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}/

Shipping Status Fields

Bulk order responses include the following read only shipment fields:

Field	Description
shipping_status	The current order status. This endpoint can return In Transit when the carrier reports that status.
estimated_delivery_date	The carrier’s current estimated delivery date, if available.
in_transit_on	The date and time the shipment first entered In Transit, if available.
out_for_delivery_on	The date and time the shipment first entered Out for Delivery, if available.
shipping_status_details	A nullable detail string supplied by the carrier through EasyPost.

Allow new shipping status values

Following a correction to the endpoint’s status mapping, In Transit is a newly returned status on hwi-bulk-orders. Integrations that validate shipping_status against a fixed list or raise an error for an unrecognized value must add support for it.

shipping_status_details is an opaque value passed through from EasyPost’s status_detail, not a Tenovi enum. Tenovi does not map or normalize its contents. It can be null, varies by carrier, and may change without notice. The field is safe to display or log, but it should not be used for conditional logic, reason level filtering, or analytics.

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-29T07:45:00.000000Z",
            "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": "Out for Delivery",
            "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,
            "estimated_delivery_date": "2025-08-29",
            "in_transit_on": "2025-08-27T10:32:11.000000Z",
            "out_for_delivery_on": "2025-08-29T07:45:00.000000Z",
            "shipping_status_details": "Out for delivery, expected by 8:00 PM",
            "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-29T07:45:00.000000Z",
  "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": "Out for Delivery",
  "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,
  "estimated_delivery_date": "2025-08-29",
  "in_transit_on": "2025-08-27T10:32:11.000000Z",
  "out_for_delivery_on": "2025-08-29T07:45:00.000000Z",
  "shipping_status_details": "Out for delivery, expected by 8:00 PM",
  "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"
      }
  ]
}