BioTrack API
BioTrack is a cannabis seed-to-sale platform that powers both government state traceability systems and commercial cultivation, processing, and dispensary point-of-sale software. An unofficial API lets you programmatically pull plants, harvests, inventory, sales, and compliance records—and push updates like new packages, transfers, sales reporting, and inventory adjustments back into BioTrack.
What is BioTrack?
BioTrack is a cannabis seed-to-sale platform that powers both government state traceability systems and commercial software for licensed operators. Cannabis businesses use BioTrack to track plants and harvests through cultivation, record compliance data through processing and manufacturing, and run dispensary point-of-sale—while state regulators use its traceability system to monitor product movement across the supply chain. BioTrack software operates across 38 states, Puerto Rico, and internationally in Canada, Colombia, Jamaica, Australia, New Zealand, the Netherlands, and South Africa.
Core product areas include:
- Cultivation (custom plant tags, clone-to-mother linking, strain genealogy and potency tracking, 16-digit plant identifiers)
- Processing & Manufacturing (compliance data capture, automated porting of required information to product labels)
- Dispensary Point-of-Sale (purpose-built cannabis POS with hardware integration to reduce data entry and human error)
- Government Seed-to-Sale (free web-based state traceability system used by regulators for compliance monitoring)
- Integrations (accounting, CRM, e-commerce, delivery, dispensary analytics, and payment tools connected to the POS)
Common data entities:
- Plants, Clones, Strains, Harvests, Batches
- Inventory Packages, Lots, Product Labels, Lab Results
- Sales Transactions, Receipts, Customers/Patients, Loyalty
- Manifests, Transfers, Vendors, Licenses, Locations
- Compliance Reports, Inventory Adjustments, Audit Records
The BioTrack Integration Challenge
Cannabis operators run mission-critical compliance and sales workloads on BioTrack daily, but turning its traceability and POS workflows into reliable API-driven automation is non-trivial:
- State-by-state variation: BioTrack runs as both a commercial product and the contracted state traceability system, and required fields, reporting rules, and endpoints differ across the 38 states and international markets it serves
- Two surfaces, two object models: The commercial cultivation/processing/POS suite and the government traceability system expose different IDs, lifecycle states, and data shapes that have to be reconciled
- Credential and access gates: API access to the traceability system is governed by per-license credentials and state regulator approval, complicating headless automation
- Compliance-critical writes: Sales reporting, package creation, transfers, and inventory adjustments must hit narrow regulatory windows with precise tag, weight, and reason-code handling
- 16-digit tag handling: Plant, package, and inventory identifiers must be tracked precisely through cultivation, processing, and sale to avoid traceability discrepancies
- Real-time reporting expectations: Regulators and operators expect near real-time sync of inventory, sales, and movement events, so batch exports and manual entry fall short
How Supergood Creates BioTrack APIs
Supergood reverse-engineers authenticated BioTrack flows—across the commercial cultivation, processing, and dispensary POS suite and the state traceability system—to deliver a resilient, normalized API layer for your licenses and locations.
- Handles username/password and MFA securely, with per-license credential management
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across plants, inventory, sales, and compliance entities so you integrate once and rely on consistent objects across states
- Aligns with state-specific traceability rules, required fields, and reporting windows to keep writes compliant
Use BioTrack with AI agents: BioTrack MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, states/licenses, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready BioTrack adapter tailored to your commercial and traceability surfaces.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as BioTrack and state rules evolve.
API Endpoints
Authentication
/authenticateAuthenticate to a BioTrack license using username/password or MFA and obtain a session token for downstream calls.
Cultivation
/plantsList plants, clones, and harvests with filters for strain, phase, location, and 16-digit plant identifier.
Inventory
/inventoryRetrieve inventory packages, lots, lab results, and quantities across cultivation, processing, and dispensary locations.
Inventory
/create_packageCreate a new inventory package or lot from a harvest or processed batch with required tag, weight, and product data.
Sales
/salesPull sales transactions, receipts, and customer/patient records with date, location, and product filters.
Compliance
/report_saleReport a completed sale or inventory adjustment to the state traceability system within the required reporting window.
Use Cases
Sync inventory and sales to BI and accounting
- Pull packages, lots, and lab results from cultivation, processing, and dispensary locations into a single warehouse - Stream sales transactions and receipts to downstream BI, accounting, and analytics tools - Reconcile inventory counts against state traceability records to surface discrepancies early
Automate state compliance reporting
- Report completed sales and inventory adjustments to the traceability system within required windows - Push package creation, transfers, and manifests without manual portal entry - Validate tags, weights, and reason codes before submission to avoid rejected reports
Track plants from seed to sale
- Pull plant, clone, and harvest data with 16-digit identifiers and strain genealogy - Link clones to mothers and monitor potency and phase transitions through cultivation - Trigger downstream workflows when plants move from harvest into processing or inventory
Power omnichannel retail and customer tools
- Sync customer/patient, loyalty, and purchase-limit data into CRM and marketing platforms - Feed real-time inventory and pricing into e-commerce and delivery storefronts - Surface sales and product-mix analytics across multiple dispensary locations
Technical Specifications
Authentication
Username/password and MFA handled in a managed session, with per-license credential management
Connectivity
Authenticated flows across BioTrack's commercial cultivation/processing/POS suite and the state traceability system
Response format
Normalized JSON across plants, inventory, sales, and compliance objects
Rate limits
Adaptive throttling tuned to your licenses and state systems to avoid platform-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for inventory, sales, and plant movement with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for sales, package creation, transfers, and inventory adjustments
Latency
Sub-second reads on cached entities; multi-second writes when posting compliance reports and transfers
Throughput
Horizontally scaled workers sized to multi-location, multi-state retail and cultivation volume
Reliability
Retry, backoff, and idempotency keys for sales reporting, package creation, and inventory adjustments
Adaptation
Continuous monitoring of BioTrack releases and state-specific traceability rule changes
Frequently asked questions
Yes. Supergood works across BioTrack's commercial cultivation, processing, and dispensary POS suite as well as the government state traceability system, normalizing plants, inventory, sales, and compliance entities into one consistent API surface.
Each license is profiled against its state's required fields, reporting rules, and endpoints. Supergood preserves state-specific lifecycle states and reporting windows rather than forcing a single generic schema across the 38 states BioTrack serves.
Yes. Supergood can push completed sales, package creation, transfers, and inventory adjustments to the traceability system within required windows, validating tags, weights, and reason codes before submission.
Supergood works with your existing BioTrack license credentials and authenticated sessions. Any regulator-side approvals or per-license API credentials required by your state still apply; we operate against the surfaces you are already entitled to use.
Tags are preserved end to end across cultivation, processing, and sale so plant, package, and inventory identifiers stay consistent and traceability discrepancies are easy to detect.