Skip to content
Tenovi Docs

Ordering Supplies with ASR API

You can request new supply orders for a patient to ensure they never run out of supplies for their devices. For a complete listing of all the types of supply see the Supply Types documentation.

All the methods described below will use the same API endpoint:

/asr/supply-requests

Retrieve List of All Supply Orders

You can retrieve a list of all your supply orders using the GET method. This will return an array of objects with order information such as supply type and shipping information. You can narrow this response using two query parameters.

  • fulfilled - will only return orders that have been shipped already

More detail about this API endpoint can be found in our ASR API Reference.

Create a New Supply Request

To request a specific supply, you must use the exact supply_name parameter along with the shipping information for where you want the supply to be sent using the POST method.

Once a request is fulfilled, you will automatically be billed for the item at the end of your month. You can view all pending invoices on your Tenovi dashboard under client billing.

We recommend you always include the Gateway ID (for Gateway-connected devices) or IMEI (for direct-cellular devices) associated with the patient for whom you are requesting supplies in each request. This will help ensure that the proper supply type is sent to that patient based on their activated devices. For example, some glucometer strips only work with a certain glucometer type. Our fulfillment team will be able to look this information up by Gateway ID when completing a request, if it is included.

You can optionally set the related_client_device_id property with an HWI Device ID. This connects the supply order with the device for tracking purposes and enables Tenovi to validate the supply type you are requesting is compatible with the device.

More detail about this API endpoint can be found in our ASR API Reference.

Example JSON for Creating a Request

{
  "supply_name": "Tenovi Glucometer Strips & Lancets (100 Pack)",
  "gateway_id": "123412341234",
  "imei": "",
  "shipping_name": "John Doe",
  "shipping_address": "100 Cate St",
  "shipping_city": "Portsmouth",
  "shipping_state": "NH",
  "shipping_zip_code": "03528",
  "notify_emails": "orders@domain.tld",
  "related_client_device_id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Delete a Pending Supply Request

You can remove a pending request using the DELETE method on this endpoint.

More detail about this API endpoint can be found in our API Reference.