--- title: "API Reference: Quickstart" description: "BloodCOMM API Reference: Quickstart" --- [Skip to content](https://info.deltadevteam.com/bloodcomm-api-reference-quickstart#main-content) [Customer Support Portal](https://tickets.deltadevteam.com/portal?hsLang=en) [![DDTResourceCenter](https://info.deltadevteam.com/hs-fs/hubfs/DDTResourceCenter.png?width=204&height=72&name=DDTResourceCenter.png)](https://info.deltadevteam.com/?hsLang=en) - [Hardware Support Ticket](https://info.deltadevteam.com/technical-support-hardware) - [BloodCOMM Support Ticket](https://info.deltadevteam.com/technical-support-software) Open main navigation Close main navigation - [Hardware Support Ticket](https://info.deltadevteam.com/technical-support-hardware) - [BloodCOMM Support Ticket](https://info.deltadevteam.com/technical-support-software) - [Customer Support Portal](https://tickets.deltadevteam.com/portal) - [deltadevteam.com](https://deltadevteam.com/) [deltadevteam.com](https://deltadevteam.com/) Welcome to the DDT Resource Center. Use the search below to find articles, or click on a category. - There are no suggestions because the search field is empty. 1. [Delta Development Resource Center](https://info.deltadevteam.com/?hsLang=en) 2. [BloodCOMM](https://info.deltadevteam.com/bloodcomm?hsLang=en) 3. [API Reference](https://info.deltadevteam.com/bloodcomm?hsLang=en#api-reference) April 30, 2026 # API Reference: Quickstart To start you need the following: - A Valid ![ENTERPRISE](https://img.shields.io/badge/ENTERPRISE-darkgreen) license. - An API key (preferably from the sandbox) It is recommended that the `` you start with is `/sandbox`. ##### Software partners: > There are additional instructions for authentication available within your BloodCOMM API settings - your requests will fail unless the correct data is supplied with every request. --- ###### 1\. Test Authentication ![HTTPS GET](https://img.shields.io/badge/https-GET-green) ![Output Text](https://img.shields.io/badge/response-Text/Plain-blue?color=lightgrey) Send a request to `/` to verify that your application is able to talk to BloodCOMM, and to test your authentication process. | Method | Content Type | Response | | --- | --- | --- | | `GET` | Returns authentication result | Plain Text | For example, a cURL request would be: ``` curl -H "Authorization: Bearer " https://api.blood.dev/sandbox/ ``` A successful result would look like: ``` ===========================================================================+| || ____ _ _ ____ ___ __ __ __ __ _ ____ ___ || | __ )| | ___ ___ __| |/ ___/ _ \| \/ | \/ | / \ | _ \_ _| || | _ \| |/ _ \ / _ \ / _ | | | | | | |\/| | |\/| | / _ \ | |_) | | || | |_) | | (_) | (_) | (_| | |__| |_| | | | | | | | / ___ \| __/| | || |____/|_|\___/ \___/ \__,_|\____\___/|_| |_|_| |_| /_/ \_\_| |___| || |+===========================================================================+Get started at: https://docs.blood.dev/apiAPI Key valid: VALID API KEY ``` ###### 2. Get a list of available devices ![HTTPS GET](https://img.shields.io/badge/https-GET-green) ![Output JSON](https://img.shields.io/badge/response-JSON-lightgrey?color=lightgrey) ![BloodCOMM PRO](https://img.shields.io/badge/BloodCOMM-PRO-red?color=red) ![BloodCOMM PREMIUM](https://img.shields.io/badge/BloodCOMM-PREMIUM-blue?color=blue) Send a GET request to `/devices` to get a list of all available devices within your organization. | Method | Description | Response | | --- | --- | --- | | `GET` | Returns an array of devices | JSON Array | For example, a cURL request would be: ``` curl -H "Authorization: Bearer " https://api.blood.dev/sandbox/devices ```   Response: | Method | Description | | --- | --- | | `serial` | Device Serial Number | | `type` | Device Type | | `license` | Device License\* | | `nickname` | Optional Device Nickname | | `teams` | Optional list of Team UUIDs, for use with the Teams API | > *This request will return all registered cloud devices, including those that are not currently active or those which do not have a valid subscription.* Take note of the license status for each device, as only the following can be used for further queries: `PRO`, `PRO_TRIAL`, `PREMIUM`, `PREMIUM_TRIAL`. Expired or otherwise unlicensed devices will not return data. ``` [ { "serial": , "type": , "license": , "nickname": , "teams":[] }, ...] ```   ###### 3. Request Dashboard Data for a Single Device ![HTTPS GET](https://img.shields.io/badge/https-GET-green) ![Output JSON](https://img.shields.io/badge/response-JSON-lightgrey?color=lightgrey) ![BloodCOMM PRO](https://img.shields.io/badge/BloodCOMM-PRO-red?color=red) ![BloodCOMM PREMIUM](https://img.shields.io/badge/BloodCOMM-PREMIUM-blue?color=blue) Send a GET request for a single device to see the current, realtime status of that device. Use the below format, using the `type` and `serial` vlaues returned in the above step. > `/devices/dashboard//` | Method | Description | Response | | --- | --- | --- | | `GET` | Returns a single device's status | JSON Object | For example, a cURL request would be: ``` curl -H "Authorization: Bearer " https://api.blood.dev/sandbox/devices/ICE-002L/1ABCDE ``` Response: | Method | Description | Units | | --- | --- | --- | | `temperature` | Current Cooler Temperature | °C | | `duration` | Duration remaining until Excursion | hours | | `timestamp` | Last recorded timestamp | seconds | | `battery` | Current battery percentage | % | ``` { "temperature": , "duration": , "timestamp": , "battery": ,} ``` - [APRU 6L](https://info.deltadevteam.com/apru-6l?hsLang=en) - [ICE 2L](https://info.deltadevteam.com/ice-2l?hsLang=en) - [BloodCOMM](https://info.deltadevteam.com/bloodcomm?hsLang=en#main-content) - [Overview](https://info.deltadevteam.com/bloodcomm?hsLang=en#overview) - [Bluetooth connectivity](https://info.deltadevteam.com/bloodcomm?hsLang=en#bluetooth-connectivity) - [Organization](https://info.deltadevteam.com/bloodcomm?hsLang=en#organization) - [Device Dashboard](https://info.deltadevteam.com/bloodcomm?hsLang=en#device-dashboard) - [Device Reports](https://info.deltadevteam.com/bloodcomm?hsLang=en#device-reports) - [Blood Dashboard](https://info.deltadevteam.com/bloodcomm?hsLang=en#blood-dashboard) - [Cold Chain Events](https://info.deltadevteam.com/bloodcomm?hsLang=en#cold-chain-events) - [Blood Reports](https://info.deltadevteam.com/bloodcomm?hsLang=en#blood-reports) - [GPS Dashboard](https://info.deltadevteam.com/bloodcomm?hsLang=en#gps-dashboard) - [Metrics Dashboard](https://info.deltadevteam.com/bloodcomm?hsLang=en#metrics-dashboard) - [User Preferences](https://info.deltadevteam.com/bloodcomm?hsLang=en#user-preferences) - [Alerts](https://info.deltadevteam.com/bloodcomm?hsLang=en#alerts) - [Device Manager](https://info.deltadevteam.com/bloodcomm?hsLang=en#device-manager) - [Subscriptions](https://info.deltadevteam.com/bloodcomm?hsLang=en#subscriptions) - [Integrations](https://info.deltadevteam.com/bloodcomm?hsLang=en#integrations) - [Legal](https://info.deltadevteam.com/bloodcomm?hsLang=en#legal) - [API Reference](https://info.deltadevteam.com/bloodcomm?hsLang=en#api-reference) - [Cybersecurity & Trust](https://info.deltadevteam.com/cybersecurity-trust?hsLang=en) - [Procurement & Pricing](https://info.deltadevteam.com/procurement-pricing?hsLang=en) - [Support & Service](https://info.deltadevteam.com/support-service?hsLang=en) [![DDT\_Logo\_White](https://info.deltadevteam.com/hs-fs/hubfs/DDT_Logo_White.png?width=194&height=56&name=DDT_Logo_White.png "DDT_Logo_White")](https://info.deltadevteam.com/?hsLang=en) [Contact Us](https://deltadevteam.com/contact-us) Copyright © 2026, Delta Development Team, Inc. [Privacy Policy](https://deltadevteam.com/privacy-policy/)