--- title: "API Reference: Blood Bags" description: BloodCOMM API - Blood --- [Skip to content](https://info.deltadevteam.com/bloodcomm-api-blood#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) June 8, 2026 # API Reference: Blood Bags Blood Bag API Access is available in **SANDBOX** & **BETA**. Blood bags are identified using **ISBT 128** encoding — an international standard for blood product labeling. The `din`, `productCode`, `expirationDate`, and `bloodType` fields are returned in their raw ISBT 128 format, exactly as scanned (including identifier characters). The DIN (Donor Identification Number) serves as the unique identifier for each unit and always begins with `=`. **PREMIUM license required.** All `/blood` routes require a BloodCOMM PREMIUM license. Requests from organizations without a PREMIUM license receive a `402` response. ###### Blood Bag Fields | Field | Description | Format | | --- | --- | --- | | `din` | Donation Identification Number — unique identifier for this unit | ISBT 128 string | | `productCode` | Blood product code identifying the component type | ISBT 128 string | | `expirationDate` | Expiration date/time of this unit | ISBT 128 string | | `bloodType` | ABO/Rh blood type | ISBT 128 string | | `status` | Current lifecycle status | See status table below | | `location` | Current location of the unit. Format is `_` when stored in a Delta device | Device Identifier or generic name | | `updated` | Timestamp of the last status update | seconds since unix epoch | | `organization` | Organization currently holding this unit | `{ uuid, name }` | ###### Status Values | Status | Description | | --- | --- | | `NEW` | Registered, not yet checked in to a device | | `CHECKED_IN` | Currently stored in a Delta device — temperature is being tracked | | `CHECKED_OUT` | Checked out to an external cooler or transport device | | `SHIPPED` | In transit via tracked shipment | | `EXTERNAL` | Held by an external organization | | `TRANSFUSED` | Transfusion complete | | `RETURNED` | Returned to blood bank | | `DISCARDED` | Discarded | | `UNKNOWN` | Status could not be determined | --- #### `/blood`  ![](https://img.shields.io/badge/https-GET-green) ![](https://img.shields.io/badge/response-JSON-lightgrey?color=lightgrey)  ![](https://img.shields.io/badge/BloodCOMM-PREMIUM-blue?color=blue) Returns all blood bags registered to your organization. By default, only active units are returned (TRANSFUSED, RETURNED, and DISCARDED are excluded). > **Result limit:** A maximum of 250 bags are returned per request. If your result set exceeds this limit, the API returns a `400` error with a suggestion to narrow the query using `status` or a date range filter. | Method | Response | | --- | --- | | GET | JSON Array | ### Query Parameters | Parameter | Type | Description | | --- | --- | --- | | `status` | string | Filter to a specific status. If omitted, active-only bags are returned. | | `start` | integer | Start of date range (unix seconds). Requires `end`. | | `end` | integer | End of date range (unix seconds). Requires `start`. | ### Request Examples ``` https://api.blood.dev/v1/blood https://api.blood.dev/v1/blood?status=CHECKED_IN https://api.blood.dev/v1/blood?start=1738300000&end=1738400000 ``` ### Response ``` [ { "din": , "productCode": , "expirationDate": , "bloodType": , "status": ,   "updated": , "location": , "organization": { "uuid": , "name": } }, ...] ``` --- #### `/blood/` ![](https://img.shields.io/badge/https-GET-green) ![](https://img.shields.io/badge/response-JSON-lightgrey?color=lightgrey)  ![](https://img.shields.io/badge/BloodCOMM-PREMIUM-blue?color=blue) Returns a single blood bag by DIN. The `=` prefix is optional in the URL — both `/blood/A99991234567800` and `/blood/=A99991234567800`resolve to the same unit. Returns `404` if the DIN does not exist or does not belong to your organization. These cases are intentionally indistinguishable. | Method | Response | | --- | --- | | GET | JSON Object | ### Request Example ``` https://api.blood.dev/v1/blood/A99991234567800 ``` ### Response ``` { "din": , "productCode": , "expirationDate": , "bloodType": , "status": ,   "updated": , "location": , "organization": { "uuid": , "name": } } ``` - [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/)