Distru API

Stay Up To Date

To stay up to date with the latest breaking changes to the Distru public API, please sign up for our email list.

Overview

Distru's public API allows you to easily access and manipulate your data in our system automatically.

Integrate your supply chain with the rest of your business Build your own custom connectors that support your most important workflows.
Extend your reports Take data from Distru and pipe it into other systems for a unified view of your business.
Maximize your efficiency Automate tasks based on changes in your distribution, manufacturing, and sales.

Base URL

All API requests should be made to the base URL: https://app.distru.com

Getting Started

To integrate with Distru, you'll need to contact a representative that will can enable your account's API access. From there, have a look at the following information on how to authenticate with Distru.

Authentication

An admin user can generate API keys in the Distru app by following these steps.

Steps:

Log in to Distru with your admin account.
Navigate to the Settings page from the left menu.
Click on Distru API under the Integrations section.
Use the Create API Key option to generate your API token.

Models

Strain

A strain as shown in Distru

{
  "id": "12345",
  "name": "Strain 123"
}

Property	Description	Type	Required
id	Unique ID for this strain	string	false
name	Name of the strain	string	false

StockAdjustments

A collection of Stock Adjustments

Property	Description	Type	Required

Product

A product as shown in Distru

{
  "brand": {
    "name": "Brand 123"
  },
  "category": {
    "id": "89c8323f-aaaa-45v3-88f9-64009d68h3n8",
    "name": "Super Dank Buds"
  },
  "external_name": "Blue Dream Preroll",
  "id": "02c88a3f-d759-4973-88f9-60049d682524",
  "images": [
    {
      "id": "12345",
      "name": "image.jpg",
      "url": "https://example.com/image.jpg"
    }
  ],
  "is_active": true,
  "msrp": 100.1,
  "name": "Blue Dream Preroll 1G",
  "sku": "BDP-1G",
  "unit_price": 1.5,
  "unit_type": {
    "name": "Gram"
  },
  "units_per_case": 6
}

Property	Description	Type	Required
brand	A brand as shown in Distru	Brand	false
category	A product category as shown in Distru	ProductCategory	false
company	A company as shown in Distru	Company	false
custom_data	The custom data for this product	array(CustomField)	false
description	The description of this product	string	false
description_markdown	The description of this product in markdown format	string	false
external_name	Customer-facing name for DistruCommerce menus and Order Tracker	string	false
id	Unique ID for this product	string	false
images	The images associated with the product	array(Image)	false
is_active	Is this product active?	boolean	false
msrp	The MSRP of the product	number	false
name	Human readable name for this product	string	false
sku	The SKU configured for the product	string	false
strain	A strain as shown in Distru	Strain	false
subcategory	A product subcategory as shown in Distru	ProductSubcategory	false
unit_price	The price of one unit of this product	number	false
unit_type	A unit type as shown in Distru	UnitType	false
units_per_case	The number of units of this product that come in one case, if any	number	false
updated_datetime	The datetime this product was last updated at	string	false

AdditionalCost

An additional cost for an assembly as shown in Distru

Property	Description	Type	Required
cost_per_unit	The cost per unit of the additional cost	number	false
description	The description of the additional cost	string	false
name	The name of the additional cost	string	false
quantity	The quantity of the additional cost	number	false
total_cost_actual	The total actual cost of the additional cost	number	false
total_cost_default	The total default cost (from the configured cost type) of the additional cost	number	false
unit_type	A unit type as shown in Distru	UnitType	false

Products

A collection of Products

Property	Description	Type	Required

CompanyGroup

A company group as shown in Distru

{
  "id": "12345",
  "name": "Group 123"
}

Property	Description	Type	Required
id	Unique ID for this company group	string	false
name	Name of the company group	string	false

Assembly

An assembly as shown in Distru

Property	Description	Type	Required
completion_datetime	The datetime this assembly was completed at	string	false
compliance_type	The compliance type for this assembly. Options include METRC, BIOTRACK or NONE	string	false
creation_source	The creation source for this assembly	string	false
custom_data	The custom data for this assembly	array(CustomField)	false
description	The description for this assembly	string	false
estimated_work_hours	The estimated work hours for this assembly	integer	false
estimated_work_minutes	The estimated work minutes for this assembly	integer	false
fulfilled	True if all assembly inputs have been fulfilled with batches or packages, false otherwise.	boolean	false
id	Unique ID for this assembly	string	false
is_metrc_processing_job	True if this assembly is associated with a Metrc processing job, false otherwise	boolean	false
license	The license number for this assembly	string	false
outputs	The outputs for this assembly	array(AssemblyOutput)	false
owner_id	The ID of the user that owns this assembly	string	false
status	The status of this assembly	string	false

OrderItemsRequest

A collection of Order item params

Property	Description	Type	Required

Locations

A collection of Locations

Property	Description	Type	Required

Charge

A line representing a Tax, Discount, or Charge added to an order

Property	Description	Type	Required
id	Unique ID for this charge	string	false
name	The name for this charge	string	false
percent	The percent to charge for this line if it is a percentage	number	false
price	The price of this line if it is a flat charge	number	false
type	What type of additional line is this	array(any)	false
unit_type	Determines if this line is tracked as a percentage or a flat charge	array(any)	false
tax.id	Unique ID for this Tax	string	false
tax.name	The name of this tax	string	false
tax.percent	The amount of tax levied	string	false

Strains

A collection of Strains. Note: This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Property	Description	Type	Required

Role

A user role as shown in Distru

{
  "id": "12345",
  "name": "Admin"
}

Property	Description	Type	Required
id	Unique ID for this role	string	false
name	Name of the role	string	false

OrderTransferTemplateTransporterInfoRequest

A Metrc-specific Order transfer template transporter info

Property	Description	Type	Required
driver_license_number	The driver's license number	string	false
driver_name	The driver's name	string	false
driver_occupational_license_number	The driver's occupational license number	string	false
driver_phone_number	The driver's phone number	string	false
transporter_license_number	The transporter's license number	string	false
vehicle_license_plate_number	The vehicle's license plate number	string	false
vehicle_make	The vehicle's make	string	false
vehicle_model	The vehicle's model	string	false

InvoiceItemsRequest

A collection of invoice item params

Property	Description	Type	Required

InvoiceItem

A invoice line item as shown in Distru

Property	Description	Type	Required
batch	A batch for a product as shown in Distru	Batch	false
id	Unique ID for this invoice item	string	false
package	A package as shown in Distru	Package	false
price	Price per unit of this invoice item	number	false
product	A product as shown in Distru	Product	false
quantity	Quantity used on this invoice item	number	false
returned_quantity	Quantity returned on this invoice item. This is the sum of all return items associated with this invoice item allocated proportionally based on the quantity

of the invoice item relative to its associated order item. For example, if an invoice item with a quantity of 1 has an order item with a quantity of 2, and a return item with a quantity of 2, the returned_quantity would be 1, calculated as (1 ÷ 2) × 2. |number|false| |total_cost_actual|Total cost of the non-returned quantity in this order item, in other words, this is the total cost of order_item.quantity minus order_item.returned quantity. The cost is allocated proportionally based on the quantity of the invoice item relative to its associated order item. For example, if an invoice item with a quantity of 1 has an order item with a quantity of 2 and a total cost of $10, the total_cost_actual would be $5, calculated as (1 ÷ 2) × $10. |number|false| |total_cost_default|Default cost of the non-returned quantity in this order item, in other words, this is the default cost of order_item.quantity minus order_item.returned quantity. The cost is allocated proportionally based on the quantity of the invoice item relative to its associated order item. For example, if an invoice item with a quantity of 1 has an order item with a quantity of 2 and a total cost of $10, the total_cost_default would be $5, calculated as (1 ÷ 2) × $10. |number|false|

RelationshipType

A relationship type as shown in Distru

{
  "id": "12345",
  "name": "Supplier"
}

Property	Description	Type	Required
id	Unique ID for this relationship type	string	false
name	Name of the relationship type	string	false

OrderItemRequest

Order item params

Property	Description	Type	Required
batch_id	The ID of the batch (if the product is batch-tracked)	string	false
id	Unique ID for this order item. If it exists, an update will be performed; otherwise, it will be used as the ID of a new order item record	string	false
package_id	The ID of the package (if the product is package-tracked)	string	false
price_base	Price per unit of this order item (prior to price tier items being applied)	number	true
product_id	The ID of the product (if the product is product-tracked)	string	false
quantity	Quantity used on this order item	number	true

Batch

A batch for a product as shown in Distru

Property	Description	Type	Required
id	Unique ID for this batch	string	false
name	Human readable name for this batch	string	false

TestResults

A collection of Test Results

Property	Description	Type	Required

PurchaseChargesRequest

A collection of Invoice charge params

Property	Description	Type	Required

PurchaseItemRequest

Purchase item params

Property	Description	Type	Required
batch_id	The ID of the batch (if the product is batch-tracked)	string	false
id	Unique ID for this order item. If it exists, an update will be performed; otherwise, it will be used as the ID of a new invoice item record	string	false
price	Price per unit of the inventory being received on this line item	number	true
product_id	The ID of the product (if the product is product-tracked)	string	false
quantity	Quantity received in this order item	number	true

OrderTransferTemplateTransporterInfosRequest

A collection of Metrc-specific Order transfer template transporter info params

Property	Description	Type	Required

InvoiceChargesRequest

A collection of Invoice charge params

Property	Description	Type	Required

FileAttachment

A file attachment

Property	Description	Type	Required

PurchaseOrderItem

An order line item as shown in Distru

Property	Description	Type	Required
batch	A batch for a product as shown in Distru	Batch	false
id	Unique ID for this order item	string	false
package	A package as shown in Distru	Package	false
price	Price per unit of this order item (with discounts applied)	number	false
price_base	Price per unit of this order item	number	false
product	A product as shown in Distru	Product	false
quantity	Quantity used on this order item	number	false
received_quantity	Quantity received on this order item. Less than or equal to the quantity field	number	false

PageWithSize

Pagination information for a request

{
  "number": 1,
  "size": 100
}

Property	Description	Type	Required
number	Page number	integer	true
size	Amount of records per page	integer	true

InvoicePayment

An invoice payment as shown in Distru

{
  "amount": 100.0,
  "description": "Payment for invoice 12345",
  "id": "12345",
  "method_id": "12345",
  "payment_datetime": "2024-12-12 20:26:19.297537",
  "payment_number": "12345",
  "quickbooks_deposit_account_id": "12345"
}

Property	Description	Type	Required
amount	The amount of the payment	number	false
descriptiontime	The description of this payment	string	false
id	Unique ID for this invoice payment	string	false
invoice_id	The ID of the invoice this payment is for	string	false
method_id	The ID of the payment method used for this payment	string	false
payment_date	The date of this payment	string	false
payment_number	The payment number for this payment	string	false
quickbooks_deposit_account_id	The id of the Quickbooks deposit account used for this payment	string	false

InvoiceItemRequest

Invoice item params

Property	Description	Type	Required
id	Unique ID for this order item. If it exists, an update will be performed; otherwise, it will be used as the ID of a new invoice item record	string	false
order_item_id	The ID of order item with which this invoice item is associated	string	false
quantity	Quantity used on this order item	number	true

CustomField

A custom field as shown in Distru

{
  "id": "12345",
  "name": "Custom Field 1",
  "value": "Custom Field Value 1"
}

Property	Description	Type	Required
id	Unique ID for this custom field	string	false
name	The name of this custom field	string	false
value	The value of the custom field in the context of the object it's associated with	string	false

Image

An image as shown in Distru

{
  "id": "12345",
  "name": "image.jpg",
  "rank": 0,
  "url": "https://example.com/image.jpg"
}

Property	Description	Type	Required
id	Unique ID for this image	string	false
name	Name of the file for this image	string	false
rank	The rank of this image in the list of images for the product	integer	false
url	URL to the image file	string	false

User

Information about a user in Distru

{
  "banned": false,
  "email": "jeanb@zorgindustries.com",
  "full_name": "Jean-Baptiste Emanuel Zorg",
  "id": "12345",
  "role": "Admin"
}

Property	Description	Type	Required
banned	Is this user banned by Distru?	boolean	false
email	The email address of this user	string	false
full_name	The full name of this user	string	false
id	Unique ID for this user	string	false
role	A user role as shown in Distru	Role	false

AdditionalTestResult

An additional test result object for a test result as shown in Distru

Property	Description	Type	Required
chlorfenapyr_ug_per_g	Pesticide	string	false
dimethoxyethane_ug_per_g	Solvent	string	false
etofenprox_ug_per_g	Pesticide	string	false
formic_acid_ug_per_g	Other	string	false
cbda_percentage	Cannabinoid	string	false
methylcyclohexane_ug_per_g	Solvent	string	false
cadmium_ug_per_g	Heavy Metal	string	false
cbl_percentage	Cannabinoid	string	false
daminozide_ug_per_g	Pesticide	string	false
other_pesticides_ug_per_g	Pesticide	string	false
diazinon_ug_per_g	Pesticide	string	false
cannabinoids_mg_per_unit_total	Cannabinoid	string	false
methiocarb_ug_per_g	Pesticide	string	false
water_activity_aw	Water Activity	string	false
cbt_percentage	Cannabinoid	string	false
camphor_mg_per_unit	Terpene	string	false
hexythiazox_ug_per_g	Pesticide	string	false
linalool_mg_per_unit	Terpene	string	false
ethoprophos_ug_per_g	Pesticide	string	false
other_microbials_cfu_per_g	Microbial	string	false
cbt_mg_per_unit	Cannabinoid	string	false
ethylene_oxide_ug_per_g	Solvent	string	false
thcva_percentage	Cannabinoid	string	false
carbaryl_ug_per_g	Pesticide	string	false
acetone_ug_per_g	Solvent	string	false
ocimene_percentage	Terpene	string	false
nickel_ug_per_g	Heavy Metal	string	false
imidacloprid_ug_per_g	Pesticide	string	false
acetic_acid_ug_per_g	Other	string	false
beta_humulene_mg_per_unit	Terpene	string	false
cypermethrin_ug_per_g	Pesticide	string	false
pyrethrins_pyrethrin_ii_ug_per_g	Pesticide	string	false
camphene_percentage	Terpene	string	false
methoxybenzene_ug_per_g	Solvent	string	false
limonene_percentage	Terpene	string	false
nerolidol_percentage	Terpene	string	false
fenchol_percentage	Terpene	string	false
flonicamid_ug_per_g	Pesticide	string	false
alpha_cyfluthrin_ug_per_g	Pesticide	string	false
spinetoram_l_ug_per_g	Pesticide	string	false
clothianidin_ug_per_g	Pesticide	string	false
sabinene_percentage	Terpene	string	false
chlormequat_chloride_ug_per_g	Other	string	false
aflatoxins_ug_per_kg	Mycotoxin	string	false
ethanol_ug_per_g	Solvent	string	false
permethrin_trans_ug_per_g	Pesticide	string	false
ethyl_acetate_ug_per_g	Solvent	string	false
salmonella_cfu_per_g	Microbial	string	false
valencene_percentage	Terpene	string	false
beta_pinene_percentage	Terpene	string	false
caryophyllene_oxide_mg_per_unit	Terpene	string	false
pyridaben_ug_per_g	Pesticide	string	false
beta_caryophyllene_percentage	Terpene	string	false
oxamyl_ug_per_g	Pesticide	string	false
methyl_butanol_ug_per_g	Solvent	string	false
fenpyroximate_ug_per_g	Pesticide	string	false
delta_8_thc_mg_per_unit	Cannabinoid	string	false
cymene_percentage	Terpene	string	false
caryophyllene_oxide_percentage	Terpene	string	false
bifenthrin_ug_per_g	Pesticide	string	false
methomyl_ug_per_g	Pesticide	string	false
isopropyl_acetate_ug_per_g	Solvent	string	false
alpha_myrcene_mg_per_unit	Terpene	string	false
beta_cypermethrin_ug_per_g	Pesticide	string	false
terpinolene_percentage	Terpene	string	false
tert_butyl_methyl_ether_ug_per_g	Solvent	string	false
acetic_acid_percentage	Other	string	false
borneol_mg_per_unit	Terpene	string	false
mercury_ug_per_g	Heavy Metal	string	false
aflatoxin_g1_ug_per_kg	Mycotoxin	string	false
linalool_percentage	Terpene	string	false
pyrethrins_ug_per_g	Pesticide	string	false
beta_myrcene_mg_per_unit	Terpene	string	false
terpenes_percentage_total	Terpene	string	false
aflatoxin_b1_ug_per_kg	Mycotoxin	string	false
dimethyl_sulfoxide_ug_per_g	Solvent	string	false
naled_ug_per_g	Pesticide	string	false
spirotetramat_ug_per_g	Pesticide	string	false
boscalid_ug_per_g	Pesticide	string	false
geraniol_percentage	Terpene	string	false
cbc_mg_per_unit	Cannabinoid	string	false
butane_ug_per_g	Solvent	string	false
cumene_ug_per_g	Solvent	string	false
dimethomorph_ug_per_g	Pesticide	string	false
piperonylbutoxide_ug_per_g	Pesticide	string	false
moisture_percentage	Moisture	string	false
cbn_percentage	Cannabinoid	string	false
prallethrin_trans_ug_per_g	Pesticide	string	false
aspergillus_cfu_per_g	Microbial	string	false
lead_ug_per_g	Heavy Metal	string	false
ancymidol_ug_per_g	Pesticide	string	false
acephate_ug_per_g	Pesticide	string	false
dimethylformamide_ug_per_g	Solvent	string	false
candida_albicans_cfu_per_g	Microbial	string	false
nitromethane_ug_per_g	Solvent	string	false
pyrethrins_cinerin_i_ug_per_g	Pesticide	string	false
mevinphos_ii_ug_per_g	Pesticide	string	false
kresoxim_methyl_ug_per_g	Pesticide	string	false
spinetoram_j_ug_per_g	Pesticide	string	false
cyclohexane_ug_per_g	Solvent	string	false
alpha_phellandrene_percentage	Terpene	string	false
chloroform_ug_per_g	Solvent	string	false
beta_cyfluthrin_ug_per_g	Pesticide	string	false
borneol_percentage	Terpene	string	false
propyl_acetate_ug_per_g	Solvent	string	false
cyfluthrin_ug_per_g	Pesticide	string	false
fenhexamid_ug_per_g	Pesticide	string	false
cbdv_mg_per_unit	Cannabinoid	string	false
alpha_humulene_percentage	Terpene	string	false
pentachloronitrobenzene_ug_per_g	Pesticide	string	false
xylene_ug_per_g_total	Solvent	string	false
tebuconazole_ug_per_g	Pesticide	string	false
propiconazole_cis_ug_per_g	Pesticide	string	false
butanol_ug_per_g	Solvent	string	false
fenoxycarb_ug_per_g	Pesticide	string	false
antimony_ug_per_g	Heavy Metal	string	false
alpha_cypermethrin_ug_per_g	Pesticide	string	false
chromium_ug_per_g	Heavy Metal	string	false
zinc_ug_per_g	Heavy Metal	string	false
heptane_ug_per_g	Solvent	string	false
spiromesifen_ug_per_g	Pesticide	string	false
thca_percentage	Cannabinoid	string	false
spiroxamine_ug_per_g	Pesticide	string	false
nerolidol_mg_per_unit	Terpene	string	false
tetrahydrofuran_ug_per_g	Solvent	string	false
chlordane_cis_ug_per_g	Pesticide	string	false
propanol_ug_per_g	Solvent	string	false
yeast_cfu_per_g	Microbial	string	false
beta_caryophyllene_mg_per_unit	Terpene	string	false
enterobacteriacaea_cfu_per_g	Microbial	string	false
dimethoate_ug_per_g	Pesticide	string	false
pulegone_percentage	Terpene	string	false
vitamin_e_acetate_percentage	Other	string	false
pentanol_ug_per_g	Solvent	string	false
formic_acid_percentage	Other	string	false
isopulegol_percentage	Terpene	string	false
other_terpenes_mg_per_unit	Terpene	string	false
gamma_terpinene_percentage	Terpene	string	false
spinosad_d_ug_per_g	Pesticide	string	false
l_monocytogenes_cfu_per_g	Microbial	string	false
thiabendazole_ug_per_g	Pesticide	string	false
formamide_ug_per_g	Pesticide	string	false
ethyl_formate_percentage	Other	string	false
ethylene_glycol_ug_per_g	Other	string	false
methyl_propanol_ug_per_g	Solvent	string	false
eucalyptol_percentage	Terpene	string	false
alpha_myrcene_percentage	Terpene	string	false
thca_mg_per_unit	Cannabinoid	string	false
cbg_percentage	Cannabinoid	string	false
ethylene_glycol_percentage	Other	string	false
copper_ug_per_g	Heavy Metal	string	false
mold_cfu_per_g	Microbial	string	false
phytol_mg_per_unit	Terpene	string	false
thcv_percentage	Cannabinoid	string	false
phosmet_ug_per_g	Pesticide	string	false
trifloxystrobin_ug_per_g	Pesticide	string	false
dichloromethane_ug_per_g	Solvent	string	false
thcv_mg_per_unit	Cannabinoid	string	false
delta_8_thc_percentage	Cannabinoid	string	false
fenchol_mg_per_unit	Terpene	string	false
bifenazate_ug_per_g	Pesticide	string	false
cannabinoids_percentage_total	Cannabinoid	string	false
eucalyptol_mg_per_unit	Terpene	string	false
cbdv_percentage	Cannabinoid	string	false
dichloroethane_ug_per_g	Solvent	string	false
propiconazole_ug_per_g	Pesticide	string	false
paclobutrazol_ug_per_g	Pesticide	string	false
cbl_mg_per_unit	Cannabinoid	string	false
delta_3_carene_percentage	Terpene	string	false
myclobutanil_ug_per_g	Pesticide	string	false
dichlorvos_ug_per_g	Pesticide	string	false
pulegone_mg_per_unit	Terpene	string	false
butyl_acetate_ug_per_g	Solvent	string	false
aflatoxin_b2_ug_per_kg	Mycotoxin	string	false
isopulegol_mg_per_unit	Terpene	string	false
trichloroethylene_ug_per_g	Solvent	string	false
sulfolane_ug_per_g	Solvent	string	false
benzene_ug_per_g	Solvent	string	false
terpineol_mg_per_unit	Terpene	string	false
guaiol_percentage	Terpene	string	false
acetonitrile_ug_per_g	Solvent	string	false
chlordane_trans_ug_per_g	Pesticide	string	false
camphene_mg_per_unit	Terpene	string	false
alpha_humulene_mg_per_unit	Terpene	string	false
isopropanol_ug_per_g	Solvent	string	false
spinetoram_ug_per_g	Pesticide	string	false
chlorpyrifos_ug_per_g	Pesticide	string	false
permethrin_cis_ug_per_g	Pesticide	string	false
methyl_butyl_ketone_ug_per_g	Solvent	string	false
aspergillus_terreus_cfu_per_g	Microbial	string	false
aflatoxin_g2_ug_per_kg	Mycotoxin	string	false
metalaxyl_ug_per_g	Pesticide	string	false
alpha_terpinene_mg_per_unit	Terpene	string	false
spiroxamine_b_ug_per_g	Pesticide	string	false
dimethomorph_e_ug_per_g	Pesticide	string	false
tetralin_ug_per_g	Solvent	string	false
n_methylpyrrolidone_ug_per_g	Solvent	string	false
ethyl_formate_ug_per_g	Other	string	false
dinotefuran_ug_per_g	Pesticide	string	false
methanol_ug_per_g	Solvent	string	false
dimethylacetamide_ug_per_g	Solvent	string	false
fipronil_ug_per_g	Pesticide	string	false
flurprimidol_ug_per_g	Pesticide	string	false
dimethomorph_z_ug_per_g	Pesticide	string	false
m_and_p_xylene_ug_per_g	Solvent	string	false
sand_and_soil_and_cinders_and_dirt_percentage	Other	string	false
terpineol_percentage	Terpene	string	false
imazalil_ug_per_g	Pesticide	string	false
filth_and_foreign_material_percentage	Other	string	false
ethyl_ether_ug_per_g	Solvent	string	false
alpha_bisabolol_percentage	Terpene	string	false
acequinocyl_ug_per_g	Pesticide	string	false
cbda_mg_per_unit	Cannabinoid	string	false
permethrin_ug_per_g	Pesticide	string	false
cymene_mg_per_unit	Terpene	string	false
azoxystrobin_ug_per_g	Pesticide	string	false
malathion_ug_per_g	Pesticide	string	false
gamma_terpinene_mg_per_unit	Terpene	string	false
methyl_parathion_ug_per_g	Pesticide	string	false
clofentezine_ug_per_g	Pesticide	string	false
alpha_pinene_percentage	Terpene	string	false
terpenes_mg_per_unit_total	Terpene	string	false
alpha_terpinene_percentage	Terpene	string	false
coumaphos_ug_per_g	Pesticide	string	false
acetamiprid_ug_per_g	Pesticide	string	false
ocimene_mg_per_unit	Terpene	string	false
ethephon_ug_per_g	Pesticide	string	false
geraniol_mg_per_unit	Terpene	string	false
cbc_percentage	Cannabinoid	string	false
pyriproxyfen_ug_per_g	Pesticide	string	false
cbga_mg_per_unit	Cannabinoid	string	false
cbga_percentage	Cannabinoid	string	false
phytol_percentage	Terpene	string	false
chlordane_ug_per_g	Pesticide	string	false
beta_humulene_percentage	Terpene	string	false
terpinolene_mg_per_unit	Terpene	string	false
thcva_mg_per_unit	Cannabinoid	string	false
farnesene_mg_per_unit	Terpene	string	false
camphor_percentage	Terpene	string	false
lambda_cyhalothrin_ug_per_g	Pesticide	string	false
e_coli_cfu_per_g	Microbial	string	false
alpha_bisabolol_mg_per_unit	Terpene	string	false
valencene_mg_per_unit	Terpene	string	false
methoxyethanol_ug_per_g	Solvent	string	false
isobutyl_acetate_ug_per_g	Solvent	string	false
farnesene_percentage	Terpene	string	false
propiconazole_trans_ug_per_g	Pesticide	string	false
dioxane_ug_per_g	Solvent	string	false
chlorobenzene_ug_per_g	Solvent	string	false
alpha_phellandrene_mg_per_unit	Terpene	string	false
cbg_mg_per_unit	Cannabinoid	string	false
other_heavy_metals_ug_per_g	Heavy Metal	string	false
diuron_ug_per_g	Pesticide	string	false
delta_3_carene_mg_per_unit	Terpene	string	false
ethoxyethanol_ug_per_g	Solvent	string	false
aldicarb_ug_per_g	Pesticide	string	false
aspergillus_fumigatus_cfu_per_g	Microbial	string	false
captan_ug_per_g	Pesticide	string	false
chlorantraniliprole_ug_per_g	Pesticide	string	false
propane_ug_per_g	Solvent	string	false
hexane_ug_per_g	Solvent	string	false
other_terpenes_percentage	Terpene	string	false
pyrethrins_pyrethrin_i_ug_per_g	Pesticide	string	false
prallethrin_cis_ug_per_g	Pesticide	string	false
chlormequat_chloride_percentage	Other	string	false
spinosad_a_ug_per_g	Pesticide	string	false
pyrethrins_jasmolin_ii_ug_per_g	Pesticide	string	false
spiroxamine_a_ug_per_g	Pesticide	string	false
guaiol_mg_per_unit	Terpene	string	false
methyl_acetate_ug_per_g	Solvent	string	false
aspergillus_flavus_cfu_per_g	Microbial	string	false
etoxazole_ug_per_g	Pesticide	string	false
methylisobutyl_ketone_ug_per_g	Solvent	string	false
vitamin_e_acetate_ug_per_g	Other	string	false
pyrethrins_cinerin_ii_ug_per_g	Pesticide	string	false
cbn_mg_per_unit	Cannabinoid	string	false
prallethrin_ug_per_g	Pesticide	string	false
mgk_264_ug_per_g	Pesticide	string	false
arsenic_ug_per_g	Heavy Metal	string	false
limonene_mg_per_unit	Terpene	string	false
alpha_pinene_mg_per_unit	Terpene	string	false
mevinphos_ug_per_g	Pesticide	string	false
pyridine_ug_per_g	Solvent	string	false
thiamethoxam_ug_per_g	Pesticide	string	false
toluene_ug_per_g	Solvent	string	false
spinosad_ug_per_g	Pesticide	string	false
pentane_ug_per_g	Solvent	string	false
propoxur_ug_per_g	Pesticide	string	false
ochratoxin_a_ug_per_kg	Mycotoxin	string	false
fludioxonil_ug_per_g	Pesticide	string	false
beta_myrcene_percentage	Terpene	string	false
thiacloprid_ug_per_g	Pesticide	string	false
aspergillus_niger_cfu_per_g	Microbial	string	false
mevinphos_i_ug_per_g	Pesticide	string	false
sabinene_mg_per_unit	Terpene	string	false
other_solvents_ug_per_g	Solvent	string	false
carbofuran_ug_per_g	Pesticide	string	false
beta_pinene_mg_per_unit	Terpene	string	false
other_mycotoxins_ug_per_kg	Mycotoxin	string	false
pyrethrins_jasmolin_i_ug_per_g	Pesticide	string	false
methyl_ethyl_ketone_ug_per_g	Solvent	string	false

OrderChargeRequest

Order charge params

Property	Description	Type	Required
id	Unique ID for this order charge. If it exists, an update will be performed; otherwise, it will be used as the ID of a new order charge record	string	false
name	The ID of the batch (if the product is batch-tracked)	string	false
percent	The ID of the package (if the product is package-tracked)	number	false
price	The ID of the product (if the product is product-tracked)	number	false
type	What type of additional line is this	string	true
unit_type	Determines if this line is tracked as a percentage or a flat charge	string	true

PurchasePayment

A purchase payment as shown in Distru

{
  "amount": 100.0,
  "description": "Payment for invoice 12345",
  "id": "12345",
  "method_id": "12345",
  "payment_datetime": "2024-12-12 20:26:19.297537",
  "payment_number": "12345",
  "quickbooks_deposit_account_id": "12345"
}

Property	Description	Type	Required
amount	The amount of the payment	number	false
descriptiontime	The description of this payment	string	false
id	Unique ID for this purchase payment	string	false
method_id	The ID of the payment method used for this payment	string	false
payment_date	The date of this payment	string	false
payment_number	The payment number for this payment	string	false
purchase_id	The ID of the purchase this payment is for	string	false
quickbooks_deposit_account_id	The id of the Quickbooks deposit account used for this payment	string	false

Packages

A collection of Packages

Property	Description	Type	Required

StockAdjustment

A stock adjustment as shown in Distru

{
  "batch_id": "12345",
  "completion_datetime": "2024-12-12 20:26:19.297537",
  "compliance_quantity": 10,
  "description": "The description for this adjustment",
  "id": "12345",
  "license_id": "12345",
  "location_id": "12345",
  "owner_id": "12345",
  "package_id": "12345",
  "product_id": "12345",
  "quantity": 10,
  "reason": "Waste",
  "total_cost": 100
}

Property	Description	Type	Required
batch_id	The ID of this adjustment's batch. Null if this adjustment is not associated with a batch-tracked product	string	false
completion_datetime	The datetime this adjustment was completed at	datetime	false
compliance_quantity	The quantity of this adjustment expressed in it's package's unit type. Null if this adjustment is not associated with a package-tracked product.	number	false
description	The description for this adjustment	string	false
id	Unique ID for this stock adjustment	string	false
license_id	ID of the license that this adjustment is associated with	string	false
location_id	ID of the location that this adjustment is associated with	string	false
owner_id	The ID of the user that owns this adjustment	string	false
package_id	The ID of this adjustment's package. Null if this adjustment is not associated with a package-tracked product	string	false
product_id	The ID of this adjustment's product. Populated regardless of the product's inventory tracking method.	string	false
quantity	The quantity of the adjustment	number	false
reason	The reason for this adjustment	string	false
total_cost	The total cost of this adjustment	number	false

Batches

A collection of Batches

Property	Description	Type	Required

Inventory

{
  "active": "500.000000000",
  "available": "400.000000000",
  "batch_number": "1234",
  "location_id": "1764da45-c1be-425c-9b31-b860cdb93e98",
  "product_id": "67ae9080-8dc2-4ab7-9704-19673f4d9f21"
}

Property	Description	Type	Required
active	Active quantity	number	true
available	Available quantity (active - reserved)	number	true
batch_number	The batch number of the batch or the package	string	false
location_id	ID of the location	string	false
product_id	ID of the product	string	true

ProductPosMappingsResponse

Property	Description	Type	Required
data	List of POS mappings	array(ProductPosMapping)	false

Order

A sales order as shown in Distru. Ordered by order date

{
  "billing_location": {
    "address": "123 Compton Street, CA, USA, 12345",
    "id": "d06a5135-dccf-4d62-a922-804190213c10",
    "name": "Warehouse 1"
  },
  "charges": [
    {
      "id": "8h7512d2-g4h6-jj89-92h7-12f9ed9ls8f5",
      "name": "Friends and Family",
      "percent": -10,
      "type": "DISCOUNT",
      "unit_type": "PERCENT"
    },
    {
      "id": "duy67x9r-0d4k-mmk5-8u9u-l3k8ed9lj900",
      "name": "Excise Tax",
      "percent": 27,
      "tax": {
        "id": "9876",
        "name": "Excise Tax - CA 27%",
        "percent": 27.0
      },
      "type": "TAX",
      "unit_type": "PERCENT"
    },
    {
      "id": "ko38h9ju-ndn7-76h8-jio9-j98yhd93h6fh",
      "name": "Membership Fee",
      "price": 25.0,
      "type": "CHARGE",
      "unit_type": "PRICE"
    }
  ],
  "creator": {
    "banned": false,
    "email": "jeanb@zorgindustries.com",
    "full_name": "Jean-Baptiste Emanuel Zorg",
    "id": "3e98e590-85b6-4247-b2e9-96fc2f45802e"
  },
  "delivery_datetime": "2022‐07‐02T00:00:00Z",
  "due_datetime": "2022‐07‐02T00:00:00Z",
  "id": "193c12d2-bc68-46fa-a221-12f9ed958ef4",
  "inserted_datetime": "2022‐07‐02T00:00:00Z",
  "internal_notes": "Internal note example",
  "items": [
    {
      "id": "3e98e590-85b6-4247-b2e9-96fc2f45802e",
      "price": 0.006,
      "price_base": 0.006,
      "product": {
        "id": "4ec0ac89-a382-409c-ae67-4478e7e681ac",
        "name": "Crawdad Crippler - 1g - PreRoll",
        "sku": "WHODAT"
      },
      "quantity": 786
    }
  ],
  "order_datetime": "2022‐07‐02T00:00:00Z",
  "order_number": "SO-00012345",
  "shipping_location": {
    "address": "123 Compton Street, CA, USA, 12345",
    "id": "d06a5135-dccf-4d62-a922-804190213c10",
    "name": "Warehouse 1"
  },
  "status": "PENDING",
  "total": 150.23,
  "updated_datetime": "2022‐07‐02T00:00:00Z"
}

Property	Description	Type	Required
billing_location	A location as shown in Distru	Location	false
biotrack_id	The ID of the BioTrack manifest associated with this order	string	false
charges	A collection of Charges	array(Charge)	false
company	A company as shown in Distru	Company	false
creator	Information about a user in Distru	User	false
custom_data	A collection of CustomData	array(CustomData)	false
delivery_datetime	The datetime on which the order was / will be delivered	string	false
due_datetime	The datetime by which the order should be completed for the customer	string	false
id	Unique ID for this order	string	false
inserted_datetime	The datetime at which the order was created in Distru	string	false
internal_notes	Internal notes for this order	string	false
items	A collection of SalesOrderItems	array(SalesOrderItem)	false
leaflink_order_number	The LeafLink order number for this order	string	false
metrc_transfer_id	The ID of the Metrc transfer associated with this order	string	false
order_datetime	The datetime on which the order was placed	string	false
order_number	The order number as shown in the Distru UI	string	false
owner	Information about a user in Distru	User	false
shipping_location	A location as shown in Distru	Location	false
status	The status of this sales order	string	false
total	The total for this order including taxes, discounts, and all line items	number	false
updated_datetime	The datetime at which the order was last updated in Distru	string	false

ProductPosMappingResponse

Property	Description	Type	Required
data	A mapping between a Distru product and a POS product	ProductPosMapping	false

Contacts

A collection of Contacts

Property	Description	Type	Required

Page

Pagination information for a request

{
  "number": 1
}

Property	Description	Type	Required
number	Page number	integer	true

UpsertProductPosMapping

Parameters for creating or updating a POS mapping

{
  "blaze_product_id": "blaze_123",
  "blaze_retailer_id": "456e7890-e89b-12d3-a456-426614174000",
  "product_id": "123e4567-e89b-12d3-a456-426614174000"
}

Property	Description	Type	Required
blaze_product_id	Blaze product ID	string	false
blaze_retailer_id	Blaze retailer ID	string	false
dutchie_product_id	Dutchie product ID	integer	false
dutchie_retailer_id	Dutchie retailer ID	string	false
product_id	Distru product ID	string	true
treez_product_id	Treez product ID	string	false
treez_retailer_id	Treez retailer ID	string	false

Purchase

A purchase order as shown in Distru. Ordered by order date

{
  "charges": [
    {
      "id": "8h7512d2-g4h6-jj89-92h7-12f9ed9ls8f5",
      "name": "Friends and Family",
      "percent": -10,
      "type": "Discount",
      "unit_type": "Percent"
    },
    {
      "id": "duy67x9r-0d4k-mmk5-8u9u-l3k8ed9lj900",
      "name": "Excise Tax",
      "percent": 27,
      "tax": {
        "id": "9876",
        "name": "Excise Tax - CA 27%",
        "percent": 27.0
      },
      "type": "Tax",
      "unit_type": "Percent"
    },
    {
      "id": "ko38h9ju-ndn7-76h8-jio9-j98yhd93h6fh",
      "name": "Membership Fee",
      "price": 25.0,
      "type": "Charge",
      "unit_type": "Price"
    }
  ],
  "due_datetime": "2022‐07‐02T00:00:00Z",
  "id": "193c12d2-bc68-46fa-a221-12f9ed958ef4",
  "inserted_datetime": "2022‐07‐02T00:00:00Z",
  "items": [
    {
      "id": "3e98e590-85b6-4247-b2e9-96fc2f45802e",
      "price": 0.006,
      "product": {
        "id": "4ec0ac89-a382-409c-ae67-4478e7e681ac",
        "name": "Crawdad Crippler - 1g - PreRoll",
        "sku": "WHODAT"
      },
      "quantity": 786,
      "received_quantity": 786
    }
  ],
  "order_datetime": "2022‐07‐02T00:00:00Z",
  "purchase_number": "PO-00012345",
  "status": "Pending",
  "total": 150.23,
  "updated_datetime": "2022‐07‐02T00:00:00Z"
}

Property	Description	Type	Required
charges	A collection of Charges	array(Charge)	false
company	A company as shown in Distru	Company	false
creator	Information about a user in Distru	User	false
custom_data	The custom data for this purchase order	array(CustomField)	false
due_datetime	The datetime by which the order should be completed for the customer	string	false
id	Unique ID for this order	string	false
inserted_datetime	The datetime at which the order was created in Distru	string	false
items	A collection of PurchaseOrderItems	array(PurchaseOrderItem)	false
order_datetime	The datetime on which the order was placed	string	false
order_number	The order number as shown in the Distru UI	string	false
owner	Information about a user in Distru	User	false
status	The status of this purchase order	string	false
total	The total for this order including taxes, discounts, and all line items	number	false
updated_datetime	The datetime at which the order was last updated in Distru	string	false

PaymentMethod

A payment method as shown in Distru

{
  "id": "12345",
  "name": "Credit Card"
}

Property	Description	Type	Required
id	Unique ID for this payment method	string	false
name	Name of the payment method	string	false

Package

A package as shown in Distru

Property	Description	Type	Required
batch_number	The non-compliance batch number for this package	string	false
compliance_label	The compliance (e.g. Metrc) label for this package	string	false
id	Unique ID for this package in Distru	string	false
status	The status of this package	array(any)	false

BatchFull

Extended details about a batch for a product as shown in Distru

Property	Description	Type	Required
batch_number	The batch number for this batch	string	false
custom_data	The custom data for this batch	array(CustomField)	false
description	The description for this batch	string	false
expiration_date	The expiration date for this batch	string	false
id	Unique ID for this batch	string	false
name	Human readable name for this batch	string	false
owner_id	The ID of the user that owns this batch	string	false
product_id	The ID of the batch's product	string	false

Invoices

A collection of Invoices

Property	Description	Type	Required

ProductSubcategory

A product subcategory as shown in Distru

{
  "id": "88c02a3f-57d9-9473-f8f9-40609d68bbh4",
  "name": "High Grade Flower"
}

Property	Description	Type	Required
id	Unique ID for this subcategory	string	false
name	Human readable name for this subcategory	string	false

Orders

A collection of Orders

Property	Description	Type	Required

SalesOrderItem

An order line item as shown in Distru

Property	Description	Type	Required
batch	A batch for a product as shown in Distru	Batch	false
id	Unique ID for this order item	string	false
package	A package as shown in Distru	Package	false
price	Price per unit of this order item	number	false
product	A product as shown in Distru	Product	false
quantity	Quantity sold on this order item	number	false
returned_quantity	Quantity returned on this order item	number	false
total_cost_actual	Total cost of the non-returned quantity in this order item, in other words, this is the total cost of order_item.quantity minus order_item.returned quantity.	number	false
total_cost_default	Default cost of the non-returned quantity in this order item, in other words, this is the default cost of order_item.quantity minus order_item.returned quantity.	number	false

Assemblies

A collection of Assemblies

Property	Description	Type	Required

Invoice

An invoice as shown in Distru. Ordered by invoice date

{
  "creator": {
    "banned": false,
    "email": "jeanb@zorgindustries.com",
    "full_name": "Jean-Baptiste Emanuel Zorg",
    "id": "12345"
  },
  "due_datetime": "2022‐07‐02T00:00:00Z",
  "id": "193c12d2-bc68-46fa-a221-12f9ed958ef4",
  "inserted_datetime": "2022‐07‐02T00:00:00Z",
  "invoice_datetime": "2022‐07‐02T00:00:00Z",
  "invoice_number": "INV-00012345",
  "items": [
    {
      "id": "1",
      "price": 3.0,
      "product": {
        "id": "543",
        "name": "Crawdad Crippler - 1g - PreRoll",
        "sku": "WHODAT"
      },
      "quantity": 5
    }
  ],
  "order": {
    "id": "931c12d2-68bc-fa46-a221-12f9edcg5hd7",
    "order_number": "SO-0000657",
    "status": "Delivering",
    "total": 999.99
  },
  "status": "Pending",
  "total": 543.23,
  "updated_datetime": "2022‐07‐02T00:00:00Z"
}

Property	Description	Type	Required
charges	A collection of Charges	array(Charge)	false
company	A company as shown in Distru	Company	false
creator	Information about a user in Distru	User	false
custom_data	A collection of CustomData	array(CustomField)	false
due_datetime	The datetime by which the invoice should be paid by the customer	string	false
id	Unique ID for this invoice	string	false
inserted_datetime	The datetime at which the invoice was created in Distru	string	false
invoice_datetime	The datetime on which the invoice was placed	string	false
invoice_number	The invoice number as shown in the Distru UI	string	false
items	A collection of InvoiceItems	array(InvoiceItem)	false
owner	Information about a user in Distru	User	false
paid_amount	The payment amount recorded against this invoice so far.	number	false
status	The status of this invoice	string	false
total	The total for this invoice including taxes, discounts, and all line items	number	false
updated_datetime	The datetime at which the invoice was last updated in Distru	string	false
order.id	Unique ID for this order	string	false
order.order_number	The order number for this sale as seen in the Distru UI	string	false
order.status	Status of the associated order	string	false
order.total	The total on the order	number	false

PurchaseChargeRequest

Purchase charge params

Property	Description	Type	Required
id	Unique ID for this purchase charge. If it exists, an update will be performed; otherwise, it will be used as the ID of a new purchase charge record	string	false
name	The name of this charge	string	false
percent	The percent (if it is percent-based) of this charge	number	false
price	The flat price (if it is price-based) of this charge	number	false
type	Determines if this is a charge or discount	string	true
unit_type	Determines if this line is tracked as a percentage or a flat charge	string	true

PackageFull

A package with extended details as shown in Distru

Property	Description	Type	Required
batch_number	The non-compliance batch number for this package	string	false
compliance_label	The compliance (e.g. Metrc) label for this package	string	false
custom_data	The custom data for this package	array(CustomField)	false
expiration_date	The date that this package expires	string	false
id	Unique ID for this package in Distru	string	false
is_trade_sample	True if this package is a Metrc trade sample	boolean	false
license	A license as shown in Distru	License	false
product_unit_quantity	The quantity of this package expressed in it's product's unit type	string	false
product_unit_type	A unit type as shown in Distru	UnitType	false
quantity	The last known accurate quantity of this package	string	false
quantity_assembling	This quantity of this package currently allocated towards a pending assembly	string	false
quantity_available	The quantity available for use of this package (i.e. inventory that is not held up on a sales order or assembly.)	string	false
status	The status of this package	array(any)	false
unit_type	A unit type as shown in Distru	UnitType	false
location.id	Unique ID for this Location	string	false
location.name	The name of this Location	string	false

License

A license as shown in Distru

Property	Description	Type	Required
id	Unique ID for this license	string	false
license_number	License number	string	false

Purchases

A collection of Purchases

Property	Description	Type	Required

AssemblyOutput

An output for an assembly as shown in Distru

Property	Description	Type	Required
additional_costs	The additional costs for this assembly output	array(AdditionalCost)	false
batch	A batch for a product as shown in Distru	Batch	false
compliance_label	The compliance label for this assembly output	string	false
compliance_quantity	The quantity of this output expressed in the package's unit type. Null if this input is not package-tracked.	number	false
expiration_date	The expiration date for this assembly output	string	false
ingredients	The ingredients for this assembly output	array(AssemblyInput)	false
is_production_batch	Is this output a production batch?	boolean	false
location	A location as shown in Distru	Location	false
package	A package as shown in Distru	Package	false
package_date	The date that this package was created at	string	false
package_unit_type	A unit type as shown in Distru	UnitType	false
product	A product as shown in Distru	Product	false
quantity	The quantity of this output in its product's unit	number	false

PurchaseItemsRequest

A collection of purchase item params

Property	Description	Type	Required

Location

A location as shown in Distru

Property	Description	Type	Required
address	Human readable address for this location	string	false
company_id	ID of the company that owns this location	string	false
id	Unique ID for this location	string	false
license	A license as shown in Distru	License	false
license_id	ID of the license that this location is associated with, if null, then this location is not associated to a license	string	false
name	Human readable name for this location	string	false

TestResult

A test result as shown in Distru

Property	Description	Type	Required
additional_test_results	An additional test result object for a test result as shown in Distru	AdditionalTestResult	false
cbd_mg_per_unit	The CBD mg per unit for this test result	string	false
cbd_percentage	The CBD percentage for this test result	string	false
id	Unique ID for this test result	string	false
is_primary	True if this is the primary test result for the product	boolean	false
lab_license_number	The license number for the lab that performed this test	string	false
lab_name	The name of the lab that performed this test	string	false
mg_per_unit_type	The unit type for the mg per unit fields	string	false
name	The name of the test result	string	false
release_date	The release date for this test result	string	false
thc_mg_per_unit	The THC mg per unit for this test result	string	false
thc_percentage	The THC percentage for this test result	string	false
total_cbd_mg_per_unit	The total CBD mg per unit for this test result	string	false
total_cbd_percentage	The total CBD percentage for this test result	string	false
total_thc_mg_per_unit	The total THC mg per unit for this test result	string	false
total_thc_percentage	The total THC percentage for this test result	string	false
updated_datetime	The datetime this test result was updated at	string	false

ProductCategory

A product category as shown in Distru

{
  "id": "88c02a3f-57d9-9473-f8f9-40609d68bbh4",
  "name": "Flower",
  "type": "FLOWER"
}

Property	Description	Type	Required
id	Unique ID for this category	string	false
name	Human readable name for this category	string	false
type	The type of this category	string	false

OrderChargesRequest

A collection of Order charge params

Property	Description	Type	Required

Contact

Information about a contact in Distru's CRM

{
  "company": {
    "id": "3f128a34-cc59-4b49-8883-23bf10e59c6c"
  },
  "email": "contact@example.com",
  "full_name": "John Doe",
  "id": "12345",
  "owner": {
    "id": "02c88a3f-d759-4973-88f9-60049d682524"
  }
}

Property	Description	Type	Required
company	A company as shown in Distru	Company	false
custom_data	The custom data for this contact	array(CustomField)	false
email	The email address of this contact	string	false
full_name	The full name of this contact	string	false
id	Unique ID for this contact	string	false
owner	Information about a user in Distru	User	false
phone_number	The phone number of this contact	string	false
title	The title of this contact	string	false

PaymentMethods

A collection of Payment Methods

Property	Description	Type	Required

InvoiceChargeRequest

Invoice charge params

Property	Description	Type	Required
id	Unique ID for this invoice charge. If it exists, an update will be performed; otherwise, it will be used as the ID of a new invoice charge record	string	false
name	The name of this charge	string	false
percent	The percent (if it is percent-based) of this charge	number	false
price	The flat price (if it is price-based) of this charge	number	false
type	Determines if this is a charge or discount	string	true
unit_type	Determines if this line is tracked as a percentage or a flat charge	string	true

Companies

A collection of companies

Property	Description	Type	Required

UnitType

A unit type as shown in Distru

{
  "name": "Gram"
}

Property	Description	Type	Required
id	Unique ID for this unit type	string	false
name	Human readable name for this unit type	string	false

ProductPosMapping

A mapping between a Distru product and a POS product

Property	Description	Type	Required
blaze_product_id	Blaze product ID	string	false
blaze_retailer_id	Blaze retailer ID	string	false
dutchie_product_id	Dutchie product ID	integer	false
dutchie_retailer_id	Dutchie retailer ID	string	false
id	Mapping ID	string	false
inserted_at	Creation timestamp	string	false
pos_type	POS type (BLAZE, DUTCHIE, or TREEZ)	string	false
product_id	Distru product ID	string	false
treez_product_id	Treez product ID	string	false
treez_retailer_id	Treez retailer ID	string	false
updated_at	Last update timestamp	string	false

Company

A company as shown in Distru

Property	Description	Type	Required
category	The category of this company	string	false
custom_data	The custom data for this company	array(CustomField)	false
default_email	The default email for this company	string	false
default_purchase_order_notes	The default notes that will be automatically added to purchase orders when this company is the supplier	string	false
default_sales_order_notes	The default external notes that will be automatically added to sales orders when this company is the customer	string	false
group	A company group as shown in Distru	CompanyGroup	false
id	Unique ID for this company	string	false
invoice_email	The email address where sales order invoices are delivered	string	false
legal_business_name	The legal business name for this company	string	false
licenses	The license for the company	array(License)	false
locations	The location for the company	array(Location)	false
name	Human readable name for this company	string	false
order_shipment_email	The email address where sales order shipment packing slips are delivered	string	false
outstanding_balance_threshold	Threshold that determines when a company is considered to have a too high an outstanding balance. When exceeded, Distru will show a warning banner in the company's page and when selling to this company.	integer	false
owner_id	The ID of the user that owns this company	string	false
phone_number	The phone number for this company	string	false
purchase_order_email	The email address where purchase order slips are delivered	string	false
relationship_type	A relationship type as shown in Distru	RelationshipType	false
sales_order_email	The email address where sales order slips are delivered	string	false
updated_datetime	The datetime this company was last updated at	string	false
website	The website for this company	string	false

AssemblyInput

An input for an assembly as shown in Distru

Property	Description	Type	Required
batch	A batch for a product as shown in Distru	Batch	false
compliance_quantity	The quantity of this input expressed in the package's unit type. Null if this input is not package-tracked.	number	false
location	A location as shown in Distru	Location	false
package	A package as shown in Distru	Package	false
product	A product as shown in Distru	Product	false
quantity	The quantity of this input in its product's unit	number	false
total_cost_actual	The total actual cost of this input	number	false
total_cost_default	The total default cost (from the configured product unit cost) of this input	number	false

Inventories

A list of active and available quantity for each group

Property	Description	Type	Required

Brand

A brand as shown in Distru

{
  "name": "Brand 123"
}

Property	Description	Type	Required
name	Name of the brand	string	false

Users

A collection of Users

Property	Description	Type	Required

Assembly

Get assemblies

GET /public/v1/assemblies returns proper data for non-compliance assembly

GET /public/v1/assemblies?creation_source=MANUALLY_CREATED&page[number]=1
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MTcsImlhdCI6MTc1NTc5NzgxNywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZTMwYTFlZTktZjFiNi00YjdlLWFiYmUtNGZmYWE0ZWUyZjI3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODE2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDEwMjMiLCJ0eXAiOiJhY2Nlc3MifQ.LsBFR6Fwi9RrmDvyQpu6xpIMJT0QUGA506t1K-Qg8qw

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: f5622367419ff8000000000000000001-3980166280a582c1-0

{
  "data": [
    {
      "completion_datetime": null,
      "compliance_type": "NONE",
      "creation_source": "MANUALLY_CREATED",
      "custom_data": [
        {
          "id": 136,
          "name": "Custom Field 157",
          "value": "Custom Field Value"
        }
      ],
      "description": null,
      "estimated_work_hours": 1,
      "estimated_work_minutes": 5,
      "fulfilled": true,
      "id": "99aef826-4359-44a1-8eec-5215ed2e964e",
      "is_metrc_processing_job": false,
      "license": null,
      "outputs": [
        {
          "additional_costs": [
            {
              "cost_per_unit": "-1",
              "description": null,
              "name": "CostType 141",
              "quantity": "1",
              "total_cost_actual": "-1",
              "total_cost_default": "0",
              "unit_type": {
                "id": "00000000-0000-0000-0000-000000064584",
                "name": "Unit Type 603"
              }
            }
          ],
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-00000000211d",
            "name": "B29063"
          },
          "compliance_label": null,
          "compliance_quantity": null,
          "expiration_datetime": null,
          "ingredients": [
            {
              "batch": {
                "batch_number": null,
                "id": "00000000-0000-0000-0000-00000000211d",
                "name": "B29063"
              },
              "compliance_quantity": null,
              "location": {
                "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
                "company_id": "00000000-0000-0000-0000-000000007293",
                "id": "00000000-0000-0000-0000-000000002e62",
                "license_id": null,
                "name": "Place 11706"
              },
              "package": null,
              "product": {
                "id": "58744bbf-385c-4ef2-b0bf-461a169aaf74",
                "name": "Product 29061",
                "sku": "sku 29062",
                "updated_datetime": "2025-08-21T17:36:57.870933Z"
              },
              "quantity": "1",
              "total_cost_actual": null,
              "total_cost_default": "1"
            }
          ],
          "is_production_batch": false,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-000000007293",
            "id": "00000000-0000-0000-0000-000000002e62",
            "license_id": null,
            "name": "Place 11706"
          },
          "package": null,
          "package_datetime": null,
          "package_unit_type": null,
          "product": {
            "id": "58744bbf-385c-4ef2-b0bf-461a169aaf74",
            "name": "Product 29061",
            "sku": "sku 29062",
            "updated_datetime": "2025-08-21T17:36:57.870933Z"
          },
          "quantity": "1"
        }
      ],
      "owner_id": "00000000-0000-0000-0000-00000000a03f",
      "status": "PENDING"
    }
  ]
}

GET /public/v1/assemblies returns proper data for pending metrc assembly

GET /public/v1/assemblies?creation_source=MANUALLY_CREATED&license_number=CDPH-00008887&page[number]=1
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MTcsImlhdCI6MTc1NTc5NzgxNywiaXNzIjoiRGlzdHJ1IiwianRpIjoiOGMzODBmNzQtYzIxMi00ZDI3LTk4NWMtOThmYTEyMjBiZTI1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODE2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA5MjIiLCJ0eXAiOiJhY2Nlc3MifQ.sqymVuqqwj2sbOcYOptP-Vp6pcXU0ipCBvNTMiujIs0

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e68c2b3d6dad60000000000000000001-7790fc850fe2b1ef-0

{
  "data": [
    {
      "completion_datetime": null,
      "compliance_type": "METRC",
      "creation_source": "MANUALLY_CREATED",
      "custom_data": [
        {
          "id": 135,
          "name": "Custom Field 156",
          "value": null
        }
      ],
      "description": null,
      "estimated_work_hours": null,
      "estimated_work_minutes": null,
      "fulfilled": true,
      "id": "9f5dd5ae-76a4-4306-a147-b28d04d9412b",
      "is_metrc_processing_job": false,
      "license": {
        "id": "00000000-0000-0000-0000-000000001ed8",
        "license_number": "CDPH-00008887"
      },
      "outputs": [
        {
          "additional_costs": [],
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000002101",
            "name": "B28973"
          },
          "compliance_label": "1A4010200001234000000658",
          "compliance_quantity": "2",
          "expiration_datetime": null,
          "ingredients": [
            {
              "batch": {
                "batch_number": null,
                "id": "00000000-0000-0000-0000-000000002101",
                "name": "B28973"
              },
              "compliance_quantity": "0.0353",
              "location": {
                "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
                "company_id": "00000000-0000-0000-0000-00000000724d",
                "id": "00000000-0000-0000-0000-000000002e40",
                "license_id": "00000000-0000-0000-0000-000000001ed8",
                "name": "Place 11673"
              },
              "package": {
                "batch_number": "1234567890",
                "compliance_label": "ABCDEF012345670000076976",
                "id": "00000000-0000-0000-0000-000000000de1",
                "metrc_label": "ABCDEF012345670000076976",
                "status": "active"
              },
              "product": {
                "id": "e4a399b3-2f0f-48c5-ac6c-37990f423ad5",
                "name": "Product 28967",
                "sku": "sku 28968",
                "updated_datetime": "2025-08-21T17:36:57.320817Z"
              },
              "quantity": "1",
              "total_cost_actual": null,
              "total_cost_default": null
            }
          ],
          "is_production_batch": false,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-00000000724d",
            "id": "00000000-0000-0000-0000-000000002e40",
            "license_id": "00000000-0000-0000-0000-000000001ed8",
            "name": "Place 11673"
          },
          "package": null,
          "package_datetime": "2025-08-21",
          "package_unit_type": {
            "id": "00000000-0000-0000-0000-0000000640b2",
            "name": "Gram"
          },
          "product": {
            "id": "e4a399b3-2f0f-48c5-ac6c-37990f423ad5",
            "name": "Product 28967",
            "sku": "sku 28968",
            "updated_datetime": "2025-08-21T17:36:57.320817Z"
          },
          "quantity": "2"
        }
      ],
      "owner_id": "00000000-0000-0000-0000-000000009fda",
      "status": "PENDING"
    }
  ]
}

GET /public/v1/assemblies returns proper data for completed metrc assembly

GET /public/v1/assemblies?completion_datetime=2025-08-21+16%3A36%3A54.983628Z%2C2025-08-21+18%3A36%3A54.983628Z&creation_source=MANUALLY_CREATED&license_number=CDPH-00008829&page[number]=1
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MTQsImlhdCI6MTc1NTc5NzgxNCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTU3YzU2ZTQtNmU2Zi00NGMxLThmODEtMWYyMmJkMDUwYmRlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODEzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA2MjciLCJ0eXAiOiJhY2Nlc3MifQ.FZ03preTXknX5l449leWcK77-Otf7M_3mvoiHMwyEj4

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: b8282418ed3bf0000000000000000001-e6438118e944c33e-0

{
  "data": [
    {
      "completion_datetime": "2025-08-21T17:36:54.983628Z",
      "compliance_type": "METRC",
      "creation_source": "MANUALLY_CREATED",
      "custom_data": [],
      "description": null,
      "estimated_work_hours": null,
      "estimated_work_minutes": null,
      "fulfilled": true,
      "id": "7bc9f7d0-2c74-4ea1-9799-597550dd4147",
      "is_metrc_processing_job": false,
      "license": {
        "id": "00000000-0000-0000-0000-000000001ea6",
        "license_number": "CDPH-00008829"
      },
      "outputs": [
        {
          "additional_costs": [],
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-0000000020b4",
            "name": "B28726"
          },
          "compliance_label": "1A4010200001234000000651",
          "compliance_quantity": "2",
          "expiration_datetime": null,
          "ingredients": [
            {
              "batch": {
                "batch_number": null,
                "id": "00000000-0000-0000-0000-0000000020b4",
                "name": "B28726"
              },
              "compliance_quantity": "0.0353",
              "location": {
                "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
                "company_id": "00000000-0000-0000-0000-000000007181",
                "id": "00000000-0000-0000-0000-000000002de5",
                "license_id": "00000000-0000-0000-0000-000000001ea6",
                "name": "Place 11582"
              },
              "package": {
                "batch_number": "1234567890",
                "compliance_label": "ABCDEF012345670000076886",
                "id": "00000000-0000-0000-0000-000000000dc1",
                "metrc_label": "ABCDEF012345670000076886",
                "status": "active"
              },
              "product": {
                "id": "11b60b17-b974-4860-8234-965ff1094041",
                "name": "Product 28723",
                "sku": "sku 28724",
                "updated_datetime": "2025-08-21T17:36:54.557343Z"
              },
              "quantity": "1",
              "total_cost_actual": null,
              "total_cost_default": null
            }
          ],
          "is_production_batch": false,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-000000007181",
            "id": "00000000-0000-0000-0000-000000002de5",
            "license_id": "00000000-0000-0000-0000-000000001ea6",
            "name": "Place 11582"
          },
          "package": {
            "batch_number": null,
            "compliance_label": "1A4010200001234000000651",
            "id": "00000000-0000-0000-0000-000000000dc7",
            "metrc_label": "1A4010200001234000000651",
            "status": "active"
          },
          "package_datetime": "2025-08-21",
          "package_unit_type": {
            "id": "00000000-0000-0000-0000-0000000634ea",
            "name": "Gram"
          },
          "product": {
            "id": "11b60b17-b974-4860-8234-965ff1094041",
            "name": "Product 28723",
            "sku": "sku 28724",
            "updated_datetime": "2025-08-21T17:36:54.557343Z"
          },
          "quantity": "2"
        }
      ],
      "owner_id": "00000000-0000-0000-0000-000000009eb3",
      "status": "COMPLETED"
    }
  ]
}

GET /public/v1/assemblies returns proper data for biotrack assembly

GET /public/v1/assemblies?completion_datetime=2025-08-21+16%3A36%3A56.569885Z%2C2025-08-21+18%3A36%3A56.569885Z&creation_source=MANUALLY_CREATED&license_number=CDPH-00008858&page[number]=1
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MTYsImlhdCI6MTc1NTc5NzgxNiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjAyNzIzZTktZTM4YS00NjBiLTk5NGQtZGQ2ZTc0M2JkODVlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODE1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA3NTYiLCJ0eXAiOiJhY2Nlc3MifQ.Cl4Eijog74n96PKfsO1uxiB5j_DDvoj4anznPBVgcww

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 1b2b268177e81b000000000000000001-40ffc5cf4bed7e73-0

{
  "data": [
    {
      "completion_datetime": "2025-08-21T17:36:56.569885Z",
      "compliance_type": "BIOTRACK",
      "creation_source": "MANUALLY_CREATED",
      "custom_data": [],
      "description": null,
      "estimated_work_hours": null,
      "estimated_work_minutes": null,
      "fulfilled": true,
      "id": "b9c5eab3-cabe-4201-a39e-9e2a2f5b4e46",
      "is_metrc_processing_job": false,
      "license": {
        "id": "00000000-0000-0000-0000-000000001ebc",
        "license_number": "CDPH-00008858"
      },
      "outputs": [
        {
          "additional_costs": [],
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-0000000020d8",
            "name": "B28848"
          },
          "compliance_label": null,
          "compliance_quantity": "1",
          "expiration_datetime": null,
          "ingredients": [
            {
              "batch": {
                "batch_number": null,
                "id": "00000000-0000-0000-0000-0000000020d8",
                "name": "B28848"
              },
              "compliance_quantity": "1",
              "location": {
                "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
                "company_id": "00000000-0000-0000-0000-0000000071dc",
                "id": "00000000-0000-0000-0000-000000002e0e",
                "license_id": "00000000-0000-0000-0000-000000001ebc",
                "name": "Place 11623"
              },
              "package": {
                "batch_number": null,
                "compliance_label": "2148",
                "id": "00000000-0000-0000-0000-000000000dd2",
                "metrc_label": "2148",
                "status": "active"
              },
              "product": {
                "id": "7b3530e9-20d3-43c7-8629-67a574254502",
                "name": "Product 28841",
                "sku": "sku 28842",
                "updated_datetime": "2025-08-21T17:36:56.272639Z"
              },
              "quantity": "1",
              "total_cost_actual": null,
              "total_cost_default": null
            }
          ],
          "is_production_batch": false,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000071dc",
            "id": "00000000-0000-0000-0000-000000002e0e",
            "license_id": "00000000-0000-0000-0000-000000001ebc",
            "name": "Place 11623"
          },
          "package": {
            "batch_number": null,
            "compliance_label": null,
            "id": "00000000-0000-0000-0000-000000000dd5",
            "metrc_label": null,
            "status": "active"
          },
          "package_datetime": null,
          "package_unit_type": {
            "id": "00000000-0000-0000-0000-000000063a1f",
            "name": "Gram"
          },
          "product": {
            "id": "7b3530e9-20d3-43c7-8629-67a574254502",
            "name": "Product 28841",
            "sku": "sku 28842",
            "updated_datetime": "2025-08-21T17:36:56.272639Z"
          },
          "quantity": "1"
        }
      ],
      "owner_id": "00000000-0000-0000-0000-000000009f34",
      "status": "COMPLETED"
    }
  ]
}

Get assemblies ordered from oldest to newest by their last modified date.

Note: The page size for this endpoint is 500 assemblies per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/assemblies

Parameters

Parameter	Description	In	Type	Required	Example
completion_datetime	Filter assemblies by their completion datetime	query	string	false	2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false
creation_source	Filter assemblies by their creation source. Options include MANUALLY_CREATED, SPLIT_PACKAGE, SALES_ORDER and LAB_TESTING	query	string	false
license_number	Filter assemblies by their license number	query	string	false

Responses

Status	Description	Schema
200	A list of assemblies	Assemblies

Batch

Get batches

GET /public/v1/batches returns batches related to the company

GET /public/v1/batches
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MTAsImlhdCI6MTc1NTc5NzgxMCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzMzZTRlYTMtMDcyMS00ZTMxLTk2NTQtZGU5NzI0NDdkNDY3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODA5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzk4MTkiLCJ0eXAiOiJhY2Nlc3MifQ.KVstr5TiO1HbQ0YkJcG6IfaJBMSDSjUQaol7LLGf8z4

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 3358ff00e231ce000000000000000001-587050e3f21d06a1-0

{
  "data": [
    {
      "batch_number": null,
      "custom_data": [
        {
          "id": 134,
          "name": "Custom Field 155",
          "value": "Custom Data 1"
        }
      ],
      "description": null,
      "expiration_date": "2024-01-01T00:00:00.000000Z",
      "id": "00000000-0000-0000-0000-000000002019",
      "name": "B28190",
      "owner_id": "00000000-0000-0000-0000-000000009b8e",
      "primary_test_result": null,
      "product_id": "efec06fa-9d45-4e7f-aef8-d5ad25cb1998"
    },
    {
      "batch_number": null,
      "custom_data": [
        {
          "id": 134,
          "name": "Custom Field 155",
          "value": null
        }
      ],
      "description": null,
      "expiration_date": null,
      "id": "00000000-0000-0000-0000-00000000201a",
      "name": "B28193",
      "owner_id": "00000000-0000-0000-0000-000000009b91",
      "primary_test_result": {
        "cbd_mg_per_unit": "1",
        "cbd_mg_per_unit_total": "2",
        "cbd_percentage": "3",
        "cbd_percentage_total": "4",
        "mg_per_unit_type": "mg/mL",
        "name": "File.pdf",
        "thc_mg_per_unit": "5",
        "thc_mg_per_unit_total": "6",
        "thc_percentage": "7",
        "thc_percentage_total": "8"
      },
      "product_id": "d1fe786a-fce9-45b1-ac99-4bd8493e2d1d"
    }
  ]
}

Get batches sorted by their creation date and filtered by various attributes.

Note: The page size for this endpoint is 5000 batches per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/batches

Parameters

Parameter	Description	In	Type	Required	Example
inserted_datetime	Filter batches by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false
updated_datetime	Filter batches by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of batches	Batches

Create a batch

POST /public/v1/batches Errors from service messages are properly reflected in the response

POST /public/v1/batches
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MDksImlhdCI6MTc1NTc5NzgwOSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjUzODQxOTItNjFlZC00MDdmLTg3NjEtN2UwNTg2YzM3NDAwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODA4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzk3NDYiLCJ0eXAiOiJhY2Nlc3MifQ.5nZdidxdXqzLUkx_rE_FS22UI4iWnZ2bph0ZXQaUr9k

{
  "owner_id": "e048d112-9264-4875-a8a5-8d1fb0e54bac",
  "product_id": "1d902806-82a4-4d85-a56a-e284a84502c8"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: c8356a03b4aa00000000000000000001-908bd50f3c714d0c-0

{
  "errors": [
    {
      "context": {},
      "message": "Owner not found",
      "pointer": [
        "owner_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Product not found",
      "pointer": [
        "product_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Unable to verify inventory tracking method",
      "pointer": [
        "product_id"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/batches Can create batch with all optional fields missing

POST /public/v1/batches
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MDksImlhdCI6MTc1NTc5NzgwOSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzUwNGZhY2YtOWQxMy00OWFiLWE0OTEtODFjOTY3NjQ1MTJlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODA4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzk3MjQiLCJ0eXAiOiJhY2Nlc3MifQ.CW2ENs3Nx7x9k4dXokCZADXQ23OHUb1VKZPChrwVIZ8

{
  "product_id": "451e27d7-8c08-4669-8b2a-a6c59398850a"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 9866c4688612a8000000000000000001-c39db8a902da7bb7-0

{
  "data": {
    "batch_number": null,
    "custom_data": [],
    "description": null,
    "expiration_date": null,
    "id": "00000000-0000-0000-0000-000000001ff5",
    "name": "B1",
    "owner_id": null,
    "product_id": "451e27d7-8c08-4669-8b2a-a6c59398850a"
  }
}

POST /public/v1/batches Can create batch with all optional fields provided

POST /public/v1/batches
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MDksImlhdCI6MTc1NTc5NzgwOSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTc5YzY2OWYtMTMzYS00OGE4LTgzYTktZDUxY2I4ZjhkN2VmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODA4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzk2MDkiLCJ0eXAiOiJhY2Nlc3MifQ.R3wrh6JrZmVWfTq11JdxDBBRS9yzDgN-hZHnfBrXT1U

{
  "batch_number": "B1",
  "description": "Test batch",
  "expiration_date": "2025-01-01T00:00:00.000000Z",
  "owner_id": "00000000-0000-0000-0000-000000009ac5",
  "product_id": "fc63e5d7-2f6d-4493-b80e-43264deec039"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 0ac3c117b6e6d0000000000000000001-90ec31ca7bd3cc4f-0

{
  "data": {
    "batch_number": "B1",
    "custom_data": [],
    "description": "Test batch",
    "expiration_date": "2025-01-01T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-000000001fd2",
    "name": "B1",
    "owner_id": "00000000-0000-0000-0000-000000009ac5",
    "product_id": "fc63e5d7-2f6d-4493-b80e-43264deec039"
  }
}

Create a single batch.

Request

POST /public/v1/batches

Parameters

Parameter	Description	In	Type	Required
product_id	The ID of the product that this batch belongs to.	query	string	false
batch_number	The batch number of the batch.	query	string	false
expiration_date	The expiration date of the batch.	query	string	false
owner_id	The ID of the user that is the designated owner of this batch.	query	string	false
description	The description of the batch.	query	string	false

Responses

Status	Description	Schema
200	A single batch	Batch

Company

Get companies

GET /public/companies returns companies related to the company

GET /public/v1/companies
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczNDksImlhdCI6MTc1NTc5Nzc0OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjZlYzQzNzAtODIyMS00MjZhLTg4OGYtNTZkNjMzMDRlYzQ4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzQ4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjkyMjgiLCJ0eXAiOiJhY2Nlc3MifQ.uXksQTzvdApOxU56PWKKwW5YoX9vuaykmn9UrOHhCcc

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: cd8841c9679308000000000000000001-62fa505c79622fee-0

{
  "data": [
    {
      "category": "Retailer",
      "custom_data": [
        {
          "id": 94,
          "name": "Custom Field 116",
          "value": "Custom Data 1"
        }
      ],
      "default_email": "company-1@example.com",
      "default_purchase_order_notes": "Default Purchase Order Notes 1",
      "default_sales_order_notes": "Default Order External Notes 1",
      "group": {
        "id": "00000000-0000-0000-0000-000000000012",
        "name": "Comp Rel Group 15"
      },
      "id": "00000000-0000-0000-0000-000000002b76",
      "invoice_email": "invoice email",
      "legal_business_name": "Company Legal Name 1",
      "licenses": [],
      "locations": [
        {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-0000000052de",
          "id": "00000000-0000-0000-0000-0000000020e0",
          "license_id": null,
          "name": "Place 8279"
        }
      ],
      "name": "Company 21087",
      "order_shipment_email": "order shipment email",
      "outstanding_balance_threshold": 1000,
      "owner_id": "00000000-0000-0000-0000-00000000723f",
      "phone_number": "1234567890",
      "purchase_order_email": "purchase email",
      "relationship_type": {
        "id": "00000000-0000-0000-0000-0000000002dc",
        "name": "Supplier"
      },
      "sales_order_email": "order email",
      "updated_datetime": "2023-11-03T00:00:00.000000Z",
      "website": "https://www.example.com"
    },
    {
      "category": "Dispensary",
      "custom_data": [
        {
          "id": 94,
          "name": "Custom Field 116",
          "value": null
        }
      ],
      "default_email": "company-50294@example.com",
      "default_purchase_order_notes": null,
      "default_sales_order_notes": null,
      "group": null,
      "id": "00000000-0000-0000-0000-000000002b7b",
      "invoice_email": null,
      "legal_business_name": "Company Legal Name 21090",
      "licenses": [
        {
          "id": "00000000-0000-0000-0000-00000000163a",
          "license_number": "CDPH-00006172"
        }
      ],
      "locations": [],
      "name": "Company 21090",
      "order_shipment_email": null,
      "outstanding_balance_threshold": null,
      "owner_id": null,
      "phone_number": null,
      "purchase_order_email": null,
      "relationship_type": null,
      "sales_order_email": null,
      "updated_datetime": "2023-12-02T00:00:00.000000Z",
      "website": null
    }
  ]
}

Get companies sorted by their creation date and filtered by various attributes

Note: The page size for this endpoint is 5000 companies per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/companies

Parameters

Parameter	Description	In	Type	Required	Example
inserted_datetime	Filter companies by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false
updated_datetime	Filter companies by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of companies	Companies

Contact

Get contacts

GET /public/v1/contacts returns contacts related to the company

GET /public/v1/contacts
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcwODMsImlhdCI6MTc1NTc5NzQ4MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjA3YjVjMWItYzgyMC00ZWIyLWEzMzEtOTkyM2I0OWFkOWI3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NDgyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDQ0IiwidHlwIjoiYWNjZXNzIn0.BpGlWlULut_Yg-9JMj62IhGYG8i0HpxUCz7hPvHrRFA

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 6ab6006e208528000000000000000001-6f8df2c774f5170d-0

{
  "data": [
    {
      "company": {
        "id": "00000000-0000-0000-0000-0000000000d7"
      },
      "custom_data": [
        {
          "id": 4,
          "name": "Custom Field 5",
          "value": "Custom Data 1"
        }
      ],
      "email": "email1",
      "full_name": "FirstName930 LastName931",
      "id": "00000000-0000-0000-0000-000000000018",
      "owner": {
        "id": "00000000-0000-0000-0000-0000000001c1"
      },
      "phone_number": "1234567890",
      "title": null
    },
    {
      "company": {
        "id": "00000000-0000-0000-0000-0000000000d8"
      },
      "custom_data": [
        {
          "id": 4,
          "name": "Custom Field 5",
          "value": null
        }
      ],
      "email": "email2",
      "full_name": "FirstName934 LastName935",
      "id": "00000000-0000-0000-0000-000000000019",
      "owner": {
        "id": "00000000-0000-0000-0000-0000000001c7"
      },
      "phone_number": "1234567890",
      "title": null
    }
  ]
}

Get contacts sorted by their creation date and filtered by various attributes

Note: The page size for this endpoint is 1000 contacts per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/contacts

Parameters

Parameter	Description	In	Type	Required	Example
inserted_datetime	Filter contacts by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false
updated_datetime	Filter contacts by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of contacts	Contacts

FileAttachment

Insert a file attachment

POST /public/v1/file-attachments uploads and creates a file attachment successfully with simplified reference

POST /public/v1/file-attachments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczODcsImlhdCI6MTc1NTc5Nzc4NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjhjMjY5M2YtMTJhMy00MDA1LTg3NDUtMzU3MmY0NDQyZGYyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzg2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU2MTEiLCJ0eXAiOiJhY2Nlc3MifQ.92N-efGZ2WG-OORkFdq8iOuSQV7xzIkNewGtUdbOChE

{
  "file": {
    "content_type": "image/png",
    "filename": "test-image.png"
  },
  "name": "My Test Image",
  "product_id": "423d972f-1082-414b-ac37-efab9eadb90e"
}

Response

201
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 0b4767d392e4bb800000000000000001-ee060ccbfa8aa301-0

{
  "data": {
    "assembly_id": null,
    "batch_id": null,
    "company_relationship_id": null,
    "contact_id": null,
    "id": "00000000-0000-0000-0000-000000000085",
    "invoice_id": null,
    "license_id": null,
    "mime_type": "image/png",
    "name": "My Test Image",
    "order_id": null,
    "order_shipment_id": null,
    "product_id": "423d972f-1082-414b-ac37-efab9eadb90e",
    "purchase_id": null,
    "request_id": null,
    "return_id": null,
    "size_in_bytes": 355974,
    "stock_transfer_id": null,
    "task_id": null,
    "upload_datetime": "2025-08-21T17:36:27.144209Z",
    "uploader": {
      "id": "00000000-0000-0000-0000-000000008b1b",
      "name": "FirstName71071 LastName71072"
    },
    "url": "/var/folders/j1/6rk0jm4s1l3bts_p6m88jd4r0000gn/T/4d4e211f-0a98-47b8-b9f1-9c5bd86949d3/test-image.png"
  }
}

Insert a new file attachment. The file will be uploaded to S3 and associated with the specified entity. Exactly one reference ID must be provided (product_id, order_id, purchase_id, etc.).

Request

POST /public/v1/file-attachments

Parameters

Parameter	Description	In	Type	Required	Example
file	The file to upload	formData	file	true
name	Display name for the attachment (defaults to filename if not provided)	formData	string	false
product_id	Product ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
order_id	Order ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
purchase_id	Purchase ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
invoice_id	Invoice ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
batch_id	Batch ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
contact_id	Contact ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
company_relationship_id	Company relationship ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
request_id	Request ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
task_id	Task ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
stock_transfer_id	Stock transfer ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
assembly_id	Assembly ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
return_id	Return ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
order_shipment_id	Order shipment ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000
license_id	License ID to attach file to	formData	string	false	550e8400-e29b-41d4-a716-446655440000

Responses

Status	Description	Schema
201	File attachment inserted successfully	FileAttachment
400	Invalid parameters
422	Storage quota exceeded or other validation error

Inventory

Get inventory levels

GET /public/inventory returns stock quantities filtered by product IDs

GET /public/v1/inventory?grouping[]=PRODUCT&product_ids[]=ab7b51fa-e251-4751-9eda-465314d8372a
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMzQsImlhdCI6MTc1NTc5NzczNCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTMxZTg4NmEtZDUwMi00N2NkLWE2ODktMTM2OTBhOWIzOTg4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzMzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjYwMzQiLCJ0eXAiOiJhY2Nlc3MifQ.cR5K4N7g8tHQoRw1FYk9hgMINGNkUEsUZHXD9gZ0tf4

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: ce50f9010901d8000000000000000001-274e74b42d91fa39-0

{
  "data": [
    {
      "active": "10.000000000",
      "available": "10.000000000",
      "product_id": "ab7b51fa-e251-4751-9eda-465314d8372a",
      "updated_datetime": "2025-08-21T17:35:34.192662Z"
    }
  ]
}

GET /public/inventory returns stock quantities grouped by product

GET /public/v1/inventory?grouping[]=PRODUCT
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMzIsImlhdCI6MTc1NTc5NzczMiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMjVlMGQyZDMtMzkyYi00YmJjLTkwNGUtNDZkODIwY2Y4MTVmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzMxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjU3OTQiLCJ0eXAiOiJhY2Nlc3MifQ.SnYOWuhrKx9VTjPbc5l91x-jbIVDODryJ-7h7roPEHc

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 3587d12f2c9402000000000000000001-fe9d5d5cc977d6bc-0

{
  "data": [
    {
      "active": "95.000000000",
      "available": "80.000000000",
      "product_id": "598dd8c8-1be8-4bee-806e-66d6a3b56aa9",
      "updated_datetime": "2023-11-06T00:00:00.000000Z"
    },
    {
      "active": "50.000000000",
      "available": "50.000000000",
      "product_id": "a9e69f74-dca6-4857-abf3-e89334c4c146",
      "updated_datetime": "2023-11-05T00:00:00.000000Z"
    },
    {
      "active": "100.000000000",
      "available": "90.000000000",
      "product_id": "c20aa01b-c8ab-41b6-a28b-1648c7acce74",
      "updated_datetime": "2023-12-03T00:00:00.000000Z"
    }
  ]
}

GET /public/inventory returns stock quantities grouped by product & location

GET /public/v1/inventory?grouping[]=PRODUCT&grouping[]=LOCATION
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMjgsImlhdCI6MTc1NTc5NzcyOCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMWVhMmY1ZTktM2I0NC00MTNiLTg4NzAtY2FhNjU0OWEwODY2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzI3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjUwMDUiLCJ0eXAiOiJhY2Nlc3MifQ.zAC7WeoNceWmK0ksqK_KHN78vLrvsfklBAJUHvQH2mc

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: dc6d171ad1ffb0000000000000000001-9951eb780b71df11-0

{
  "data": [
    {
      "active": "100.000000000",
      "available": "85.000000000",
      "location_id": "00000000-0000-0000-0000-000000001c43",
      "product_id": "611c9f64-be05-4e7d-ad28-1719072184f8",
      "updated_datetime": "2030-10-03T00:00:00.000000Z"
    },
    {
      "active": "90.000000000",
      "available": "82.000000000",
      "location_id": "00000000-0000-0000-0000-000000001c44",
      "product_id": "611c9f64-be05-4e7d-ad28-1719072184f8",
      "updated_datetime": "2030-10-04T00:00:00.000000Z"
    },
    {
      "active": "150.000000000",
      "available": "129.000000000",
      "location_id": "00000000-0000-0000-0000-000000001c45",
      "product_id": "611c9f64-be05-4e7d-ad28-1719072184f8",
      "updated_datetime": "2030-10-05T00:00:00.000000Z"
    },
    {
      "active": "0.000000000",
      "available": "-1.000000000",
      "location_id": null,
      "product_id": "611c9f64-be05-4e7d-ad28-1719072184f8",
      "updated_datetime": "2030-10-08T00:00:00.000000Z"
    },
    {
      "active": "100.000000000",
      "available": "90.000000000",
      "location_id": "00000000-0000-0000-0000-000000001c43",
      "product_id": "89e54fd6-047f-4c91-8db0-13394d5a919a",
      "updated_datetime": "2030-10-01T00:00:00.000000Z"
    },
    {
      "active": "0.000000000",
      "available": "-1.000000000",
      "location_id": "00000000-0000-0000-0000-000000001c44",
      "product_id": "89e54fd6-047f-4c91-8db0-13394d5a919a",
      "updated_datetime": "2030-10-02T00:00:00.000000Z"
    },
    {
      "active": "100.000000000",
      "available": "100.000000000",
      "location_id": "00000000-0000-0000-0000-000000001c44",
      "product_id": "9b949e22-e79b-4d27-9c89-6ba9c21e5d09",
      "updated_datetime": "2030-09-01T00:00:00.000000Z"
    },
    {
      "active": "30.000000000",
      "available": "26.000000000",
      "location_id": null,
      "product_id": "9b949e22-e79b-4d27-9c89-6ba9c21e5d09",
      "updated_datetime": "2030-10-07T00:00:00.000000Z"
    }
  ]
}

GET /public/inventory returns stock quantities grouped by product & batch number

GET /public/v1/inventory?grouping[]=PRODUCT&grouping[]=BATCH_NUMBER
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMzEsImlhdCI6MTc1NTc5NzczMSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTRkNjNhNDMtZDRkNS00NzEzLWI5MzgtMTExOTE4ZTIwMjM4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzMwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjU2MjYiLCJ0eXAiOiJhY2Nlc3MifQ.hy0Hk0Izvnxd-AmMiy_rjlsiq1HO1nZYJMrIzPRy48Q

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 262d0476e688da000000000000000001-c9ac84c22cd337a5-0

{
  "data": [
    {
      "active": "26.000000000",
      "available": "26.000000000",
      "batch_number": null,
      "product_id": "38e90b41-b746-4c97-85e2-01e1a0de7b57",
      "updated_datetime": "2030-12-01T00:00:00.000000Z"
    },
    {
      "active": "27.000000000",
      "available": "27.000000000",
      "batch_number": "1",
      "product_id": "38e90b41-b746-4c97-85e2-01e1a0de7b57",
      "updated_datetime": "2030-12-02T00:00:00.000000Z"
    },
    {
      "active": "8.000000000",
      "available": "8.000000000",
      "batch_number": "TEST-1",
      "product_id": "792e3aa3-0319-4bb0-a8ac-5b61ea6c4cfb",
      "updated_datetime": "2030-09-01T00:00:00.000000Z"
    },
    {
      "active": "43.000000000",
      "available": "43.000000000",
      "batch_number": null,
      "product_id": "82e464ce-c57d-4bbd-998b-e614b4bd97d4",
      "updated_datetime": "2030-11-02T00:00:00.000000Z"
    },
    {
      "active": "47.000000000",
      "available": "47.000000000",
      "batch_number": "1",
      "product_id": "82e464ce-c57d-4bbd-998b-e614b4bd97d4",
      "updated_datetime": "2030-11-04T00:00:00.000000Z"
    },
    {
      "active": "25.000000000",
      "available": "25.000000000",
      "batch_number": "2",
      "product_id": "82e464ce-c57d-4bbd-998b-e614b4bd97d4",
      "updated_datetime": "2030-11-05T00:00:00.000000Z"
    },
    {
      "active": "19.000000000",
      "available": "19.000000000",
      "batch_number": null,
      "product_id": "fcda3710-15ac-431b-8768-e2dbcbadc49b",
      "updated_datetime": "2030-10-02T00:00:00.000000Z"
    },
    {
      "active": "13.000000000",
      "available": "13.000000000",
      "batch_number": "TEST-1",
      "product_id": "fcda3710-15ac-431b-8768-e2dbcbadc49b",
      "updated_datetime": "2030-10-04T00:00:00.000000Z"
    }
  ]
}

GET /public/inventory returns stock quantities grouped by product & location & batch number

GET /public/v1/inventory?grouping[]=PRODUCT&grouping[]=LOCATION&grouping[]=BATCH_NUMBER
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMzAsImlhdCI6MTc1NTc5NzczMCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMWYwMjU0YjItYjdhZS00MjkxLWJiZDItYjYzYTdmZWIxNTFiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzI5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjU0NDQiLCJ0eXAiOiJhY2Nlc3MifQ.0Gh5IP_9iIfq5Ov-Rv3_nIYx794SFGqvpNs5i0guGFg

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 6a151c23e9cda0000000000000000001-e09382abb09547f2-0

{
  "data": [
    {
      "active": "41.000000000",
      "available": "41.000000000",
      "batch_number": null,
      "location_id": "00000000-0000-0000-0000-000000001c9c",
      "product_id": "2a0c7115-3dff-4d40-84d1-7117c6f3bbb3",
      "updated_datetime": "2031-01-02T00:00:00.000000Z"
    },
    {
      "active": "49.000000000",
      "available": "49.000000000",
      "batch_number": "TEST-1",
      "location_id": "00000000-0000-0000-0000-000000001c9c",
      "product_id": "2a0c7115-3dff-4d40-84d1-7117c6f3bbb3",
      "updated_datetime": "2031-02-02T00:00:00.000000Z"
    },
    {
      "active": "45.000000000",
      "available": "45.000000000",
      "batch_number": null,
      "location_id": "00000000-0000-0000-0000-000000001c9e",
      "product_id": "2a0c7115-3dff-4d40-84d1-7117c6f3bbb3",
      "updated_datetime": "2031-01-04T00:00:00.000000Z"
    },
    {
      "active": "53.000000000",
      "available": "53.000000000",
      "batch_number": "TEST-1",
      "location_id": "00000000-0000-0000-0000-000000001c9e",
      "product_id": "2a0c7115-3dff-4d40-84d1-7117c6f3bbb3",
      "updated_datetime": "2031-02-04T00:00:00.000000Z"
    },
    {
      "active": "21.000000000",
      "available": "21.000000000",
      "batch_number": null,
      "location_id": "00000000-0000-0000-0000-000000001c9c",
      "product_id": "71e9fc2f-daa4-40f5-8cb0-41126f0e0b5e",
      "updated_datetime": "2030-11-02T00:00:00.000000Z"
    },
    {
      "active": "29.000000000",
      "available": "29.000000000",
      "batch_number": "TEST-1",
      "location_id": "00000000-0000-0000-0000-000000001c9c",
      "product_id": "71e9fc2f-daa4-40f5-8cb0-41126f0e0b5e",
      "updated_datetime": "2030-12-02T00:00:00.000000Z"
    },
    {
      "active": "25.000000000",
      "available": "25.000000000",
      "batch_number": null,
      "location_id": "00000000-0000-0000-0000-000000001c9e",
      "product_id": "71e9fc2f-daa4-40f5-8cb0-41126f0e0b5e",
      "updated_datetime": "2030-11-04T00:00:00.000000Z"
    },
    {
      "active": "33.000000000",
      "available": "33.000000000",
      "batch_number": "TEST-1",
      "location_id": "00000000-0000-0000-0000-000000001c9e",
      "product_id": "71e9fc2f-daa4-40f5-8cb0-41126f0e0b5e",
      "updated_datetime": "2030-12-04T00:00:00.000000Z"
    }
  ]
}

Get active and available quantities grouped by a specified list of attributes. Groups with 0 active and 0 available quantity won't be returned. Groups are sorted by the IDs of the attributes they are grouped by. Note: The page size for this endpoint is 5000 groups per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/inventory

Parameters

Parameter	Description	In	Type	Required	Example
grouping	Attributes to group inventory by. PRODUCT is required to be in the list. Accepted values are "BATCH_NUMBER", "LOCATION" and "PRODUCT".	query	array	false	["PRODUCT","LOCATION"]
page	Pagination information	body	Page	false
product_ids	Filter inventory levels by product IDs	query	array	false	["67ae9080-8dc2-4ab7-9704-19673f4d9f21","213c7080-8dc2-4ab7-9704-19673f4d9f22"]

Responses

Status	Description	Schema
200	A list of active and available quantity for each group	Inventories

Invoice

Get invoices

GET /invoices/ returns invoices related to the access token's company

GET /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMTksImlhdCI6MTc1NTc5NzcxOSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDU0OGNhNWEtN2QwNC00MTNiLTk2ZGQtZjRmOThiNGRlZDJmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzE4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjM0MjciLCJ0eXAiOiJhY2Nlc3MifQ.xXqNRjyU-ebl2puOC9ymwANvxkAv-cW9_8OdgII8MWc

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 7605692d87d954000000000000000001-34ea6a72191537a6-0

{
  "data": [
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-000000002349",
        "name": "Company 17256",
        "updated_datetime": "2025-08-21T17:35:19.897817Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-23781@example.com",
        "full_name": "FirstName47043 LastName47044",
        "id": "00000000-0000-0000-0000-000000005bd7",
        "role": {
          "id": "00000000-0000-0000-0000-000000005b5f",
          "name": "Admin 23289"
        }
      },
      "custom_data": [
        {
          "id": 82,
          "name": "Custom Field 104",
          "value": null
        }
      ],
      "due_datetime": "2025-08-21T17:35:20.204444Z",
      "id": "00000000-0000-0000-0000-00000000019f",
      "inserted_datetime": "2025-08-21T17:35:20.206438Z",
      "invoice_datetime": "2025-08-21T17:35:20.204442Z",
      "invoice_number": "Invoice #372",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001148",
            "name": "B15790"
          },
          "id": "00000000-0000-0000-0000-0000000001ca",
          "order_item_id": "ce6c2674-2449-462f-8e1b-f820d5c10eb5",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "8a132af7-80aa-4a44-b653-06d39bb8e337",
            "name": "Product 15788",
            "sku": "sku 15789",
            "updated_datetime": "2025-08-21T17:35:19.944006Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-00000000114b",
            "name": "B15797"
          },
          "id": "00000000-0000-0000-0000-0000000001cb",
          "order_item_id": "eb8ace59-9c2f-473e-acaa-4ba16754c658",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "560c5967-e352-4a87-b4f7-0ce437336ff6",
            "name": "Product 15795",
            "sku": "sku 15796",
            "updated_datetime": "2025-08-21T17:35:19.975337Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "order": {
        "id": "bcfc7cc6-c3cd-437a-9232-39a10b948627",
        "order_number": "SO-991",
        "status": "Pending",
        "total": "320.00"
      },
      "owner": {
        "banned": false,
        "email": "owner-23781@example.com",
        "full_name": "FirstName47043 LastName47044",
        "id": "00000000-0000-0000-0000-000000005bd7",
        "role": {
          "id": "00000000-0000-0000-0000-000000005b5f",
          "name": "Admin 23289"
        }
      },
      "paid_amount": "0.0",
      "status": "NOT_PAID",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:35:20.206438Z"
    },
    {
      "charges": [
        {
          "id": "dcb55400-9466-40f9-8162-82e698cef46c",
          "name": "C1",
          "percent": "10.0000",
          "price": "1.00",
          "type": "CHARGE",
          "unit_type": "PERCENT"
        }
      ],
      "company": {
        "id": "00000000-0000-0000-0000-00000000232e",
        "name": "Company 17218",
        "updated_datetime": "2025-08-21T17:35:19.329125Z"
      },
      "creator": {
        "banned": false,
        "email": "user1@a.com",
        "full_name": "John Foo",
        "id": "00000000-0000-0000-0000-000000005b80",
        "role": {
          "id": "00000000-0000-0000-0000-000000005b07",
          "name": "Admin 23202"
        }
      },
      "custom_data": [
        {
          "id": 82,
          "name": "Custom Field 104",
          "value": "Custom Field Value 1"
        }
      ],
      "due_datetime": "2020-01-01T00:00:01.000000Z",
      "id": "00000000-0000-0000-0000-00000000019c",
      "inserted_datetime": "2025-08-21T17:35:19.481378Z",
      "invoice_datetime": "2020-01-01T00:00:02.000000Z",
      "invoice_number": "INV-123",
      "items": [
        {
          "batch": {
            "batch_number": "UID1",
            "id": "00000000-0000-0000-0000-000000001131",
            "name": "B1"
          },
          "id": "00000000-0000-0000-0000-0000000001c8",
          "order_item_id": "b5d14bd9-d452-49ae-8fda-77ec5c4fba10",
          "package": {
            "batch_number": "B1",
            "compliance_label": "ABCDEF012345670000071693",
            "id": "00000000-0000-0000-0000-000000000733",
            "metrc_label": "ABCDEF012345670000071693",
            "status": "active"
          },
          "price": "10.000000000",
          "product": {
            "id": "6691ec58-42dd-49eb-a8e4-7c0b784cd92e",
            "name": "P1",
            "sku": "SKU1",
            "updated_datetime": "2025-08-21T17:35:19.229057Z"
          },
          "quantity": "1.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "order": {
        "id": "7609cc4d-ce53-4408-95c8-6126829494ec",
        "order_number": "SO-123",
        "status": "Completed",
        "total": "10.00"
      },
      "owner": {
        "banned": false,
        "email": "user2@a.com",
        "full_name": "John Bar",
        "id": "00000000-0000-0000-0000-000000005b82",
        "role": {
          "id": "00000000-0000-0000-0000-000000005b09",
          "name": "Admin 23204"
        }
      },
      "paid_amount": "5.00",
      "status": "PARTIALLY_PAID",
      "total": "8.00",
      "updated_datetime": "2025-08-21T17:35:19.573321Z"
    }
  ]
}

GET /invoices/ returns cost/returned_quantity data for invoice items

GET /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMTgsImlhdCI6MTc1NTc5NzcxOCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWZkNmVhZTktNmIzMS00YTA3LWJkNzMtODM0OWUzMWJlOTIxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzE3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjMyOTIiLCJ0eXAiOiJhY2Nlc3MifQ.TTAse5QVsImZLPW9atoHRM7Pd4ImmDuV0Hpoo40frJE

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 82e4dd9f799158000000000000000001-5ef79819123855be-0

{
  "data": [
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-00000000230b",
        "name": "Company 17167",
        "updated_datetime": "2025-08-21T17:35:18.500561Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-23669@example.com",
        "full_name": "FirstName46821 LastName46822",
        "id": "00000000-0000-0000-0000-000000005b65",
        "role": {
          "id": "00000000-0000-0000-0000-000000005aeb",
          "name": "Admin 23175"
        }
      },
      "custom_data": [],
      "due_datetime": "2025-08-21T17:35:18.966490Z",
      "id": "00000000-0000-0000-0000-00000000019a",
      "inserted_datetime": "2025-08-21T17:35:18.968014Z",
      "invoice_datetime": "2025-08-21T17:35:18.966486Z",
      "invoice_number": "Invoice #368",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001118",
            "name": "B15632"
          },
          "id": "00000000-0000-0000-0000-0000000001c6",
          "order_item_id": "1289609b-fa47-4dd0-a03a-cc14dc3989ef",
          "package": null,
          "price": "580621.000000000",
          "product": {
            "id": "0c95d5f9-bccd-4280-80bd-dd64b550b419",
            "name": "Product 15630",
            "sku": "sku 15631",
            "updated_datetime": "2025-08-21T17:35:18.328943Z"
          },
          "quantity": "2.000000000",
          "returned_quantity": "2",
          "total_cost_actual": "20.052",
          "total_cost_default": "10"
        }
      ],
      "order": {
        "id": "b9c53c07-e2e9-4618-bf48-9172c6903a37",
        "order_number": "SO-0000001",
        "status": "Processing",
        "total": "1161242.00"
      },
      "owner": {
        "banned": false,
        "email": "owner-23669@example.com",
        "full_name": "FirstName46821 LastName46822",
        "id": "00000000-0000-0000-0000-000000005b65",
        "role": {
          "id": "00000000-0000-0000-0000-000000005aeb",
          "name": "Admin 23175"
        }
      },
      "paid_amount": "0.0",
      "status": "NOT_PAID",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:35:18.968014Z"
    }
  ]
}

GET /invoices/ allows filtering by several statuses

GET /public/v1/invoices?status[]=Fully+Paid&status[]=Not+Paid
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMDksImlhdCI6MTc1NTc5NzcwOSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNmYzZWM4YTMtMjIxOC00ZGQ4LTkzYjMtMzlmZDVlZTk0ODYzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzA4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjIwNDkiLCJ0eXAiOiJhY2Nlc3MifQ.ZLeVTGeFeTRfokHtwe8qib82W0WrXnC8M4hB7Plivus

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: f7fa4cb99636a0000000000000000001-a7a67c19aea12292-0

{
  "data": [
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-0000000021ae",
        "name": "Company 16503",
        "updated_datetime": "2025-08-21T17:35:11.224542Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-22511@example.com",
        "full_name": "FirstName44487 LastName44488",
        "id": "00000000-0000-0000-0000-0000000056d6",
        "role": {
          "id": "00000000-0000-0000-0000-00000000564b",
          "name": "Admin 22007"
        }
      },
      "custom_data": [],
      "due_datetime": "2025-08-21T17:35:11.430352Z",
      "id": "00000000-0000-0000-0000-000000000185",
      "inserted_datetime": "2025-08-21T17:35:11.432096Z",
      "invoice_datetime": "2020-01-01T12:30:00.000000Z",
      "invoice_number": "Invoice #357",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001045",
            "name": "B14941"
          },
          "id": "00000000-0000-0000-0000-0000000001a0",
          "order_item_id": "22e115d3-4546-42c8-ba1f-848f44ca16db",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "98f7439c-cfd3-4bd8-ba91-d22d33923ad1",
            "name": "Product 14939",
            "sku": "sku 14940",
            "updated_datetime": "2025-08-21T17:35:11.254817Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001046",
            "name": "B14946"
          },
          "id": "00000000-0000-0000-0000-0000000001a1",
          "order_item_id": "166d2b01-afbf-4051-b002-6c63f71832c0",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "a2f7a4ee-112a-4574-bbef-848ca1962c13",
            "name": "Product 14944",
            "sku": "sku 14945",
            "updated_datetime": "2025-08-21T17:35:11.292185Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "order": {
        "id": "826f2054-d9a7-4ec7-8d04-dc1d554f884f",
        "order_number": "SO-952",
        "status": "Pending",
        "total": "320.00"
      },
      "owner": {
        "banned": false,
        "email": "owner-22511@example.com",
        "full_name": "FirstName44487 LastName44488",
        "id": "00000000-0000-0000-0000-0000000056d6",
        "role": {
          "id": "00000000-0000-0000-0000-00000000564b",
          "name": "Admin 22007"
        }
      },
      "paid_amount": "0.0",
      "status": "NOT_PAID",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:35:11.432096Z"
    },
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-000000002197",
        "name": "Company 16457",
        "updated_datetime": "2025-08-21T17:35:10.859367Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-22433@example.com",
        "full_name": "FirstName44331 LastName44332",
        "id": "00000000-0000-0000-0000-000000005688",
        "role": {
          "id": "00000000-0000-0000-0000-0000000055fb",
          "name": "Admin 21929"
        }
      },
      "custom_data": [],
      "due_datetime": "2025-08-21T17:35:11.155415Z",
      "id": "00000000-0000-0000-0000-000000000184",
      "inserted_datetime": "2025-08-21T17:35:11.157817Z",
      "invoice_datetime": "2020-01-01T12:20:00.000000Z",
      "invoice_number": "Invoice #356",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001032",
            "name": "B14884"
          },
          "id": "00000000-0000-0000-0000-00000000019e",
          "order_item_id": "ab993043-a591-4163-8e7c-187b4729377d",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "0766ba92-7832-4151-9da2-dfc4e9c3a8f6",
            "name": "Product 14881",
            "sku": "sku 14882",
            "updated_datetime": "2025-08-21T17:35:10.891153Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001035",
            "name": "B14891"
          },
          "id": "00000000-0000-0000-0000-00000000019f",
          "order_item_id": "fedc6687-ebda-4f16-baf2-f41c86ef26c9",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "80bb72a3-4be1-4400-9811-6f15a71ce439",
            "name": "Product 14889",
            "sku": "sku 14890",
            "updated_datetime": "2025-08-21T17:35:10.943449Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "order": {
        "id": "c3ceeb93-74c1-4b2e-98d0-6a7a84a95008",
        "order_number": "SO-950",
        "status": "Pending",
        "total": "320.00"
      },
      "owner": {
        "banned": false,
        "email": "owner-22433@example.com",
        "full_name": "FirstName44331 LastName44332",
        "id": "00000000-0000-0000-0000-000000005688",
        "role": {
          "id": "00000000-0000-0000-0000-0000000055fb",
          "name": "Admin 21929"
        }
      },
      "paid_amount": "0.0",
      "status": "FULLY_PAID",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:35:11.157817Z"
    },
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-000000002171",
        "name": "Company 16374",
        "updated_datetime": "2025-08-21T17:35:10.006068Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-22334@example.com",
        "full_name": "FirstName44135 LastName44136",
        "id": "00000000-0000-0000-0000-000000005624",
        "role": {
          "id": "00000000-0000-0000-0000-000000005597",
          "name": "Admin 21830"
        }
      },
      "custom_data": [],
      "due_datetime": "2025-08-21T17:35:10.334737Z",
      "id": "00000000-0000-0000-0000-000000000180",
      "inserted_datetime": "2025-08-21T17:35:10.337172Z",
      "invoice_datetime": "2020-01-01T12:00:00.000000Z",
      "invoice_number": "Invoice #354",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001014",
            "name": "B14788"
          },
          "id": "00000000-0000-0000-0000-000000000198",
          "order_item_id": "a57be708-b9a2-4a28-9b81-9b94c9d40310",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "5bc8fead-34f2-4e45-9529-3d58d9b961a7",
            "name": "Product 14786",
            "sku": "sku 14787",
            "updated_datetime": "2025-08-21T17:35:10.039283Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001016",
            "name": "B14794"
          },
          "id": "00000000-0000-0000-0000-000000000199",
          "order_item_id": "42c5bbb7-03d2-48d5-88a6-580578a304b6",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "31fdecc2-a24e-4e8c-b361-4c478a1bebfb",
            "name": "Product 14792",
            "sku": "sku 14793",
            "updated_datetime": "2025-08-21T17:35:10.128981Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "order": {
        "id": "2f20c946-aeb6-4f53-9bb8-534d40ca203c",
        "order_number": "SO-947",
        "status": "Pending",
        "total": "320.00"
      },
      "owner": {
        "banned": false,
        "email": "owner-22334@example.com",
        "full_name": "FirstName44135 LastName44136",
        "id": "00000000-0000-0000-0000-000000005624",
        "role": {
          "id": "00000000-0000-0000-0000-000000005597",
          "name": "Admin 21830"
        }
      },
      "paid_amount": "0.0",
      "status": "FULLY_PAID",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:35:10.337172Z"
    }
  ]
}

GET /invoices/:id returns cost/returned_quantity data for invoice items

GET /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcyOTQsImlhdCI6MTc1NTc5NzY5NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTkxMGJiMjUtYzk3NS00MWU0LThiY2ItZDBmMDRlODUyZTJjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NjkzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjA3NzAiLCJ0eXAiOiJhY2Nlc3MifQ.MkfV300AJkSML6R8WH8qUJ694Nrj0Zk1Q-eR-0_LvpQ

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: ba2cd4b9b26e78000000000000000001-9de575149e22360c-0

{
  "data": [
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-000000001fa2",
        "name": "Company 15476",
        "updated_datetime": "2025-08-21T17:34:54.726459Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-21149@example.com",
        "full_name": "FirstName41765 LastName41766",
        "id": "00000000-0000-0000-0000-00000000517e",
        "role": {
          "id": "00000000-0000-0000-0000-0000000050dc",
          "name": "Admin 20641"
        }
      },
      "custom_data": [],
      "due_datetime": "2025-08-21T17:34:55.054529Z",
      "id": "00000000-0000-0000-0000-000000000144",
      "inserted_datetime": "2025-08-21T17:34:55.054930Z",
      "invoice_datetime": "2025-08-21T17:34:55.054527Z",
      "invoice_number": "Invoice #304",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000f0f",
            "name": "B13997"
          },
          "id": "00000000-0000-0000-0000-00000000016b",
          "order_item_id": "0bb062f8-5b78-4b0a-b250-159fb179b9f2",
          "package": null,
          "price": "408917.000000000",
          "product": {
            "id": "d59b0ace-49ed-4d6e-a7df-02718464a89a",
            "name": "Product 13995",
            "sku": "sku 13996",
            "updated_datetime": "2025-08-21T17:34:54.546400Z"
          },
          "quantity": "1.000000000",
          "returned_quantity": "1",
          "total_cost_actual": "10.026",
          "total_cost_default": "5"
        }
      ],
      "order": {
        "id": "92ade3c8-10c5-4dca-b174-bd0187237740",
        "order_number": "SO-0000001",
        "status": "Processing",
        "total": "817834.00"
      },
      "owner": {
        "banned": false,
        "email": "owner-21149@example.com",
        "full_name": "FirstName41765 LastName41766",
        "id": "00000000-0000-0000-0000-00000000517e",
        "role": {
          "id": "00000000-0000-0000-0000-0000000050dc",
          "name": "Admin 20641"
        }
      },
      "paid_amount": "0.0",
      "status": "NOT_PAID",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:34:55.054930Z"
    }
  ]
}

Get invoices sorted by Invoice Date descendingly date and filtered by various attributes

Note: The page size for this endpoint is 500 invoices per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/invoices

Parameters

Parameter	Description	In	Type	Required	Example
due_datetime	Filter invoices by the due datetime	query	string	false	,2022-07-10T00:00:00Z
inserted_datetime	Filter invoices by their creation datetime	query	string	false	2022-07-10T00:00:00Z,2022-07-11T00:00:00Z
invoice_datetime	Filter invoices by the invoice datetime	query	string	false	2022-07-10T00:00:00Z,
invoice_number	Filter invoices by whether their invoice number contains the given string	query	string	false	001
order_id	Filter invoices by order IDs	query	array	false	["67ae9080-8dc2-4ab7-9704-19673f4d9f21","213c7080-8dc2-4ab7-9704-19673f4d9f22"]
page	Pagination information	body	Page	false
status	Filter invoices by their status. Accepted values are "Not Paid", "Over Paid", "Fully Paid" and "Partially Paid".	query	array	false	["Not Paid","Over Paid"]
updated_datetime	Filter invoices by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of invoices	Invoices

Insert a payment for an invoice

POST /invoices/:id/payments can create a payment for an invoice with both quickbooks id and name

POST /public/v1/invoices/00000000-0000-0000-0000-00000000011e/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcyOTAsImlhdCI6MTc1NTc5NzY5MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTc2MmIxNTAtNDRiNC00ZDJmLTk4ZWYtYTAyOTAyNzg3MmFmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Njg5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTk5NzIiLCJ0eXAiOiJhY2Nlc3MifQ.R83fsHcmBcTC0987fLGTfS38m-GHJd2GDvt6yC-ysbA

{
  "amount": 100.01,
  "description": "Payment for invoice",
  "payment_datetime": "2020-01-01T00:00:00.000000Z",
  "payment_method_id": "00000000-0000-0000-0000-000000000083",
  "quickbooks_deposit_account_id": "QBD-123"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: cc6d98506e1d50000000000000000001-0f2fe45f1909b631-0

{
  "data": {
    "amount": "100.01",
    "description": "Payment for invoice",
    "id": "00000000-0000-0000-0000-000000000075",
    "inserted_datetime": "2025-08-21T17:34:50.204641Z",
    "invoice_id": "00000000-0000-0000-0000-00000000011e",
    "payment_date": "2020-01-01T00:00:00.000000Z",
    "payment_method": {
      "id": "00000000-0000-0000-0000-000000000083",
      "name": "Payment Method 0"
    },
    "payment_number": "PYT-0000001",
    "quickbooks_deposit_account_id": "QBD-123"
  }
}

POST /invoices/:id/payments can create a payment for an invoice with both quickbooks id and name

POST /public/v1/invoices/00000000-0000-0000-0000-00000000011e/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcyOTAsImlhdCI6MTc1NTc5NzY5MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTc2MmIxNTAtNDRiNC00ZDJmLTk4ZWYtYTAyOTAyNzg3MmFmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Njg5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTk5NzIiLCJ0eXAiOiJhY2Nlc3MifQ.R83fsHcmBcTC0987fLGTfS38m-GHJd2GDvt6yC-ysbA

{
  "amount": 100.01,
  "description": "Payment for invoice",
  "payment_datetime": "2020-01-01T00:00:00.000000Z",
  "payment_method_id": "00000000-0000-0000-0000-000000000083",
  "quickbooks_deposit_account_name": "QBD-NAME"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: cc6d98506e1d50000000000000000001-bae086da41ef32a6-0

{
  "data": {
    "amount": "100.01",
    "description": "Payment for invoice",
    "id": "00000000-0000-0000-0000-000000000077",
    "inserted_datetime": "2025-08-21T17:34:50.330864Z",
    "invoice_id": "00000000-0000-0000-0000-00000000011e",
    "payment_date": "2020-01-01T00:00:00.000000Z",
    "payment_method": {
      "id": "00000000-0000-0000-0000-000000000083",
      "name": "Payment Method 0"
    },
    "payment_number": "PYT-0000002",
    "quickbooks_deposit_account_id": "QBD-123"
  }
}

Request

POST /public/v1/invoices/{id}/payments

Parameters

Parameter	Description	In	Type	Required
payment_method_id	Payment method ID	query	string	true
amount	Amount of the payment. Will round to 2 decimal places	query	decimal	true
payment_datetime	Payment date	query	string	true
description	Description of the payment	query	string	true
quickbooks_deposit_account_id	Quickbooks deposit account ID. Cannot include both this and quickbooks_deposit_account_name. If user's company is integrated with Quickbooks, either this or quickbooks_deposit_account_name must be provided. Account type must be "Bank" or "Other Current Asset"	query	string	false
quickbooks_deposit_account_name	Quickbooks deposit account name. Cannot include both this and quickbooks_deposit_account_id. If user's company is integrated with Quickbooks, either this or quickbooks_deposit_account_id must be provided. Account type must be "Bank" or "Other Current Asset"	query	string	false

Responses

Status	Description	Schema
200	A single payment	InvoicePayment

Get an invoice

GET /invoices/:id returns the expected invoice

GET /public/v1/invoices/00000000-0000-0000-0000-00000000017b
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMDgsImlhdCI6MTc1NTc5NzcwOCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOGQwODUwYmYtYzMyZS00MDQzLTkxNjUtMTc4MmZhNGZjYjM5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzA3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjE4NjkiLCJ0eXAiOiJhY2Nlc3MifQ.fJRJ-GVkubeI6tfq73HaRNcXy3jvdEFbDoQsfczftVs

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e9a88075286548000000000000000001-67f81cc1cbf5085c-0

{
  "data": {
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-000000002139",
      "name": "Company 16231",
      "updated_datetime": "2025-08-21T17:35:08.415850Z"
    },
    "creator": {
      "banned": false,
      "email": "owner-22154@example.com",
      "full_name": "FirstName43777 LastName43778",
      "id": "00000000-0000-0000-0000-000000005571",
      "role": {
        "id": "00000000-0000-0000-0000-0000000054dc",
        "name": "Admin 21647"
      }
    },
    "custom_data": [
      {
        "id": 79,
        "name": "Custom Field 101",
        "value": "Custom Field Value 1"
      }
    ],
    "due_datetime": "2025-08-21T17:35:08.843426Z",
    "id": "00000000-0000-0000-0000-00000000017b",
    "inserted_datetime": "2025-08-21T17:35:08.845763Z",
    "invoice_datetime": "2025-08-21T17:35:08.843423Z",
    "invoice_number": "Invoice #350",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000ff1",
          "name": "B14682"
        },
        "id": "00000000-0000-0000-0000-000000000192",
        "order_item_id": "c4ea106f-26b6-494c-a607-13a43da40ed9",
        "package": null,
        "price": "10.000000000",
        "product": {
          "id": "4bc65ead-46c8-4c8a-8ddc-05f334e45fed",
          "name": "Product 14679",
          "sku": "sku 14680",
          "updated_datetime": "2025-08-21T17:35:08.458534Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000ff4",
          "name": "B14686"
        },
        "id": "00000000-0000-0000-0000-000000000193",
        "order_item_id": "08d33ab5-38ce-4625-afca-e4eb2ca9992d",
        "package": null,
        "price": "10.000000000",
        "product": {
          "id": "105e0279-a481-4b7d-baf1-15e66acc6538",
          "name": "Product 14684",
          "sku": "sku 14685",
          "updated_datetime": "2025-08-21T17:35:08.538890Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "order": {
      "id": "d0d663f6-e865-4807-a3e1-56be8ea0008c",
      "order_number": "SO-941",
      "status": "Pending",
      "total": "320.00"
    },
    "owner": {
      "banned": false,
      "email": "owner-22154@example.com",
      "full_name": "FirstName43777 LastName43778",
      "id": "00000000-0000-0000-0000-000000005571",
      "role": {
        "id": "00000000-0000-0000-0000-0000000054dc",
        "name": "Admin 21647"
      }
    },
    "paid_amount": "0.0",
    "status": "NOT_PAID",
    "total": "32.00",
    "updated_datetime": "2025-08-21T17:35:08.845763Z"
  }
}

Get a single invoice given the ID

Request

GET /public/v1/invoices/{id}

Parameters

Parameter	Description	In	Type	Required	Default	Example
id	Unique ID for an invoice	path	string	true

Responses

Status	Description	Schema
200	An invoice	Invoice

Upsert an invoice

POST /invoices creates an invoice

POST /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMTMsImlhdCI6MTc1NTc5NzcxMywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZWQwZDYzY2EtOTVhOC00ODdhLTk2NTQtNGJiNmY3ZDkyZDEyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzEyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjI1MTUiLCJ0eXAiOiJhY2Nlc3MifQ._WRVN9D-9_U3Zsex6xg3o6Q0xYV4CooTVKcYB6OyXjM

{
  "billing_location_id": "00000000-0000-0000-0000-00000000199b",
  "charges": [
    {
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "name": "C2",
      "price": "-5.0000",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "due_datetime": "2020-01-30T00:00:01.000000Z",
  "invoice_datetime": "2020-01-01T00:00:00.000000Z",
  "items": [
    {
      "order_item_id": "6c286058-98fe-47bd-9402-955bd92c7c6a",
      "quantity": "1.000000000"
    },
    {
      "order_item_id": "e9704db7-62e3-4c71-b11a-8548038c7e72",
      "quantity": "10.000000000"
    }
  ],
  "order_id": "b393c93e-fd42-49ea-8796-b72f0a5baf63"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 89de505c1c2330000000000000000001-971e22fa1c5c66e2-0

{
  "data": {
    "charges": [
      {
        "id": "79a56081-1e49-4226-8aa7-fa4ce3a83c33",
        "name": "C1",
        "percent": "10.0000",
        "price": "5.30",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "a176cd77-c87a-46aa-ad72-920a1e083499",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-0000000021fc",
      "name": "Company 16673",
      "updated_datetime": "2025-08-21T17:35:13.911511Z"
    },
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-0000000057f3",
      "role": {
        "id": "00000000-0000-0000-0000-000000005767",
        "name": "Admin 22286"
      }
    },
    "custom_data": [],
    "due_datetime": "2020-01-30T00:00:01.000000Z",
    "id": "00000000-0000-0000-0000-00000000018c",
    "inserted_datetime": "2025-08-21T17:35:14.166563Z",
    "invoice_datetime": "2020-01-01T00:00:00.000000Z",
    "invoice_number": "INV-0000001",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001074",
          "name": "B1"
        },
        "id": "00000000-0000-0000-0000-0000000001aa",
        "order_item_id": "6c286058-98fe-47bd-9402-955bd92c7c6a",
        "package": null,
        "price": "3.000000000",
        "product": {
          "id": "1c43c059-1aa3-488b-b5e0-d50e6e830e38",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:35:13.983031Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001075",
          "name": "B2"
        },
        "id": "00000000-0000-0000-0000-0000000001ab",
        "order_item_id": "e9704db7-62e3-4c71-b11a-8548038c7e72",
        "package": null,
        "price": "5.000000000",
        "product": {
          "id": "78387c12-e875-4900-908e-53e71ed64d62",
          "name": "P2",
          "sku": "SKU2",
          "updated_datetime": "2025-08-21T17:35:14.022243Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "order": {
      "id": "b393c93e-fd42-49ea-8796-b72f0a5baf63",
      "order_number": "SO-964",
      "status": "Processing",
      "total": "0.00"
    },
    "owner": null,
    "paid_amount": "0.0",
    "status": "NOT_PAID",
    "total": "53.30",
    "updated_datetime": "2025-08-21T17:35:14.186736Z"
  }
}

POST /invoices updates an invoice

POST /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMTEsImlhdCI6MTc1NTc5NzcxMSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGJhOTEyODMtMzdjNC00NzVjLTkwZDYtMmY1ZWU4MzZhYjhlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzEwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjIzNjEiLCJ0eXAiOiJhY2Nlc3MifQ.xnx9mPwp5QGYSqNL1OK-BMCFOTink_rwT9M3e6Qrk7Q

{
  "billing_location_id": "00000000-0000-0000-0000-00000000197a",
  "charges": [
    {
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "name": "C2",
      "price": "-5.0000",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "due_datetime": "2020-01-30T00:00:01.000000Z",
  "invoice_datetime": "2020-01-01T00:00:00.000000Z",
  "items": [
    {
      "order_item_id": "050e4be0-02e0-45e4-a778-9355e243c5af",
      "quantity": "1.000000000"
    },
    {
      "order_item_id": "0035f3c4-3a69-4bc5-92ac-01f7dc7b3b80",
      "quantity": "10.000000000"
    }
  ],
  "order_id": "678572f2-840f-4f3e-b13a-0774a5282fdc"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e8053dfce7fce8000000000000000001-90d4324c4085d53c-0

{
  "data": {
    "charges": [
      {
        "id": "4fbb89a3-6b24-4fce-83a7-f5f92a9c390c",
        "name": "C1",
        "percent": "10.0000",
        "price": "5.30",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "0bffdd00-74b7-44a6-bfad-12137780a36c",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-0000000021d0",
      "name": "Company 16573",
      "updated_datetime": "2025-08-21T17:35:11.905313Z"
    },
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000005759",
      "role": {
        "id": "00000000-0000-0000-0000-0000000056cf",
        "name": "Admin 22136"
      }
    },
    "custom_data": [],
    "due_datetime": "2020-01-30T00:00:01.000000Z",
    "id": "00000000-0000-0000-0000-000000000189",
    "inserted_datetime": "2025-08-21T17:35:12.087031Z",
    "invoice_datetime": "2020-01-01T00:00:00.000000Z",
    "invoice_number": "INV-0000001",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-00000000105a",
          "name": "B1"
        },
        "id": "00000000-0000-0000-0000-0000000001a6",
        "order_item_id": "050e4be0-02e0-45e4-a778-9355e243c5af",
        "package": null,
        "price": "3.000000000",
        "product": {
          "id": "25664e76-2838-4fff-a757-612e05e4c10e",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:35:11.954027Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-00000000105c",
          "name": "B2"
        },
        "id": "00000000-0000-0000-0000-0000000001a7",
        "order_item_id": "0035f3c4-3a69-4bc5-92ac-01f7dc7b3b80",
        "package": null,
        "price": "5.000000000",
        "product": {
          "id": "4f277553-2b4f-43dc-818c-1cdd24fe3bd4",
          "name": "P2",
          "sku": "SKU2",
          "updated_datetime": "2025-08-21T17:35:11.988751Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "order": {
      "id": "678572f2-840f-4f3e-b13a-0774a5282fdc",
      "order_number": "SO-957",
      "status": "Processing",
      "total": "0.00"
    },
    "owner": null,
    "paid_amount": "0.0",
    "status": "NOT_PAID",
    "total": "53.30",
    "updated_datetime": "2025-08-21T17:35:12.104468Z"
  }
}

POST /invoices updates an invoice

POST /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczMTEsImlhdCI6MTc1NTc5NzcxMSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGJhOTEyODMtMzdjNC00NzVjLTkwZDYtMmY1ZWU4MzZhYjhlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzEwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjIzNjEiLCJ0eXAiOiJhY2Nlc3MifQ.xnx9mPwp5QGYSqNL1OK-BMCFOTink_rwT9M3e6Qrk7Q

{
  "billing_location_id": "00000000-0000-0000-0000-00000000197b",
  "charges": [
    {
      "id": "4fbb89a3-6b24-4fce-83a7-f5f92a9c390c",
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "name": "C3",
      "price": "-5.0000",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "due_datetime": "2020-01-28T00:00:01.000000Z",
  "id": "00000000-0000-0000-0000-000000000189",
  "invoice_datetime": "2020-01-02T00:00:00.000000Z",
  "items": [
    {
      "id": "00000000-0000-0000-0000-0000000001a6",
      "order_item_id": "050e4be0-02e0-45e4-a778-9355e243c5af",
      "quantity": "1.000000000"
    },
    {
      "order_item_id": "0035f3c4-3a69-4bc5-92ac-01f7dc7b3b80",
      "quantity": "8.000000000"
    }
  ],
  "order_id": "678572f2-840f-4f3e-b13a-0774a5282fdc"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e8053dfce7fce8000000000000000001-8126e3cd2f3f2a6c-0

{
  "data": {
    "charges": [
      {
        "id": "4fbb89a3-6b24-4fce-83a7-f5f92a9c390c",
        "name": "C1",
        "percent": "10.0000",
        "price": "4.30",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "6ec6c8b1-fd0d-44bd-887c-59eb2ac4281e",
        "name": "C3",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-0000000021d0",
      "name": "Company 16573",
      "updated_datetime": "2025-08-21T17:35:11.905313Z"
    },
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000005759",
      "role": {
        "id": "00000000-0000-0000-0000-0000000056cf",
        "name": "Admin 22136"
      }
    },
    "custom_data": [],
    "due_datetime": "2020-01-28T00:00:01.000000Z",
    "id": "00000000-0000-0000-0000-000000000189",
    "inserted_datetime": "2025-08-21T17:35:12.087031Z",
    "invoice_datetime": "2020-01-02T00:00:00.000000Z",
    "invoice_number": "INV-0000001",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-00000000105a",
          "name": "B1"
        },
        "id": "00000000-0000-0000-0000-0000000001a6",
        "order_item_id": "050e4be0-02e0-45e4-a778-9355e243c5af",
        "package": null,
        "price": "3.000000000",
        "product": {
          "id": "25664e76-2838-4fff-a757-612e05e4c10e",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:35:11.954027Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-00000000105c",
          "name": "B2"
        },
        "id": "00000000-0000-0000-0000-0000000001a9",
        "order_item_id": "0035f3c4-3a69-4bc5-92ac-01f7dc7b3b80",
        "package": null,
        "price": "5.000000000",
        "product": {
          "id": "4f277553-2b4f-43dc-818c-1cdd24fe3bd4",
          "name": "P2",
          "sku": "SKU2",
          "updated_datetime": "2025-08-21T17:35:11.988751Z"
        },
        "quantity": "8.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "order": {
      "id": "678572f2-840f-4f3e-b13a-0774a5282fdc",
      "order_number": "SO-957",
      "status": "Processing",
      "total": "0.00"
    },
    "owner": null,
    "paid_amount": "0.0",
    "status": "NOT_PAID",
    "total": "42.30",
    "updated_datetime": "2025-08-21T17:35:12.443050Z"
  }
}

POST /invoices reports various errors correctly on update

POST /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcyOTMsImlhdCI6MTc1NTc5NzY5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzRhMzQ4MTItYWIzYy00YWExLTllNWMtMzVhMTNhYmI2OWMxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NjkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjA1MTkiLCJ0eXAiOiJhY2Nlc3MifQ.dO4akTB-oY0eG2j8FFYDiyOzbgR1VrnWYOq7sUkY_F8

{
  "billing_location_id": "00000000-0000-0000-0000-000000001750",
  "charges": [
    {
      "name": "C1",
      "percent": "-1000.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    }
  ],
  "due_datetime": "2020-01-30T00:00:01.000000Z",
  "id": "00000000-0000-0000-0000-000000000133",
  "invoice_datetime": "2020-01-01T00:00:00.000000Z",
  "items": [
    {
      "order_item_id": "00000000-0000-0000-0000-000000000000",
      "quantity": "15.000"
    },
    {
      "order_item_id": "da1704a8-d706-43e0-a86c-a56e39ce4f9a",
      "quantity": "19.000"
    }
  ],
  "order_id": "10b3b954-375d-422c-9c9a-245fb1c86a67"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 47ba721ef00734000000000000000001-3665ef421623c921-0

{
  "errors": [
    {
      "context": {
        "id": "6e4decc0-6774-41b9-80dc-cb8716f6a247"
      },
      "message": "Must be less than or equal to 100",
      "pointer": [
        "charges",
        0,
        "percent"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Order item not found",
      "pointer": [
        "items",
        2,
        "order_item_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Only 10 left uninvoiced",
      "pointer": [
        "items",
        3,
        "quantity"
      ],
      "section": "body"
    }
  ]
}

Upsert a single invoice. To update an existing invoice, pass in an existing invoice ID in the id field. When updating an invoice, you must pass in all fields (no sparse update currently supported). Any existing invoice item or charge you do not pass in to items and charges respectively will be deleted

Request

POST /public/v1/invoices

Parameters

Parameter	Description	In	Type	Required
due_datetime	The datetime at which the invoice is due	query	string	false
id	Unique ID for this invoice. If it exists, an update will be performed; otherwise, it will be used as the ID of a new invoice record	query	string	false
invoice_datetime	The datetime on which the invoice was placed	query	string	false
charges	The additional lines of Charge, Discount, or Tax added to this invoice	body	InvoiceChargesRequest	false
items	The invoice items present on this order	body	InvoiceItemsRequest	false
billing_location_id	The billing location's ID	query	string	false

Responses

Status	Description	Schema
200	A single invoice	Invoice

Location

Get locations

GET /public/v1/locations returns locations related to the company

GET /public/v1/locations
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTYsImlhdCI6MTc1NTc5Nzc5NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODU3M2MzN2YtOTk5MS00MmEwLWFhMGQtZmQ4M2IyMzhiMzU2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc0NDAiLCJ0eXAiOiJhY2Nlc3MifQ.CVkP6Tk0OXcXBiPlF63Pw8tJFhz2ux8_CpPS3fJjycA

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: aa49a47c0951c0000000000000000001-eb5901c824107485-0

{
  "data": [
    {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000006875",
      "id": "00000000-0000-0000-0000-000000002a33",
      "license": null,
      "license_id": null,
      "name": "Place 10647"
    },
    {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000006875",
      "id": "00000000-0000-0000-0000-000000002a34",
      "license": {
        "id": "00000000-0000-0000-0000-000000001c78",
        "license_number": "CDPH-00008116"
      },
      "license_id": "00000000-0000-0000-0000-000000001c78",
      "name": "Place 10648"
    }
  ]
}

Get locations sorted by their creation date and filtered by various attributes

Note: The page size for this endpoint is 1000 locations per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/locations

Parameters

Parameter	Description	In	Type	Required	Example
inserted_datetime	Filter locations by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false
updated_datetime	Filter locations by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of locations	Locations

Order

Get orders

GET /public/v1/orders returns orders related to the company

GET /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxOTEsImlhdCI6MTc1NTc5NzU5MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzYwZGU0MTktMzZlZS00MzZmLTk0NzAtMTk5NTZlOGNjNzcxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTkwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTczMzEiLCJ0eXAiOiJhY2Nlc3MifQ.wNRDPWm2v4YOlhprXsCLx6AWaQfZ9A89qS9Kn1rDSxQ

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 06a10fa243b749c00000000000000001-70d3df9426a419af-0

{
  "data": [
    {
      "billing_location": {
        "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
        "company_id": "00000000-0000-0000-0000-00000000326c",
        "id": "00000000-0000-0000-0000-000000001308",
        "license_id": null,
        "name": "Place 4791"
      },
      "biotrack_id": null,
      "charges": [
        {
          "id": "47b686a4-dd48-46c9-8e09-9e5ee772aa14",
          "name": "C1",
          "percent": "10.0000",
          "price": "1.00",
          "type": "CHARGE",
          "unit_type": "PERCENT"
        }
      ],
      "company": {
        "id": "00000000-0000-0000-0000-000000001a1d",
        "name": "Company 12905",
        "updated_datetime": "2030-11-01T00:00:00.000000Z"
      },
      "creator": {
        "banned": false,
        "email": "user1@a.com",
        "full_name": "John Foo",
        "id": "00000000-0000-0000-0000-0000000043b0",
        "role": {
          "id": "00000000-0000-0000-0000-00000000431c",
          "name": "Admin 17155"
        }
      },
      "custom_data": [
        {
          "id": 45,
          "name": "Custom Field 75",
          "value": "Custom Field Value 1"
        }
      ],
      "delivery_datetime": "2020-01-01T00:00:00.000000Z",
      "due_datetime": "2020-01-01T00:00:01.000000Z",
      "external_notes": null,
      "id": "cdc0dd77-28bb-4662-bddb-e9156950de88",
      "inserted_datetime": "2020-01-01T00:00:03.000000Z",
      "internal_notes": "Internal notes for this order",
      "items": [
        {
          "batch": {
            "batch_number": "UID1",
            "id": "00000000-0000-0000-0000-000000000c8c",
            "name": "B1"
          },
          "compliance_quantity": "10.0000",
          "id": "b31a32b7-b82d-49ae-8bdb-309a805a0189",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-00000000326c",
            "id": "00000000-0000-0000-0000-000000001308",
            "license_id": null,
            "name": "Place 4791"
          },
          "package": {
            "batch_number": "B1",
            "compliance_label": "ABCDEF012345670000069760",
            "id": "00000000-0000-0000-0000-0000000004e4",
            "metrc_label": "ABCDEF012345670000069760",
            "status": "active"
          },
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "13801d2c-868d-4977-9e2a-fc9f18e306fd",
            "name": "P1",
            "sku": "SKU1",
            "updated_datetime": "2023-11-02T00:00:00.000000Z"
          },
          "quantity": "1.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "leaflink_order_number": "572aa693-3342-4cef-b81a-24de6af059d6",
      "metrc_transfer_id": 1,
      "order_datetime": "2020-01-01T00:00:02.000000Z",
      "order_number": "SO-123",
      "owner": {
        "banned": false,
        "email": "user2@a.com",
        "full_name": "John Bar",
        "id": "00000000-0000-0000-0000-0000000043b1",
        "role": {
          "id": "00000000-0000-0000-0000-00000000431d",
          "name": "Admin 17156"
        }
      },
      "shipping_location": {
        "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
        "company_id": "00000000-0000-0000-0000-00000000326c",
        "id": "00000000-0000-0000-0000-000000001308",
        "license_id": null,
        "name": "Place 4791"
      },
      "status": "COMPLETED",
      "total": "11.00",
      "updated_datetime": "2020-01-01T00:00:04.000000Z"
    }
  ]
}

GET /public/v1/orders returns cost/returned_quantity data for order items

GET /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxOTAsImlhdCI6MTc1NTc5NzU5MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWQyMWJkMjgtZDE0ZS00Y2Q2LWI4YTMtZGJjNTJjY2JiYzYxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTg5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTcwOTUiLCJ0eXAiOiJhY2Nlc3MifQ.0ydAbtE4pxMWGP-7Mq-K57fITLg1gUcaOTz8BqE4wl0

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e276db79675570000000000000000001-52064c05d076c122-0

{
  "data": [
    {
      "billing_location": null,
      "biotrack_id": null,
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-0000000019e2",
        "name": "Company 12749",
        "updated_datetime": "2025-08-21T17:33:10.205872Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-17455@example.com",
        "full_name": "FirstName34247 LastName34248",
        "id": "00000000-0000-0000-0000-0000000042e2",
        "role": {
          "id": "00000000-0000-0000-0000-00000000424c",
          "name": "Admin 16948"
        }
      },
      "custom_data": [],
      "delivery_datetime": null,
      "due_datetime": "2025-08-21T17:33:10.207750Z",
      "external_notes": null,
      "id": "eb3bffb6-8fd9-4e58-9286-6b8b3311394b",
      "inserted_datetime": "2025-08-21T17:33:10.238992Z",
      "internal_notes": null,
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000c5c",
            "name": "B11744"
          },
          "compliance_quantity": null,
          "id": "f1ca205b-7084-481e-a626-f9d2061cd3c4",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000031c5",
            "id": "00000000-0000-0000-0000-0000000012c4",
            "license_id": null,
            "name": "Place 4731"
          },
          "package": null,
          "price": "714109.000000000",
          "price_base": "714109",
          "product": {
            "id": "dd6de240-9003-477a-844f-bdaee3b75dd6",
            "name": "Product 11741",
            "sku": "sku 11742",
            "updated_datetime": "2025-08-21T17:33:10.110224Z"
          },
          "quantity": "2.000000000",
          "returned_quantity": "2",
          "total_cost_actual": "20.052",
          "total_cost_default": "10"
        }
      ],
      "leaflink_order_number": null,
      "metrc_transfer_id": null,
      "order_datetime": "2025-08-21T17:33:10.207754Z",
      "order_number": "SO-0000001",
      "owner": null,
      "shipping_location": null,
      "status": "PROCESSING",
      "total": "1428218.00",
      "updated_datetime": "2025-08-21T17:33:10.238992Z"
    }
  ]
}

GET /public/v1/orders allows filtering by several statuses

GET /public/v1/orders?status[]=COMPLETED&status[]=CANCELED
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxODUsImlhdCI6MTc1NTc5NzU4NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODk2Y2E5OTYtYjk5NS00MmQ3LWI4N2MtZTZhYTEzNzBmYWVmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTg0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTYxMDEiLCJ0eXAiOiJhY2Nlc3MifQ.IZiXLdo7hPgd3eGUX4mVxxDi52zwH8yNcq4Vofrey78

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 89dda10b7ac620000000000000000001-d6baf9fd2a50bb38-0

{
  "data": [
    {
      "billing_location": null,
      "biotrack_id": null,
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-0000000018aa",
        "name": "Company 12127",
        "updated_datetime": "2025-08-21T17:33:06.511980Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-16661@example.com",
        "full_name": "FirstName32655 LastName32656",
        "id": "00000000-0000-0000-0000-000000003fc5",
        "role": {
          "id": "00000000-0000-0000-0000-000000003f2f",
          "name": "Admin 16156"
        }
      },
      "custom_data": [],
      "delivery_datetime": null,
      "due_datetime": "2025-08-21T17:33:06.541481Z",
      "external_notes": null,
      "id": "32c7cbd3-7de3-4493-8e8b-206ad7c34be7",
      "inserted_datetime": "2025-08-21T17:33:06.542397Z",
      "internal_notes": null,
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000ba6",
            "name": "B11122"
          },
          "compliance_quantity": null,
          "id": "1a9b3bc5-f611-4825-a74d-2d232c5a29b5",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "4c0d6e63-5042-4360-9c58-78286a21714f",
            "name": "Product 11118",
            "sku": "sku 11119",
            "updated_datetime": "2025-08-21T17:33:06.571423Z"
          },
          "quantity": "15.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000ba7",
            "name": "B11125"
          },
          "compliance_quantity": null,
          "id": "b20a4c7b-7483-4bde-a429-cdd6d702db22",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "c3193b57-b94f-4400-81d8-26d116bc95a5",
            "name": "Product 11123",
            "sku": "sku 11124",
            "updated_datetime": "2025-08-21T17:33:06.624371Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000ba8",
            "name": "B11128"
          },
          "compliance_quantity": null,
          "id": "f3be7a09-5c30-46fe-a05e-1dbc05fb5bd8",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "a3ff62a8-8a49-4fc0-85ec-e53d951a9187",
            "name": "Product 11126",
            "sku": "sku 11127",
            "updated_datetime": "2025-08-21T17:33:06.674705Z"
          },
          "quantity": "5.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000baa",
            "name": "B11140"
          },
          "compliance_quantity": null,
          "id": "c95025fd-f593-4aad-ab78-7fc2ddf99855",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "85d6c985-405c-4853-8fdf-e506d40ef195",
            "name": "Product 11136",
            "sku": "sku 11137",
            "updated_datetime": "2025-08-21T17:33:06.778657Z"
          },
          "quantity": "2.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "leaflink_order_number": null,
      "metrc_transfer_id": null,
      "order_datetime": "2020-01-01T12:30:00.000000Z",
      "order_number": "SO-653",
      "owner": {
        "banned": false,
        "email": "owner-16661@example.com",
        "full_name": "FirstName32655 LastName32656",
        "id": "00000000-0000-0000-0000-000000003fc5",
        "role": {
          "id": "00000000-0000-0000-0000-000000003f2f",
          "name": "Admin 16156"
        }
      },
      "shipping_location": null,
      "status": "CANCELED",
      "total": "320.00",
      "updated_datetime": "2025-08-21T17:33:06.862706Z"
    },
    {
      "billing_location": null,
      "biotrack_id": null,
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-000000001890",
        "name": "Company 12055",
        "updated_datetime": "2025-08-21T17:33:06.160128Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-16589@example.com",
        "full_name": "FirstName32511 LastName32512",
        "id": "00000000-0000-0000-0000-000000003f7d",
        "role": {
          "id": "00000000-0000-0000-0000-000000003ee7",
          "name": "Admin 16084"
        }
      },
      "custom_data": [],
      "delivery_datetime": null,
      "due_datetime": "2025-08-21T17:33:06.230427Z",
      "external_notes": null,
      "id": "16e77892-3b82-4110-aac9-1601e3d96454",
      "inserted_datetime": "2025-08-21T17:33:06.231709Z",
      "internal_notes": null,
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000b95",
            "name": "B11067"
          },
          "compliance_quantity": null,
          "id": "d43898cd-b1c6-45bc-b629-3920053913c7",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "e86b2357-490e-4dda-b292-b8f64ab8aa4f",
            "name": "Product 11063",
            "sku": "sku 11064",
            "updated_datetime": "2025-08-21T17:33:06.266234Z"
          },
          "quantity": "15.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000b98",
            "name": "B11076"
          },
          "compliance_quantity": null,
          "id": "127d68d5-e6c1-427d-97ee-f66686a22f3d",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "0c410ec0-38f9-4002-bafc-135f61c5d927",
            "name": "Product 11074",
            "sku": "sku 11075",
            "updated_datetime": "2025-08-21T17:33:06.315867Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000b9c",
            "name": "B11088"
          },
          "compliance_quantity": null,
          "id": "708e280f-ca98-440a-9023-0fe61423d011",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "34c0dc3b-a431-4e7b-9cba-fed5358afdca",
            "name": "Product 11085",
            "sku": "sku 11086",
            "updated_datetime": "2025-08-21T17:33:06.360640Z"
          },
          "quantity": "5.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000b9f",
            "name": "B11095"
          },
          "compliance_quantity": null,
          "id": "d6085bee-50ed-4639-ad5f-a309466a54bb",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "c9a57d3c-fe06-4d8e-a92a-a308fcff6b9a",
            "name": "Product 11093",
            "sku": "sku 11094",
            "updated_datetime": "2025-08-21T17:33:06.400618Z"
          },
          "quantity": "2.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "leaflink_order_number": null,
      "metrc_transfer_id": null,
      "order_datetime": "2020-01-01T12:20:00.000000Z",
      "order_number": "SO-651",
      "owner": {
        "banned": false,
        "email": "owner-16589@example.com",
        "full_name": "FirstName32511 LastName32512",
        "id": "00000000-0000-0000-0000-000000003f7d",
        "role": {
          "id": "00000000-0000-0000-0000-000000003ee7",
          "name": "Admin 16084"
        }
      },
      "shipping_location": null,
      "status": "COMPLETED",
      "total": "320.00",
      "updated_datetime": "2025-08-21T17:33:06.488403Z"
    },
    {
      "billing_location": null,
      "biotrack_id": null,
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-000000001863",
        "name": "Company 11970",
        "updated_datetime": "2025-08-21T17:33:05.442325Z"
      },
      "creator": {
        "banned": false,
        "email": "owner-16442@example.com",
        "full_name": "FirstName32217 LastName32218",
        "id": "00000000-0000-0000-0000-000000003eea",
        "role": {
          "id": "00000000-0000-0000-0000-000000003e53",
          "name": "Admin 15936"
        }
      },
      "custom_data": [],
      "delivery_datetime": null,
      "due_datetime": "2025-08-21T17:33:05.500343Z",
      "external_notes": null,
      "id": "a6943195-8415-4f12-ac2e-ce20ea533d2b",
      "inserted_datetime": "2025-08-21T17:33:05.502262Z",
      "internal_notes": null,
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000b76",
            "name": "B10964"
          },
          "compliance_quantity": null,
          "id": "d525b34b-983f-4201-9a4d-dc16e57b85ff",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "e9a1da63-8854-4f66-b163-fe39d83a0233",
            "name": "Product 10962",
            "sku": "sku 10963",
            "updated_datetime": "2025-08-21T17:33:05.537513Z"
          },
          "quantity": "15.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000b78",
            "name": "B10972"
          },
          "compliance_quantity": null,
          "id": "3bd7f611-c2b2-4589-ad90-ff111bf665b9",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "0e1c9dea-e375-4e8a-b153-0b7be56645fb",
            "name": "Product 10968",
            "sku": "sku 10969",
            "updated_datetime": "2025-08-21T17:33:05.591110Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000b7a",
            "name": "B10982"
          },
          "compliance_quantity": null,
          "id": "463a88a8-cb02-42f0-b8ab-20e2f83f5510",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "182f5446-3fc5-4e4c-8e24-e6271f9a7771",
            "name": "Product 10980",
            "sku": "sku 10981",
            "updated_datetime": "2025-08-21T17:33:05.634924Z"
          },
          "quantity": "5.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000b7c",
            "name": "B10986"
          },
          "compliance_quantity": null,
          "id": "ad856225-f878-41f9-8365-9a8725086057",
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "1dba15bf-b8f9-4f64-91ab-c96b5f045a55",
            "name": "Product 10984",
            "sku": "sku 10985",
            "updated_datetime": "2025-08-21T17:33:05.687019Z"
          },
          "quantity": "2.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "leaflink_order_number": null,
      "metrc_transfer_id": null,
      "order_datetime": "2020-01-01T12:00:00.000000Z",
      "order_number": "SO-649",
      "owner": {
        "banned": false,
        "email": "owner-16442@example.com",
        "full_name": "FirstName32217 LastName32218",
        "id": "00000000-0000-0000-0000-000000003eea",
        "role": {
          "id": "00000000-0000-0000-0000-000000003e53",
          "name": "Admin 15936"
        }
      },
      "shipping_location": null,
      "status": "COMPLETED",
      "total": "320.00",
      "updated_datetime": "2025-08-21T17:33:05.779562Z"
    }
  ]
}

Get orders sorted by Order Date descendingly date and filtered by various attributes

Note: The page size for this endpoint is 500 orders per page.

Request

GET /public/v1/orders

Parameters

Parameter	Description	In	Type	Required	Example
delivery_datetime	Filter orders by the delivery datetime	query	string	false	2022-07-10T00:00:00Z,
due_datetime	Filter orders by the due datetime	query	string	false	,2022-07-10T00:00:00Z
inserted_datetime	Filter orders by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
order_datetime	Filter orders by the order datetime	query	string	false	2022-07-10T00:00:00Z,2022-07-11T00:00:00Z
page	Pagination information	body	Page	false
status	Filter orders by their status. Accepted values are "PENDING", "PROCESSING", "READY_TO_SHIP", "DELIVERING", "DELIVERED", "COMPLETED" and "CANCELED".	query	array	false	["PENDING","PROCESSING"]
updated_datetime	Filter orders by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of orders	Orders

Get an order

GET /orders/:id returns the expected order

GET /public/v1/orders/c53f83cd-1a77-4958-aa3e-07d00b972b7c
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxODksImlhdCI6MTc1NTc5NzU4OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjllZDc1YTUtNGFjOS00NWVmLTgxYzItZjE3NGZiMzQ1MGRiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTg4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTY5MjEiLCJ0eXAiOiJhY2Nlc3MifQ._OSn0157jbapqnO84IsoHxgeEMx3UxJ74VbvohB6_HU

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: cbc94690e61358000000000000000001-91be7bd103ed8c1b-0

{
  "data": {
    "billing_location": null,
    "biotrack_id": null,
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-00000000198e",
      "name": "Company 12592",
      "updated_datetime": "2025-08-21T17:33:09.295366Z"
    },
    "creator": {
      "banned": false,
      "email": "owner-17259@example.com",
      "full_name": "FirstName33855 LastName33856",
      "id": "00000000-0000-0000-0000-00000000421d",
      "role": {
        "id": "00000000-0000-0000-0000-000000004183",
        "name": "Admin 16749"
      }
    },
    "custom_data": [
      {
        "id": 44,
        "name": "Custom Field 74",
        "value": "Custom Field Value 1"
      }
    ],
    "delivery_datetime": null,
    "due_datetime": "2025-08-21T17:33:09.354800Z",
    "external_notes": null,
    "id": "c53f83cd-1a77-4958-aa3e-07d00b972b7c",
    "inserted_datetime": "2025-08-21T17:33:09.355861Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000c36",
          "name": "B11608"
        },
        "compliance_quantity": null,
        "id": "feeb44be-0a40-4846-b517-0da5a4aade21",
        "location": null,
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "cc0518cf-8a17-4565-a71b-283b7294efdf",
          "name": "Product 11606",
          "sku": "sku 11607",
          "updated_datetime": "2025-08-21T17:33:09.387225Z"
        },
        "quantity": "15.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000c38",
          "name": "B11612"
        },
        "compliance_quantity": null,
        "id": "ece4b955-fd3d-4d99-ab11-dfd5c3f2ed0d",
        "location": null,
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "c64f6184-8fe3-4b1d-a6ba-62cb4b07537c",
          "name": "Product 11610",
          "sku": "sku 11611",
          "updated_datetime": "2025-08-21T17:33:09.405747Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000c3a",
          "name": "B11618"
        },
        "compliance_quantity": null,
        "id": "539e1a17-008a-426a-a2bd-0cd61e094e6e",
        "location": null,
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "5789137b-8de3-44bf-9a13-ca6d7b8fe6d9",
          "name": "Product 11616",
          "sku": "sku 11617",
          "updated_datetime": "2025-08-21T17:33:09.424448Z"
        },
        "quantity": "5.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000c3b",
          "name": "B11621"
        },
        "compliance_quantity": null,
        "id": "bcbaa98f-6c20-432e-9881-f95e83152553",
        "location": null,
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "d4bb195e-2435-4b56-a788-53b83a1abfbd",
          "name": "Product 11619",
          "sku": "sku 11620",
          "updated_datetime": "2025-08-21T17:33:09.443113Z"
        },
        "quantity": "2.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2025-08-21T17:33:09.354799Z",
    "order_number": "SO-675",
    "owner": {
      "banned": false,
      "email": "owner-17259@example.com",
      "full_name": "FirstName33855 LastName33856",
      "id": "00000000-0000-0000-0000-00000000421d",
      "role": {
        "id": "00000000-0000-0000-0000-000000004183",
        "name": "Admin 16749"
      }
    },
    "shipping_location": null,
    "status": "COMPLETED",
    "total": "320.00",
    "updated_datetime": "2025-08-21T17:33:09.477449Z"
  }
}

GET /orders/:id returns cost data for order items

GET /public/v1/orders/63149474-93c5-4a15-988a-af213b5de40e
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxNzcsImlhdCI6MTc1NTc5NzU3NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZWZiOGY1N2MtMjI0ZC00OTYyLWFlMzYtZWQ5OTcxNDMxY2MxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTc2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTQzNTMiLCJ0eXAiOiJhY2Nlc3MifQ.OSJxlfDy-mZE9h5slsDKZy-zD96Rjfi-HRefggNesU4

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 50fd70798cd97c000000000000000001-a4cdb64646c4540c-0

{
  "data": {
    "billing_location": null,
    "biotrack_id": null,
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-00000000164a",
      "name": "Company 11006",
      "updated_datetime": "2025-08-21T17:32:57.808865Z"
    },
    "creator": {
      "banned": false,
      "email": "owner-14716@example.com",
      "full_name": "FirstName28821 LastName28822",
      "id": "00000000-0000-0000-0000-00000000383f",
      "role": {
        "id": "00000000-0000-0000-0000-0000000037c6",
        "name": "Admin 14259"
      }
    },
    "custom_data": [],
    "delivery_datetime": null,
    "due_datetime": "2025-08-21T17:32:57.812948Z",
    "external_notes": null,
    "id": "63149474-93c5-4a15-988a-af213b5de40e",
    "inserted_datetime": "2025-08-21T17:32:57.849575Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000a15",
          "name": "B9781"
        },
        "compliance_quantity": null,
        "id": "9ae1aa26-5657-474a-a6aa-63cce24901a2",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002b23",
          "id": "00000000-0000-0000-0000-000000000fd1",
          "license_id": null,
          "name": "Place 3976"
        },
        "package": null,
        "price": "805258.000000000",
        "price_base": "805258",
        "product": {
          "id": "1f8d296b-a37c-4cc6-9229-eed340ad2cc4",
          "name": "Product 9776",
          "sku": "sku 9777",
          "updated_datetime": "2025-08-21T17:32:57.640837Z"
        },
        "quantity": "2.000000000",
        "returned_quantity": "0",
        "total_cost_actual": "20.052",
        "total_cost_default": "10"
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2025-08-21T17:32:57.812951Z",
    "order_number": "SO-0000001",
    "owner": null,
    "shipping_location": null,
    "status": "PROCESSING",
    "total": "1610516.00",
    "updated_datetime": "2025-08-21T17:32:57.849575Z"
  }
}

Get a single order given the ID. Note: This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/orders/{id}

Parameters

Parameter	Description	In	Type	Required	Default	Example
id	Order ID	path	string	true

Responses

Status	Description	Schema
200	A single order	Order

Upsert an order

POST /public/v1/orders creates an order (with product-tracked item)

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxNjcsImlhdCI6MTc1NTc5NzU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzkwYzExOWItYzcxMi00ZmY3LTkxMTEtOTcyNDIzNDg5NmMxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTE4MzAiLCJ0eXAiOiJhY2Nlc3MifQ.HSrHeSmmEb8cKEXIt0J_SrFkeMSpRcC4dTDS3yxLTQE

{
  "billing_location_id": "00000000-0000-0000-0000-000000000ca6",
  "charges": [
    {
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "name": "C2",
      "price": "-5.0000",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "company_id": "00000000-0000-0000-0000-000000001269",
  "delivery_datetime": "2020-01-01T00:00:00.000000Z",
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "external_notes": "Thank you for ordering!",
  "internal_notes": "Internal notes for this order",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-000000000ca6",
      "price_base": "10.000000000",
      "product_id": "c6a47943-f009-422b-b7b3-0cf25451372d",
      "quantity": "1.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "owner_id": "00000000-0000-0000-0000-000000002e36",
  "shipping_location_id": "00000000-0000-0000-0000-000000000ca6",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 7daa84aadb8c48000000000000000001-4170dcd419222dd9-0

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002477",
      "id": "00000000-0000-0000-0000-000000000ca6",
      "license_id": "00000000-0000-0000-0000-000000000947",
      "name": "Place 3178"
    },
    "biotrack_id": null,
    "charges": [
      {
        "id": "55883965-360a-4579-b566-a80ce2ab107a",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "e7b50a45-6fec-4b35-8581-88a6dad2d09e",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-000000001269",
      "name": "Company 9275",
      "updated_datetime": "2025-08-21T17:32:47.096426Z"
    },
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000002e36",
      "role": {
        "id": "00000000-0000-0000-0000-000000002de4",
        "name": "Admin 11729"
      }
    },
    "custom_data": [
      {
        "id": 32,
        "name": "Custom Field 62",
        "value": null
      }
    ],
    "delivery_datetime": "2020-01-01T00:00:00.000000Z",
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": "Thank you for ordering!",
    "id": "d3fdad1b-cdf2-4443-a7ef-5f8a4ad2a0f5",
    "inserted_datetime": "2025-08-21T17:32:47.239652Z",
    "internal_notes": "Internal notes for this order",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-0000000007f6",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "af39f5aa-1147-4027-83ce-6e583599bbb1",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002477",
          "id": "00000000-0000-0000-0000-000000000ca6",
          "license_id": "00000000-0000-0000-0000-000000000947",
          "name": "Place 3178"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "c6a47943-f009-422b-b7b3-0cf25451372d",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:32:47.157343Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000001",
    "owner": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000002e36",
      "role": {
        "id": "00000000-0000-0000-0000-000000002de4",
        "name": "Admin 11729"
      }
    },
    "shipping_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002477",
      "id": "00000000-0000-0000-0000-000000000ca6",
      "license_id": "00000000-0000-0000-0000-000000000947",
      "name": "Place 3178"
    },
    "status": "PROCESSING",
    "total": "6.00",
    "updated_datetime": "2025-08-21T17:32:47.313384Z"
  }
}

POST /public/v1/orders creates an order (with product-tracked item) for a Blaze retailer, fails if payment type not specified

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxODQsImlhdCI6MTc1NTc5NzU4NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDFjOTM1MDUtMjE2OS00M2FlLTgwYWEtMzNkMWUyZGVmYWI5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTgzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTU4NzEiLCJ0eXAiOiJhY2Nlc3MifQ.1-tETS8Syqsca7j2uPCSeEvQrxHWFMILiHbb8LzqOGw

{
  "billing_location_id": "00000000-0000-0000-0000-000000001157",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-000000001816",
  "delivery_datetime": "2020-01-01T00:00:00.000000Z",
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-000000001157",
      "price_base": "10.000000000",
      "product_id": "11c509d3-036e-4394-96b8-515f7ffc8271",
      "quantity": "1.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "shipping_location_id": "00000000-0000-0000-0000-000000001157",
  "status": "PROCESSING"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 84d4ea1e9f96e0000000000000000001-529cb302def094b7-0

{
  "errors": [
    {
      "context": {
        "id": "f632864e-dac6-4b06-9633-c608352ba54c"
      },
      "message": "can't be blank",
      "pointer": [
        "blaze_payment_type"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/orders creates an order (with product-tracked item) for a Blaze retailer, fails if payment type not specified

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxODQsImlhdCI6MTc1NTc5NzU4NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDFjOTM1MDUtMjE2OS00M2FlLTgwYWEtMzNkMWUyZGVmYWI5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTgzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTU4NzEiLCJ0eXAiOiJhY2Nlc3MifQ.1-tETS8Syqsca7j2uPCSeEvQrxHWFMILiHbb8LzqOGw

{
  "billing_location_id": "00000000-0000-0000-0000-000000001157",
  "blaze_payment_type": "CASH",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-000000001816",
  "delivery_datetime": "2020-01-01T00:00:00.000000Z",
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-000000001157",
      "price_base": "10.000000000",
      "product_id": "11c509d3-036e-4394-96b8-515f7ffc8271",
      "quantity": "1.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "shipping_location_id": "00000000-0000-0000-0000-000000001157",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 84d4ea1e9f96e0000000000000000001-387f7fca34157884-0

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002e77",
      "id": "00000000-0000-0000-0000-000000001157",
      "license_id": "00000000-0000-0000-0000-000000000c9d",
      "name": "Place 4366"
    },
    "biotrack_id": null,
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-000000001816",
      "name": "Company 11825",
      "updated_datetime": "2025-08-21T17:33:04.176057Z"
    },
    "creator": {
      "banned": false,
      "email": "owner-16208@example.com",
      "full_name": "FirstName31749 LastName31750",
      "id": "00000000-0000-0000-0000-000000003dff",
      "role": {
        "id": "00000000-0000-0000-0000-000000003d68",
        "name": "Admin 15701"
      }
    },
    "custom_data": [],
    "delivery_datetime": "2020-01-01T00:00:00.000000Z",
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": null,
    "id": "6667dbd2-3e3a-44d9-8c4b-46c795abb262",
    "inserted_datetime": "2025-08-21T17:33:04.318681Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000b44",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "97819688-7120-4aa6-9462-99ded639bbf2",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002e77",
          "id": "00000000-0000-0000-0000-000000001157",
          "license_id": "00000000-0000-0000-0000-000000000c9d",
          "name": "Place 4366"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "11c509d3-036e-4394-96b8-515f7ffc8271",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:33:04.221011Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000002",
    "owner": null,
    "shipping_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002e77",
      "id": "00000000-0000-0000-0000-000000001157",
      "license_id": "00000000-0000-0000-0000-000000000c9d",
      "name": "Place 4366"
    },
    "status": "PROCESSING",
    "total": "10.00",
    "updated_datetime": "2025-08-21T17:33:04.318681Z"
  }
}

POST /public/v1/orders applies the best fit price tier items to order items

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxODEsImlhdCI6MTc1NTc5NzU4MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODEyMjM2YWQtMWViNS00ZjJjLWExNGQtZDJmNWZhOTY1MjE1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTgwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTUyNTEiLCJ0eXAiOiJhY2Nlc3MifQ.0EH3AaKbm8WwVpjzUXrp9GZNboPSZlauebA_cqE5-Cw

{
  "billing_location_id": "00000000-0000-0000-0000-0000000010af",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-00000000174d",
  "delivery_datetime": "2020-01-01T00:00:00.000000Z",
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-0000000010af",
      "position": 1,
      "price_base": "100.000000000",
      "product_id": "544b697d-85bf-47c2-bf8a-5899523d234b",
      "quantity": "80.000000000"
    },
    {
      "location_id": "00000000-0000-0000-0000-0000000010af",
      "position": 2,
      "price_base": "200.000000000",
      "product_id": "544b697d-85bf-47c2-bf8a-5899523d234b",
      "quantity": "10.000000000"
    },
    {
      "location_id": "00000000-0000-0000-0000-0000000010af",
      "position": 3,
      "price_base": "300.000000000",
      "product_id": "f8952412-3826-4908-9c91-41e2f36c48f4",
      "quantity": "20.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "shipping_location_id": "00000000-0000-0000-0000-0000000010af",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: a08022aaee4838000000000000000001-23fca15f6a46d6ca-0

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002d1a",
      "id": "00000000-0000-0000-0000-0000000010af",
      "license_id": "00000000-0000-0000-0000-000000000c21",
      "name": "Place 4198"
    },
    "biotrack_id": null,
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-00000000174d",
      "name": "Company 11482",
      "updated_datetime": "2025-08-21T17:33:01.495305Z"
    },
    "creator": {
      "banned": false,
      "email": "owner-15594@example.com",
      "full_name": "FirstName30519 LastName30520",
      "id": "00000000-0000-0000-0000-000000003b93",
      "role": {
        "id": "00000000-0000-0000-0000-000000003b05",
        "name": "Admin 15090"
      }
    },
    "custom_data": [],
    "delivery_datetime": "2020-01-01T00:00:00.000000Z",
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": null,
    "id": "aff41617-de62-4f64-830d-04424f3c3bce",
    "inserted_datetime": "2025-08-21T17:33:01.799904Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000ac5",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "054de5f7-bbca-4572-b609-d6dc941b8483",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002d1a",
          "id": "00000000-0000-0000-0000-0000000010af",
          "license_id": "00000000-0000-0000-0000-000000000c21",
          "name": "Place 4198"
        },
        "package": null,
        "price": "80.000000000",
        "price_base": "100.000000000",
        "product": {
          "id": "544b697d-85bf-47c2-bf8a-5899523d234b",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:33:01.548360Z"
        },
        "quantity": "80.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000ac5",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "c68cb421-da83-4548-9752-fe2030288694",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002d1a",
          "id": "00000000-0000-0000-0000-0000000010af",
          "license_id": "00000000-0000-0000-0000-000000000c21",
          "name": "Place 4198"
        },
        "package": null,
        "price": "180.000000000",
        "price_base": "200.000000000",
        "product": {
          "id": "544b697d-85bf-47c2-bf8a-5899523d234b",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:33:01.548360Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000ac7",
          "name": "B2"
        },
        "compliance_quantity": null,
        "id": "50a97fca-113c-438b-9981-05fac71d5772",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002d1a",
          "id": "00000000-0000-0000-0000-0000000010af",
          "license_id": "00000000-0000-0000-0000-000000000c21",
          "name": "Place 4198"
        },
        "package": null,
        "price": "270.000000000",
        "price_base": "300.000000000",
        "product": {
          "id": "f8952412-3826-4908-9c91-41e2f36c48f4",
          "name": "P2",
          "sku": "SKU2",
          "updated_datetime": "2025-08-21T17:33:01.599709Z"
        },
        "quantity": "20.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000001",
    "owner": null,
    "shipping_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002d1a",
      "id": "00000000-0000-0000-0000-0000000010af",
      "license_id": "00000000-0000-0000-0000-000000000c21",
      "name": "Place 4198"
    },
    "status": "PROCESSING",
    "total": "13600.00",
    "updated_datetime": "2025-08-21T17:33:01.897353Z"
  }
}

POST /public/v1/orders creates an order (with batch-tracked item)

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxNzEsImlhdCI6MTc1NTc5NzU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTdkNTUwZDUtODZhYy00ODNkLWIwOTQtYTc0YmI5YzFkYzQzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTI5OTIiLCJ0eXAiOiJhY2Nlc3MifQ.kYjZb2BxGPoum2U-WHSvQuiv2zR2Gy1W7L2T-llD8OI

{
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "items": [
    {
      "batch_id": "00000000-0000-0000-0000-0000000008d7",
      "location_id": "00000000-0000-0000-0000-000000000dea",
      "price_base": "10.000000000",
      "quantity": "1.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: bc8f67aeb08918000000000000000001-b82950e3c7dc6b8c-0

{
  "data": {
    "billing_location": null,
    "biotrack_id": null,
    "charges": [],
    "company": null,
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-0000000032c0",
      "role": {
        "id": "00000000-0000-0000-0000-00000000325e",
        "name": "Admin 12875"
      }
    },
    "custom_data": [],
    "delivery_datetime": null,
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": null,
    "id": "5fe0e2a2-c6ca-48b7-b568-0daba58606e1",
    "inserted_datetime": "2025-08-21T17:32:51.469369Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-0000000008d7",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "f9e21d94-5e90-4e38-9c54-0392c003d4ca",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-00000000279b",
          "id": "00000000-0000-0000-0000-000000000dea",
          "license_id": "00000000-0000-0000-0000-000000000a6f",
          "name": "Place 3495"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "87d6a8d8-91f4-47a5-9686-10a956f7717f",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:32:51.407617Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000001",
    "owner": null,
    "shipping_location": null,
    "status": "PROCESSING",
    "total": "10.00",
    "updated_datetime": "2025-08-21T17:32:51.469369Z"
  }
}

POST /public/v1/orders creates an order (with batch-tracked item without batch set)

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxOTEsImlhdCI6MTc1NTc5NzU5MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTdjNWRjMTktOGExZi00NGFhLTg3ZTgtMWQyMzg4YzY0MzE4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTkwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTczODUiLCJ0eXAiOiJhY2Nlc3MifQ.ANPeiRSQmBc2FC6crtMSzI60HL1y1eXRKk1pUcZfFtI

{
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-000000001318",
      "price_base": "10.000000000",
      "product_id": "58907d96-45e3-4b3a-b0fa-fa950e20fc5b",
      "quantity": "1.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 8f5663ac345088000000000000000001-de28462971581623-0

{
  "data": {
    "billing_location": null,
    "biotrack_id": null,
    "charges": [],
    "company": null,
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-0000000043e9",
      "role": {
        "id": "00000000-0000-0000-0000-000000004356",
        "name": "Admin 17212"
      }
    },
    "custom_data": [],
    "delivery_datetime": null,
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": null,
    "id": "cfd43f06-ed33-406a-9631-607debac3dd5",
    "inserted_datetime": "2025-08-21T17:33:11.619620Z",
    "internal_notes": null,
    "items": [
      {
        "batch": null,
        "compliance_quantity": null,
        "id": "ae64da20-0e4c-434f-8c6f-7f96472e5819",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000003293",
          "id": "00000000-0000-0000-0000-000000001318",
          "license_id": "00000000-0000-0000-0000-000000000dc6",
          "name": "Place 4805"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "58907d96-45e3-4b3a-b0fa-fa950e20fc5b",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:33:11.592374Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000001",
    "owner": null,
    "shipping_location": null,
    "status": "PROCESSING",
    "total": "10.00",
    "updated_datetime": "2025-08-21T17:33:11.619620Z"
  }
}

POST /public/v1/orders creates an order (with package-tracked item)

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxNjgsImlhdCI6MTc1NTc5NzU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMDc4ZjliOGMtOWNjNS00OTBjLWIyZGEtNWJjNzIwOTA2NmYzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTIxOTMiLCJ0eXAiOiJhY2Nlc3MifQ.B9VlR8ptW8jnm7m_Oxup9IPcgS1M-HaEa93DFP28MPs

{
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "items": [
    {
      "compliance_quantity": "1.0000",
      "location_id": "00000000-0000-0000-0000-000000000d0b",
      "package_id": "00000000-0000-0000-0000-000000000349",
      "price_base": "10.000000000",
      "quantity": "1.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 9c1a79b0ecf2e0000000000000000001-ad0766c1df7fba95-0

{
  "data": {
    "billing_location": null,
    "biotrack_id": null,
    "charges": [],
    "company": null,
    "creator": {
      "banned": false,
      "email": "owner-12194@example.com",
      "full_name": "FirstName24361 LastName24362",
      "id": "00000000-0000-0000-0000-000000002fa1",
      "role": {
        "id": "00000000-0000-0000-0000-000000002f4b",
        "name": "Admin 12088"
      }
    },
    "custom_data": [],
    "delivery_datetime": null,
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": null,
    "id": "650412a0-8ff8-47a4-8475-b87863e8aa3a",
    "inserted_datetime": "2025-08-21T17:32:48.779143Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-00000000083f",
          "name": "B1"
        },
        "compliance_quantity": "1.0000",
        "id": "a5efd6e3-a1d3-4514-9e27-122bdf18446e",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-00000000256b",
          "id": "00000000-0000-0000-0000-000000000d0b",
          "license_id": "00000000-0000-0000-0000-00000000099b",
          "name": "Place 3272"
        },
        "package": {
          "batch_number": "B1",
          "compliance_label": "ABCDEF012345670000068496",
          "id": "00000000-0000-0000-0000-000000000349",
          "metrc_label": "ABCDEF012345670000068496",
          "status": "selling"
        },
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "63182117-ef8f-4a38-924c-4887ee03281f",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:32:48.513023Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000001",
    "owner": null,
    "shipping_location": null,
    "status": "PROCESSING",
    "total": "10.00",
    "updated_datetime": "2025-08-21T17:32:48.779143Z"
  }
}

POST /public/v1/orders creates an order (with package-tracked item without package set)

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxODcsImlhdCI6MTc1NTc5NzU4NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiN2VlOGIyYWQtNTYxNi00ODdhLWFjMTUtZWQ3MzBiMjA2N2U4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTg2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTY0MDkiLCJ0eXAiOiJhY2Nlc3MifQ.NpxqicMmTdaOPz6falD-mDucGKJeVn8OOfWxzoJjhus

{
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-0000000011f3",
      "price_base": "10.000000000",
      "product_id": "ca955c43-9171-4edd-9389-8209c887ac28",
      "quantity": "1.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: f9d20cfaba7b88000000000000000001-f4a25c45d5040534-0

{
  "data": {
    "billing_location": null,
    "biotrack_id": null,
    "charges": [],
    "company": null,
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000004019",
      "role": {
        "id": "00000000-0000-0000-0000-000000003f83",
        "name": "Admin 16240"
      }
    },
    "custom_data": [],
    "delivery_datetime": null,
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": null,
    "id": "ac01740c-0c0f-47c5-9919-03312dedf90a",
    "inserted_datetime": "2025-08-21T17:33:07.062941Z",
    "internal_notes": null,
    "items": [
      {
        "batch": null,
        "compliance_quantity": null,
        "id": "35c0ab28-e97c-4ee9-83de-a92ae48c719a",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002fca",
          "id": "00000000-0000-0000-0000-0000000011f3",
          "license_id": "00000000-0000-0000-0000-000000000d08",
          "name": "Place 4522"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "ca955c43-9171-4edd-9389-8209c887ac28",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:33:07.024821Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000001",
    "owner": null,
    "shipping_location": null,
    "status": "PROCESSING",
    "total": "10.00",
    "updated_datetime": "2025-08-21T17:33:07.062941Z"
  }
}

POST /public/v1/orders creates an order with metrc transfer template

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxODIsImlhdCI6MTc1NTc5NzU4MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTI1ZTI2N2UtYjdmNS00OTE4LTk2ZGQtMTczOGJlZDY5NWFiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTgxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTU0MDYiLCJ0eXAiOiJhY2Nlc3MifQ.p97mwTt-YrSmFVxSR6kiwe_O9V8cOOsFhMogYHbjvaY

{
  "billing_location_id": "00000000-0000-0000-0000-0000000010de",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-00000000177b",
  "delivery_datetime": "2020-01-01T00:00:00.000000Z",
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "external_notes": null,
  "items": [
    {
      "compliance_quantity": "1.0000",
      "id": "c6d406e8-8312-4e59-bc0b-e622e6e4a3a2",
      "location_id": "00000000-0000-0000-0000-0000000010de",
      "package_id": "00000000-0000-0000-0000-000000000433",
      "price_base": "10.000000000",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-0000000010de",
  "metrc_transfer_template_directions": "Go to the store around the corner",
  "metrc_transfer_template_recipient_license_number": "C12-0123458-LIC",
  "metrc_transfer_template_status": "PENDING",
  "metrc_transfer_template_transporter_info": [
    {
      "driver_license_number": "1234567890",
      "driver_name": "John Doe",
      "driver_occupational_license_number": "1234567890",
      "driver_phone_number": "1234567890",
      "transporter_license_number": "C12-0123456-LIC",
      "vehicle_license_plate_number": "1234567890",
      "vehicle_make": "Toyota",
      "vehicle_model": "Prius"
    },
    {
      "driver_license_number": "1234567891",
      "driver_name": "Jane Doe",
      "driver_occupational_license_number": "1234567891",
      "driver_phone_number": "1234567891",
      "transporter_license_number": "C12-0123457-LIC",
      "vehicle_license_plate_number": "1234567891",
      "vehicle_make": "Toyota",
      "vehicle_model": "Corolla"
    }
  ],
  "metrc_transfer_template_type": "Transfer",
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "owner_id": "00000000-0000-0000-0000-000000003c2e",
  "shipping_location_id": "00000000-0000-0000-0000-0000000010de",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: c9a27154956968000000000000000001-42b349df0cc608f9-0

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002d72",
      "id": "00000000-0000-0000-0000-0000000010de",
      "license_id": "00000000-0000-0000-0000-000000000c3b",
      "name": "Place 4245"
    },
    "biotrack_id": null,
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-00000000177b",
      "name": "Company 11569",
      "updated_datetime": "2025-08-21T17:33:02.138756Z"
    },
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000003c2e",
      "role": {
        "id": "00000000-0000-0000-0000-000000003b99",
        "name": "Admin 15238"
      }
    },
    "custom_data": [],
    "delivery_datetime": "2020-01-01T00:00:00.000000Z",
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": null,
    "id": "0343cdf2-446e-488a-8e42-348fa45ece50",
    "inserted_datetime": "2025-08-21T17:33:02.411121Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000ad8",
          "name": "B2"
        },
        "compliance_quantity": "1.0000",
        "id": "c6d406e8-8312-4e59-bc0b-e622e6e4a3a2",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002d72",
          "id": "00000000-0000-0000-0000-0000000010de",
          "license_id": "00000000-0000-0000-0000-000000000c3b",
          "name": "Place 4245"
        },
        "package": {
          "batch_number": "B1",
          "compliance_label": "ABCDEF012345670000069260",
          "id": "00000000-0000-0000-0000-000000000433",
          "metrc_label": "ABCDEF012345670000069260",
          "status": "selling"
        },
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "8d7e0f38-5930-4d77-984d-194b0db13ed6",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:33:02.184347Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000001",
    "owner": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000003c2e",
      "role": {
        "id": "00000000-0000-0000-0000-000000003b99",
        "name": "Admin 15238"
      }
    },
    "shipping_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002d72",
      "id": "00000000-0000-0000-0000-0000000010de",
      "license_id": "00000000-0000-0000-0000-000000000c3b",
      "name": "Place 4245"
    },
    "status": "PROCESSING",
    "total": "10.00",
    "updated_datetime": "2025-08-21T17:33:02.587339Z"
  }
}

POST /public/v1/orders updates an order

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxODAsImlhdCI6MTc1NTc5NzU4MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMjgzMTQwOTctY2I5ZS00ODY4LWI2ZDktNDcwOWNiYzdiZGQyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTc5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTUwMjEiLCJ0eXAiOiJhY2Nlc3MifQ.E9ubKG5yk8rUGWmWn9PnYHIHSen_PScyD3W8wz1Tku0

{
  "billing_location_id": "00000000-0000-0000-0000-00000000106e",
  "charges": [
    {
      "id": "3f5ab60c-1af5-4552-9e0a-aa5b62efe753",
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "id": "2ad272b7-096e-4f2e-ab5d-fb1ae2e8d9de",
      "name": "C2",
      "price": "-5.00",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "company_id": "00000000-0000-0000-0000-000000001710",
  "delivery_datetime": "2020-01-01T00:00:00.000000Z",
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "external_notes": "gonna make you sweat",
  "id": "382c9c71-17a3-4f34-ae37-19f54c7f86e0",
  "items": [
    {
      "id": "5ee67ca8-98fa-4d11-a813-f1d37576b3b1",
      "location_id": "00000000-0000-0000-0000-00000000106e",
      "price_base": "10.000000000",
      "product_id": "544dc2c3-e446-4439-af58-b8845924e33b",
      "quantity": "2.000000000"
    },
    {
      "id": "6822270b-b1ee-4d99-9f82-a52b5a046659",
      "location_id": "00000000-0000-0000-0000-00000000106e",
      "price_base": "100.000000000",
      "product_id": "544dc2c3-e446-4439-af58-b8845924e33b",
      "quantity": "3.000000000"
    },
    {
      "compliance_quantity": "1.0000",
      "id": "5e4e4ee5-0146-47ce-8523-5f940c0fd578",
      "location_id": "00000000-0000-0000-0000-00000000106e",
      "package_id": "00000000-0000-0000-0000-00000000041c",
      "price_base": "10.000000000",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-00000000106e",
  "metrc_transfer_template_directions": "Go to the store around the corner",
  "metrc_transfer_template_recipient_license_number": "C12-0123458-LIC",
  "metrc_transfer_template_status": "PENDING",
  "metrc_transfer_template_transporter_info": [
    {
      "driver_license_number": "1234567890",
      "driver_name": "John Doe",
      "driver_occupational_license_number": "1234567890",
      "driver_phone_number": "1234567890",
      "transporter_license_number": "C12-0123456-LIC",
      "vehicle_license_plate_number": "1234567890",
      "vehicle_make": "Toyota",
      "vehicle_model": "Prius"
    },
    {
      "driver_license_number": "1234567891",
      "driver_name": "Jane Doe",
      "driver_occupational_license_number": "1234567891",
      "driver_phone_number": "1234567891",
      "transporter_license_number": "C12-0123457-LIC",
      "vehicle_license_plate_number": "1234567891",
      "vehicle_make": "Toyota",
      "vehicle_model": "Corolla"
    }
  ],
  "metrc_transfer_template_type": "Transfer",
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "owner_id": "00000000-0000-0000-0000-000000003af0",
  "shipping_location_id": "00000000-0000-0000-0000-00000000106e",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 5eead26fb54f20000000000000000001-69723b5d0f848540-0

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002ca5",
      "id": "00000000-0000-0000-0000-00000000106e",
      "license_id": "00000000-0000-0000-0000-000000000beb",
      "name": "Place 4133"
    },
    "biotrack_id": null,
    "charges": [
      {
        "id": "3f5ab60c-1af5-4552-9e0a-aa5b62efe753",
        "name": "C1",
        "percent": "10.0000",
        "price": "33.00",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "2ad272b7-096e-4f2e-ab5d-fb1ae2e8d9de",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-000000001710",
      "name": "Company 11364",
      "updated_datetime": "2025-08-21T17:33:00.117980Z"
    },
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000003aab",
      "role": {
        "id": "00000000-0000-0000-0000-000000003a27",
        "name": "Admin 14868"
      }
    },
    "custom_data": [],
    "delivery_datetime": "2020-01-01T00:00:00.000000Z",
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": "gonna make you sweat",
    "id": "382c9c71-17a3-4f34-ae37-19f54c7f86e0",
    "inserted_datetime": "2025-08-21T17:33:00.613477Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000aa0",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "5ee67ca8-98fa-4d11-a813-f1d37576b3b1",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002ca5",
          "id": "00000000-0000-0000-0000-00000000106e",
          "license_id": "00000000-0000-0000-0000-000000000beb",
          "name": "Place 4133"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "544dc2c3-e446-4439-af58-b8845924e33b",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:33:00.544440Z"
        },
        "quantity": "2.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000aa0",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "6822270b-b1ee-4d99-9f82-a52b5a046659",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002ca5",
          "id": "00000000-0000-0000-0000-00000000106e",
          "license_id": "00000000-0000-0000-0000-000000000beb",
          "name": "Place 4133"
        },
        "package": null,
        "price": "100.000000000",
        "price_base": "100.000000000",
        "product": {
          "id": "544dc2c3-e446-4439-af58-b8845924e33b",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:33:00.544440Z"
        },
        "quantity": "3.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000aa4",
          "name": "B2"
        },
        "compliance_quantity": "1.0000",
        "id": "5e4e4ee5-0146-47ce-8523-5f940c0fd578",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002ca5",
          "id": "00000000-0000-0000-0000-00000000106e",
          "license_id": "00000000-0000-0000-0000-000000000beb",
          "name": "Place 4133"
        },
        "package": {
          "batch_number": "B2",
          "compliance_label": "ABCDEF012345670000069162",
          "id": "00000000-0000-0000-0000-00000000041c",
          "metrc_label": "ABCDEF012345670000069162",
          "status": "selling"
        },
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "725d0083-54fa-44c3-a02a-3dc34fe1ec28",
          "name": "P2",
          "sku": "SKU2",
          "updated_datetime": "2025-08-21T17:33:00.688080Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-629",
    "owner": {
      "banned": false,
      "email": "owner-15430@example.com",
      "full_name": "FirstName30199 LastName30200",
      "id": "00000000-0000-0000-0000-000000003af0",
      "role": {
        "id": "00000000-0000-0000-0000-000000003a6a",
        "name": "Admin 14935"
      }
    },
    "shipping_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002ca5",
      "id": "00000000-0000-0000-0000-00000000106e",
      "license_id": "00000000-0000-0000-0000-000000000beb",
      "name": "Place 4133"
    },
    "status": "PROCESSING",
    "total": "358.00",
    "updated_datetime": "2025-08-21T17:33:01.291309Z"
  }
}

POST /public/v1/orders does not alter locked price tier items on update

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxNzEsImlhdCI6MTc1NTc5NzU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzEyNTA2ZGItY2FlMy00NjA0LTk0YWUtY2FiNjUzYjcwYTNhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTMxNTAiLCJ0eXAiOiJhY2Nlc3MifQ.SwuBAYCAEGiSoYyMf7KYMs2cED-BIn9BROXXcolTSHM

{
  "billing_location_id": "00000000-0000-0000-0000-000000000e19",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-000000001445",
  "delivery_datetime": "2020-01-01T00:00:00.000000Z",
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-000000000e19",
      "position": 1,
      "price_base": "100.000000000",
      "product_id": "ce5e1afd-37b7-4ae8-bfbb-25835e72985c",
      "quantity": "10.000000000"
    },
    {
      "location_id": "00000000-0000-0000-0000-000000000e19",
      "position": 2,
      "price_base": "200.000000000",
      "product_id": "b437e9c8-8eb9-49e3-8920-ba5cd813e441",
      "quantity": "10.000000000"
    },
    {
      "location_id": "00000000-0000-0000-0000-000000000e19",
      "position": 3,
      "price_base": "300.000000000",
      "product_id": "d1e5f1ad-d653-480f-bc6c-8dc24a6a9e25",
      "quantity": "10.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "shipping_location_id": "00000000-0000-0000-0000-000000000e19",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 3c1e02a266c36e000000000000000001-6ca8e3ca6ebfda62-0

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002804",
      "id": "00000000-0000-0000-0000-000000000e19",
      "license_id": "00000000-0000-0000-0000-000000000a89",
      "name": "Place 3542"
    },
    "biotrack_id": null,
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-000000001445",
      "name": "Company 10179",
      "updated_datetime": "2025-08-21T17:32:51.919405Z"
    },
    "creator": {
      "banned": false,
      "email": "owner-13221@example.com",
      "full_name": "FirstName26319 LastName26320",
      "id": "00000000-0000-0000-0000-00000000335e",
      "role": {
        "id": "00000000-0000-0000-0000-0000000032fb",
        "name": "Admin 13032"
      }
    },
    "custom_data": [],
    "delivery_datetime": "2020-01-01T00:00:00.000000Z",
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": null,
    "id": "1256b35f-45d4-455e-9599-e7dc077f9958",
    "inserted_datetime": "2025-08-21T17:32:52.225738Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-0000000008f3",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "d68f4b8e-864b-46a7-8c4d-4780f2ad736e",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002804",
          "id": "00000000-0000-0000-0000-000000000e19",
          "license_id": "00000000-0000-0000-0000-000000000a89",
          "name": "Place 3542"
        },
        "package": null,
        "price": "90.000000000",
        "price_base": "100.000000000",
        "product": {
          "id": "ce5e1afd-37b7-4ae8-bfbb-25835e72985c",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:32:51.962352Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-0000000008f6",
          "name": "B2"
        },
        "compliance_quantity": null,
        "id": "e4692948-0490-4b36-8b17-2ea4e40c95ac",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002804",
          "id": "00000000-0000-0000-0000-000000000e19",
          "license_id": "00000000-0000-0000-0000-000000000a89",
          "name": "Place 3542"
        },
        "package": null,
        "price": "200.000000000",
        "price_base": "200.000000000",
        "product": {
          "id": "b437e9c8-8eb9-49e3-8920-ba5cd813e441",
          "name": "P2",
          "sku": "SKU2",
          "updated_datetime": "2025-08-21T17:32:52.035294Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-0000000008f8",
          "name": "B3"
        },
        "compliance_quantity": null,
        "id": "66431123-5035-4476-9059-b54addb58d6c",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000002804",
          "id": "00000000-0000-0000-0000-000000000e19",
          "license_id": "00000000-0000-0000-0000-000000000a89",
          "name": "Place 3542"
        },
        "package": null,
        "price": "290.000000000",
        "price_base": "300.000000000",
        "product": {
          "id": "d1e5f1ad-d653-480f-bc6c-8dc24a6a9e25",
          "name": "P3",
          "sku": "SKU3",
          "updated_datetime": "2025-08-21T17:32:52.077632Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000001",
    "owner": null,
    "shipping_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000002804",
      "id": "00000000-0000-0000-0000-000000000e19",
      "license_id": "00000000-0000-0000-0000-000000000a89",
      "name": "Place 3542"
    },
    "status": "PROCESSING",
    "total": "5800.00",
    "updated_datetime": "2025-08-21T17:32:52.317556Z"
  }
}

POST /public/v1/orders deleting order items & charges

POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxODksImlhdCI6MTc1NTc5NzU4OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiM2NjMDIwZGMtZmI0My00ZWU5LWJiNmQtYjZmYzYyMjAzOWU3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTg4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTY5ODUiLCJ0eXAiOiJhY2Nlc3MifQ.i-stsURQIdP8-xebs30tOji6c--xFldpBI1W8TAPzQc

{
  "billing_location_id": "00000000-0000-0000-0000-0000000012a9",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-0000000019ab",
  "delivery_datetime": "2020-01-01T00:00:00.000000Z",
  "due_datetime": "2020-01-01T00:00:01.000000Z",
  "id": "c27546c5-4718-46c3-b398-2967450c4c40",
  "items": [
    {
      "id": "244ed5e0-bc83-4211-91df-a4e763363051",
      "location_id": "00000000-0000-0000-0000-0000000012a9",
      "price_base": "10.000000000",
      "product_id": "19fc7e3f-3b57-4f03-8b1c-0e6c973200cd",
      "quantity": "1.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "shipping_location_id": "00000000-0000-0000-0000-0000000012a9",
  "status": "PROCESSING"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 1f316bb05a533c000000000000000001-65b19ee2f128b71c-0

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000003169",
      "id": "00000000-0000-0000-0000-0000000012a9",
      "license_id": "00000000-0000-0000-0000-000000000d6b",
      "name": "Place 4704"
    },
    "biotrack_id": null,
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-0000000019ab",
      "name": "Company 12638",
      "updated_datetime": "2025-08-21T17:33:09.551380Z"
    },
    "creator": {
      "banned": false,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000004259",
      "role": {
        "id": "00000000-0000-0000-0000-0000000041c2",
        "name": "Admin 16811"
      }
    },
    "custom_data": [],
    "delivery_datetime": "2020-01-01T00:00:00.000000Z",
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": null,
    "id": "c27546c5-4718-46c3-b398-2967450c4c40",
    "inserted_datetime": "2025-08-21T17:33:09.649458Z",
    "internal_notes": null,
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000c40",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "244ed5e0-bc83-4211-91df-a4e763363051",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000003169",
          "id": "00000000-0000-0000-0000-0000000012a9",
          "license_id": "00000000-0000-0000-0000-000000000d6b",
          "name": "Place 4704"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "19fc7e3f-3b57-4f03-8b1c-0e6c973200cd",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:33:09.611640Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_order_number": null,
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-678",
    "owner": null,
    "shipping_location": {
      "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
      "company_id": "00000000-0000-0000-0000-000000003169",
      "id": "00000000-0000-0000-0000-0000000012a9",
      "license_id": "00000000-0000-0000-0000-000000000d6b",
      "name": "Place 4704"
    },
    "status": "PROCESSING",
    "total": "10.00",
    "updated_datetime": "2025-08-21T17:33:09.835833Z"
  }
}

Upsert a single order. To update an existing order, pass in an existing order ID in the id field. When updating an order, you must pass in all fields (no sparse update currently supported). Any existing order item or charge you do not pass in to items and charges respectively will be deleted

Request

POST /public/v1/orders

Parameters

Parameter	Description	In	Type	Required	Example
biotrack_id	The Biotrack ID for this order	query	string	false
blaze_payment_type	The payment type for an order shipping to a Blaze-associated company. Required when the company being used is mapped to a Blaze retailer via the Distru integration.	query	string	false	CASH
company_id	Company ID	query	string	false
delivery_datetime	The datetime on which the order was / will be delivered	query	string	false
due_datetime	The datetime by which the order should be completed for the customer	query	string	false
external_notes	This is a message that will be shown to the customer on order slips. This is the "Message to Customer" field in the Distru order form.	query	string	false
id	Unique ID for this order. If it exists, an update will be performed; otherwise, it will be used as the ID of a new order record	query	string	false
order_datetime	The datetime on which the order was placed	query	string	false
charges	The additional lines of Charge, Discount, or Tax added to this order	body	OrderChargesRequest	false
items	The order items present on this order	body	OrderItemsRequest	false
internal_notes	Internal notes for this order	query	string	false
metrc_transfer_template_transporter_info	The Metrc transfer template transporter(s) information about this order	body	OrderTransferTemplateTransporterInfosRequest	false
metrc_transfer_template_directions	The Metrc transfer template directions	query	string	false
metrc_transfer_id	The Metrc transfer ID for this order	query	integer	false
metrc_transfer_template_recipient_license_number	The Metrc transfer template recipient license number	query	string	false
metrc_transfer_template_status	The Metrc transfer template status	query	string	false
metrc_transfer_template_type	The Metrc transfer template type	query	string	false
billing_location_id	The billing location's ID	query	string	false
shipping_location_id	The shipping location's ID	query	string	false
owner_id	The ID of the Distru user that owns this order	query	string	false
status	Filter orders by their status. Accepted values are "PENDING", "PROCESSING", "READY_TO_SHIP", "DELIVERING", "DELIVERED", "COMPLETED" and "CANCELED".	query	string	false	PENDING

Responses

Status	Description	Schema
200	A single order	Order

Package

Get packages

GET /public/v1/packages returns packages related to the company

GET /public/v1/packages
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcxMDEsImlhdCI6MTc1NTc5NzUwMSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMGM1YTZjZjYtNWYwYy00ZDY3LTgzYmItNDE0ODNlYzFiNTA2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NTAwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjkyMSIsInR5cCI6ImFjY2VzcyJ9._VHZ7fHowgTggj95SFlFthErwPzx_hWKiEZ6fWFi2tU

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: d75cd7f8e8cf60000000000000000001-ce5c20f407541dce-0

{
  "data": [
    {
      "batch_number": null,
      "compliance_label": "ABCDEF012345670000000578",
      "custom_data": [
        {
          "id": 9,
          "name": "Custom Field 39",
          "value": "Custom Field Value 1"
        }
      ],
      "expiration_date": "2024-01-01T00:00:00.000000Z",
      "id": "00000000-0000-0000-0000-0000000000e6",
      "is_trade_sample": true,
      "license": {
        "id": "00000000-0000-0000-0000-00000000024e",
        "license_number": "CDPH-00000657"
      },
      "location": {
        "id": "00000000-0000-0000-0000-0000000002f8",
        "name": "Place 728"
      },
      "metrc_label": "ABCDEF012345670000000578",
      "primary_test_result": null,
      "product_id": "bd301bc7-f540-4b14-a89b-30cfbead3e5b",
      "product_unit_quantity": "7.500000000",
      "product_unit_type": {
        "id": "00000000-0000-0000-0000-000000007ee8",
        "name": "3"
      },
      "quantity": "5.000000000",
      "quantity_assembling": "0.000000000",
      "quantity_available": "5.000000000",
      "status": "active",
      "unit_type": {
        "id": "00000000-0000-0000-0000-000000007ee9",
        "name": "2"
      }
    },
    {
      "batch_number": null,
      "compliance_label": "ABCDEF012345670000000591",
      "custom_data": [
        {
          "id": 9,
          "name": "Custom Field 39",
          "value": null
        }
      ],
      "expiration_date": null,
      "id": "00000000-0000-0000-0000-0000000000eb",
      "is_trade_sample": false,
      "license": {
        "id": "00000000-0000-0000-0000-00000000024e",
        "license_number": "CDPH-00000657"
      },
      "location": {
        "id": "00000000-0000-0000-0000-000000000306",
        "name": "Place 741"
      },
      "metrc_label": "ABCDEF012345670000000591",
      "primary_test_result": {
        "cbd_mg_per_unit": "1",
        "cbd_mg_per_unit_total": "2",
        "cbd_percentage": "3",
        "cbd_percentage_total": "4",
        "mg_per_unit_type": "mg/mL",
        "name": "File.pdf",
        "thc_mg_per_unit": "5",
        "thc_mg_per_unit_total": "6",
        "thc_percentage": "7",
        "thc_percentage_total": "8"
      },
      "product_id": "bd301bc7-f540-4b14-a89b-30cfbead3e5b",
      "product_unit_quantity": "15.000000000",
      "product_unit_type": {
        "id": "00000000-0000-0000-0000-000000007ee8",
        "name": "3"
      },
      "quantity": "20.000000000",
      "quantity_assembling": "0.000000000",
      "quantity_available": "20.000000000",
      "status": "active",
      "unit_type": {
        "id": "00000000-0000-0000-0000-000000007ef6",
        "name": "4"
      }
    }
  ]
}

Get packages sorted by their creation date and filtered by various attributes

Note: The page size for this endpoint is 5000 packages per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/packages

Parameters

Parameter	Description	In	Type	Required	Example
inserted_datetime	Filter packages by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false
location_ids	A list of location UUIDs to filter packages by.
query	array	false		["123e4567-e89b-12d3-a456-426655440000","456e89b1-2d3a-4564-2665-544000000000"]
license_number	Filter packages by license number	query	string	false	1234567890
statuses	Filter packages by their status	query	array	false	["active","selling","sold"]
updated_datetime	Filter packages by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of packages	Packages

PaymentMethod

Get payment methods

GET /public/v1/payments/methods returns payment methods related to the user's company only

GET /public/v1/payment-methods
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MDQsImlhdCI6MTc1NTc5NzgwNCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYmQxM2Q2NTgtN2Y0OS00YjhjLWE3OTktY2E3YmUwNmEzOThiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODAzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzg3MzkiLCJ0eXAiOiJhY2Nlc3MifQ.AvzUfgHBGUU4cSGYPsg5uzQoELmdGOYMAKXsKU044vA

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 4588e5515af14c000000000000000001-f896dc07a8f40f6f-0

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-0000000000cf",
      "name": "Payment Method 204"
    }
  ]
}

Get payment methods. Note: This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/payment-methods

Responses

Status	Description	Schema
200	A list of payment methods	PaymentMethods

Product

Get products

GET /public/products returns products related to the company

GET /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MDEsImlhdCI6MTc1NTc5NzgwMSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzFkYTc2MjMtOWVkZi00YTYwLWI2ZGQtYWYwOTdjMzVkYjQyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODAwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzgyNTAiLCJ0eXAiOiJhY2Nlc3MifQ.03AKEhFYOCV2zGzcSdEGVEELpo34PxB81mSP8TZx4KE

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 662b359aae9310000000000000000001-93a202590c0d96fc-0

{
  "data": [
    {
      "brand": {
        "id": "00000000-0000-0000-0000-0000000038fb",
        "name": "Company 27213",
        "updated_datetime": "2030-11-01T00:00:00.000000Z"
      },
      "category": {
        "id": "00000000-0000-0000-0000-00000000321a",
        "name": "Some category 9938",
        "type": "OTHER"
      },
      "custom_data": [
        {
          "id": 131,
          "name": "Custom Field 152",
          "value": "Custom Field Value 1"
        }
      ],
      "description": "test",
      "description_markdown": "# test",
      "external_name": "External Name",
      "id": "a73b6391-2e8a-4f66-a5b0-622331a16328",
      "images": [
        {
          "id": "00000000-0000-0000-0000-000000000096",
          "name": "Image Name 748",
          "rank": 0,
          "url": "https://google.com/original-138.jpg"
        },
        {
          "id": "00000000-0000-0000-0000-000000000097",
          "name": "Image Name 749",
          "rank": 1,
          "url": "https://google.com/original-139.jpg"
        }
      ],
      "is_active": true,
      "msrp": null,
      "name": "Product 26768",
      "sku": "sku 26769",
      "strain": {
        "id": "00000000-0000-0000-0000-00000000013d",
        "name": "Strain 313"
      },
      "subcategory": {
        "id": "00000000-0000-0000-0000-00000000344d",
        "name": "Some subcategory 9429"
      },
      "unit_price": "1",
      "unit_type": {
        "id": "00000000-0000-0000-0000-00000005d99c",
        "name": "Gram"
      },
      "units_per_case": null,
      "updated_datetime": "2023-11-01T00:00:00.000000Z",
      "vendor": {
        "id": "00000000-0000-0000-0000-0000000038fe",
        "name": "Company 27216",
        "updated_datetime": "2030-11-03T00:00:00.000000Z"
      }
    },
    {
      "brand": {
        "id": "00000000-0000-0000-0000-0000000038fd",
        "name": "Company 27215",
        "updated_datetime": "2030-11-02T00:00:00.000000Z"
      },
      "category": {
        "id": "00000000-0000-0000-0000-00000000321b",
        "name": "Some category 9939",
        "type": "OTHER"
      },
      "custom_data": [
        {
          "id": 131,
          "name": "Custom Field 152",
          "value": null
        }
      ],
      "description": null,
      "description_markdown": null,
      "external_name": null,
      "id": "daa8b13c-7179-4f4e-b93c-b49d069b953f",
      "images": [],
      "is_active": false,
      "msrp": "100",
      "name": "Product 26776",
      "sku": "sku 26777",
      "strain": null,
      "subcategory": {
        "id": "00000000-0000-0000-0000-000000003450",
        "name": "Some subcategory 9432"
      },
      "unit_price": "1",
      "unit_type": {
        "id": "00000000-0000-0000-0000-00000005d99a",
        "name": "Pound"
      },
      "units_per_case": null,
      "updated_datetime": "2023-11-02T00:00:00.000000Z",
      "vendor": {
        "id": "00000000-0000-0000-0000-000000003900",
        "name": "Company 27219",
        "updated_datetime": "2030-11-04T00:00:00.000000Z"
      }
    }
  ]
}

Get products sorted by their creation date and filtered by various attributes.

Note: The page size for this endpoint is 5000 products per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/products

Parameters

Parameter	Description	In	Type	Required	Example
inserted_datetime	Filter products by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false
updated_datetime	Filter products by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of products	Products

Upsert a product

POST /public/v1/orders Creates a product with all optional fields set

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MDAsImlhdCI6MTc1NTc5NzgwMCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjRhYWYzMDgtNmUwOS00MDdiLTlmNGQtN2QzNzBhY2I0Zjc3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzgwNjMiLCJ0eXAiOiJhY2Nlc3MifQ.YX8JLPqsr7eY2MxD1InE0kHt6OE-wjtsLHoXHBDpijE

{
  "unit_net_weight_and_serving_size_unit_type_id": "00000000-0000-0000-0000-00000005d174",
  "id": "7335b0dd-3355-481c-a88a-4def5baee1bc",
  "is_featured": true,
  "description_markdown": "# My Product Description Markdown",
  "wholesale_unit_price": "90.50",
  "msrp": "100.5",
  "unit_type_id": "00000000-0000-0000-0000-00000005d17b",
  "quantity_available_threshold_min": "5.5",
  "total_thc": "10.4",
  "brand_id": "00000000-0000-0000-0000-00000000389c",
  "sku": "12345",
  "unit_price": "100",
  "category_id": "00000000-0000-0000-0000-0000000031e1",
  "unit_serving_size": "2.2",
  "tags": [
    "00000000-0000-0000-0000-000000000086"
  ],
  "total_cbd": "5.2",
  "unit_cost": "50.4",
  "group_id": "00000000-0000-0000-0000-00000000266c",
  "is_inactive": true,
  "units_per_case": "0.2",
  "menus": [
    "00000000-0000-0000-0000-000000000321"
  ],
  "vendor_id": "00000000-0000-0000-0000-00000000389a",
  "total_cannabinoid_unit": "PERCENT",
  "menu_visibility": "INCLUDE_IN_ALL",
  "inventory_tracking_method": "PACKAGE",
  "description": "My Product Description",
  "owner_id": "00000000-0000-0000-0000-00000000948d",
  "subcategory_id": "00000000-0000-0000-0000-000000003415",
  "quantity_available_threshold_max": "10.5",
  "upc": "036000291452",
  "unit_net_weight": "3.1",
  "strain_id": "00000000-0000-0000-0000-00000000013c",
  "name": "My Product"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 960e674770b138000000000000000001-a6925f36b22cf13d-0

{
  "data": {
    "brand": {
      "id": "00000000-0000-0000-0000-00000000389c",
      "name": "Company 27084",
      "updated_datetime": "2025-08-21T17:36:40.329668Z"
    },
    "category": {
      "id": "00000000-0000-0000-0000-0000000031e1",
      "name": "Some category 9881",
      "type": "OTHER"
    },
    "custom_data": [
      {
        "id": 129,
        "name": "Custom Field 150",
        "value": null
      }
    ],
    "description": "My Product Description",
    "description_markdown": "# My Product Description Markdown",
    "external_name": null,
    "id": "7335b0dd-3355-481c-a88a-4def5baee1bc",
    "images": [],
    "is_active": false,
    "msrp": "100.5",
    "name": "My Product",
    "sku": "12345",
    "strain": {
      "id": "00000000-0000-0000-0000-00000000013c",
      "name": "Strain 312"
    },
    "subcategory": {
      "id": "00000000-0000-0000-0000-000000003415",
      "name": "Some subcategory 9373"
    },
    "unit_price": "100",
    "unit_type": {
      "id": "00000000-0000-0000-0000-00000005d17b",
      "name": "Unit"
    },
    "units_per_case": "0.2",
    "updated_datetime": "2025-08-21T17:36:40.404601Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-00000000389a",
      "name": "Company 27081",
      "updated_datetime": "2025-08-21T17:36:40.306272Z"
    }
  }
}

POST /public/v1/orders Updates a product with all optional fields set

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTgsImlhdCI6MTc1NTc5Nzc5OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZWJiYjE5N2ItYzEwOC00YmUxLTgxMjYtYmM0MWU3Y2IxNGMwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc4MjIiLCJ0eXAiOiJhY2Nlc3MifQ.PR4ssjWx49QtootgzkzbrCEPmJaisNiCyM42uOQ6r28

{
  "category_id": "00000000-0000-0000-0000-000000003189",
  "id": "99612a2e-19b8-4124-bffc-8c598e3e134f",
  "inventory_tracking_method": "PACKAGE",
  "name": "My Product",
  "sku": "12345",
  "unit_price": "100",
  "unit_type_id": "00000000-0000-0000-0000-00000005c895",
  "upc": "036000291452",
  "vendor_id": "00000000-0000-0000-0000-000000003823"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 53fbdb5a582e90000000000000000001-5d6b73abc6cb4e5c-0

{
  "data": {
    "brand": null,
    "category": {
      "id": "00000000-0000-0000-0000-000000003189",
      "name": "Some category 9793",
      "type": "OTHER"
    },
    "custom_data": [],
    "description": null,
    "description_markdown": null,
    "external_name": null,
    "id": "99612a2e-19b8-4124-bffc-8c598e3e134f",
    "images": [],
    "is_active": true,
    "msrp": null,
    "name": "My Product",
    "sku": "12345",
    "strain": null,
    "subcategory": null,
    "unit_price": "100",
    "unit_type": {
      "id": "00000000-0000-0000-0000-00000005c895",
      "name": "Gram"
    },
    "units_per_case": null,
    "updated_datetime": "2025-08-21T17:36:39.070696Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-000000003823",
      "name": "Company 26889",
      "updated_datetime": "2025-08-21T17:36:38.971815Z"
    }
  }
}

POST /public/v1/orders Updates a product with all optional fields set

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTgsImlhdCI6MTc1NTc5Nzc5OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZWJiYjE5N2ItYzEwOC00YmUxLTgxMjYtYmM0MWU3Y2IxNGMwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc4MjIiLCJ0eXAiOiJhY2Nlc3MifQ.PR4ssjWx49QtootgzkzbrCEPmJaisNiCyM42uOQ6r28

{
  "unit_net_weight_and_serving_size_unit_type_id": "00000000-0000-0000-0000-00000005c897",
  "id": "99612a2e-19b8-4124-bffc-8c598e3e134f",
  "is_featured": true,
  "wholesale_unit_price": "90.50",
  "msrp": "100.5",
  "unit_type_id": "00000000-0000-0000-0000-00000005c89e",
  "quantity_available_threshold_min": "5.5",
  "total_thc": "10.4",
  "brand_id": "00000000-0000-0000-0000-000000003854",
  "sku": "45678",
  "unit_price": "200",
  "category_id": "00000000-0000-0000-0000-0000000031a9",
  "unit_serving_size": "2.2",
  "tags": [
    "00000000-0000-0000-0000-000000000083"
  ],
  "total_cbd": "5.2",
  "unit_cost": "50.4",
  "group_id": "00000000-0000-0000-0000-000000002637",
  "is_inactive": true,
  "units_per_case": "0.2",
  "menus": [
    "00000000-0000-0000-0000-00000000031e"
  ],
  "vendor_id": "00000000-0000-0000-0000-00000000384d",
  "total_cannabinoid_unit": "PERCENT",
  "menu_visibility": "INCLUDE_IN_ALL",
  "inventory_tracking_method": "PACKAGE",
  "description": "My Product Description",
  "owner_id": "00000000-0000-0000-0000-00000000942b",
  "subcategory_id": "00000000-0000-0000-0000-0000000033dd",
  "external_name": "External Name",
  "quantity_available_threshold_max": "10.5",
  "upc": "036000291453",
  "unit_net_weight": "3.1",
  "strain_id": "00000000-0000-0000-0000-00000000013b",
  "name": "Updated Name"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 53fbdb5a582e90000000000000000001-8e04b42a60aa9e62-0

{
  "data": {
    "brand": {
      "id": "00000000-0000-0000-0000-000000003854",
      "name": "Company 26969",
      "updated_datetime": "2025-08-21T17:36:39.481122Z"
    },
    "category": {
      "id": "00000000-0000-0000-0000-0000000031a9",
      "name": "Some category 9825",
      "type": "OTHER"
    },
    "custom_data": [],
    "description": "My Product Description",
    "description_markdown": "My Product Description",
    "external_name": "External Name",
    "id": "99612a2e-19b8-4124-bffc-8c598e3e134f",
    "images": [],
    "is_active": false,
    "msrp": "100.5",
    "name": "Updated Name",
    "sku": "45678",
    "strain": {
      "id": "00000000-0000-0000-0000-00000000013b",
      "name": "Strain 311"
    },
    "subcategory": {
      "id": "00000000-0000-0000-0000-0000000033dd",
      "name": "Some subcategory 9317"
    },
    "unit_price": "200",
    "unit_type": {
      "id": "00000000-0000-0000-0000-00000005c89e",
      "name": "Unit"
    },
    "units_per_case": "0.2",
    "updated_datetime": "2025-08-21T17:36:39.578823Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-00000000384d",
      "name": "Company 26961",
      "updated_datetime": "2025-08-21T17:36:39.434928Z"
    }
  }
}

POST /public/v1/orders Menus act as expected

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTYsImlhdCI6MTc1NTc5Nzc5NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWQ2M2ZkOWUtMTEwNS00Y2EzLWFmNDMtNzQxYTVmYzc3YWRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc0NjUiLCJ0eXAiOiJhY2Nlc3MifQ.5FsfFKfo_S-vil_FnI_MQJbT66HjOcg3WHCEqbvtB5E

{
  "category_id": "00000000-0000-0000-0000-0000000030fe",
  "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
  "inventory_tracking_method": "PACKAGE",
  "menu_visibility": "INCLUDE_IN_ALL",
  "menus": [
    "00000000-0000-0000-0000-000000000313"
  ],
  "name": "My Product",
  "sku": "12345",
  "unit_price": "100",
  "unit_type_id": "00000000-0000-0000-0000-00000005ba7e",
  "upc": "036000291452",
  "vendor_id": "00000000-0000-0000-0000-000000003773"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e23ec7ebc9b230000000000000000001-6ad157523a481440-0

{
  "data": {
    "brand": null,
    "category": {
      "id": "00000000-0000-0000-0000-0000000030fe",
      "name": "Some category 9654",
      "type": "OTHER"
    },
    "custom_data": [],
    "description": null,
    "description_markdown": null,
    "external_name": null,
    "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
    "images": [],
    "is_active": true,
    "msrp": null,
    "name": "My Product",
    "sku": "12345",
    "strain": null,
    "subcategory": null,
    "unit_price": "100",
    "unit_type": {
      "id": "00000000-0000-0000-0000-00000005ba7e",
      "name": "Gram"
    },
    "units_per_case": null,
    "updated_datetime": "2025-08-21T17:36:37.029586Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-000000003773",
      "name": "Company 26625",
      "updated_datetime": "2025-08-21T17:36:36.907795Z"
    }
  }
}

POST /public/v1/orders Menus act as expected

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTYsImlhdCI6MTc1NTc5Nzc5NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWQ2M2ZkOWUtMTEwNS00Y2EzLWFmNDMtNzQxYTVmYzc3YWRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc0NjUiLCJ0eXAiOiJhY2Nlc3MifQ.5FsfFKfo_S-vil_FnI_MQJbT66HjOcg3WHCEqbvtB5E

{
  "category_id": "00000000-0000-0000-0000-0000000030fe",
  "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
  "inventory_tracking_method": "PACKAGE",
  "menu_visibility": "DO_NOT_INCLUDE",
  "menus": [
    "00000000-0000-0000-0000-000000000313",
    "00000000-0000-0000-0000-000000000314"
  ],
  "name": "My Product",
  "sku": "12345",
  "tags": [],
  "unit_price": "100",
  "unit_type_id": "00000000-0000-0000-0000-00000005ba7e",
  "upc": "036000291452",
  "vendor_id": "00000000-0000-0000-0000-000000003773"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e23ec7ebc9b230000000000000000001-8bfd3d0743437055-0

{
  "data": {
    "brand": null,
    "category": {
      "id": "00000000-0000-0000-0000-0000000030fe",
      "name": "Some category 9654",
      "type": "OTHER"
    },
    "custom_data": [],
    "description": null,
    "description_markdown": null,
    "external_name": null,
    "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
    "images": [],
    "is_active": true,
    "msrp": null,
    "name": "My Product",
    "sku": "12345",
    "strain": null,
    "subcategory": null,
    "unit_price": "100",
    "unit_type": {
      "id": "00000000-0000-0000-0000-00000005ba7e",
      "name": "Gram"
    },
    "units_per_case": null,
    "updated_datetime": "2025-08-21T17:36:37.249476Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-000000003773",
      "name": "Company 26625",
      "updated_datetime": "2025-08-21T17:36:36.907795Z"
    }
  }
}

POST /public/v1/orders Menus act as expected

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTYsImlhdCI6MTc1NTc5Nzc5NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWQ2M2ZkOWUtMTEwNS00Y2EzLWFmNDMtNzQxYTVmYzc3YWRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc0NjUiLCJ0eXAiOiJhY2Nlc3MifQ.5FsfFKfo_S-vil_FnI_MQJbT66HjOcg3WHCEqbvtB5E

{
  "category_id": "00000000-0000-0000-0000-0000000030fe",
  "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
  "inventory_tracking_method": "PACKAGE",
  "menu_visibility": "INCLUDE_IN_SELECT",
  "menus": [
    "00000000-0000-0000-0000-000000000313",
    "00000000-0000-0000-0000-000000000314"
  ],
  "name": "My Product",
  "sku": "12345",
  "tags": [],
  "unit_price": "100",
  "unit_type_id": "00000000-0000-0000-0000-00000005ba7e",
  "upc": "036000291452",
  "vendor_id": "00000000-0000-0000-0000-000000003773"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e23ec7ebc9b230000000000000000001-dee49f1035620d50-0

{
  "data": {
    "brand": null,
    "category": {
      "id": "00000000-0000-0000-0000-0000000030fe",
      "name": "Some category 9654",
      "type": "OTHER"
    },
    "custom_data": [],
    "description": null,
    "description_markdown": null,
    "external_name": null,
    "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
    "images": [],
    "is_active": true,
    "msrp": null,
    "name": "My Product",
    "sku": "12345",
    "strain": null,
    "subcategory": null,
    "unit_price": "100",
    "unit_type": {
      "id": "00000000-0000-0000-0000-00000005ba7e",
      "name": "Gram"
    },
    "units_per_case": null,
    "updated_datetime": "2025-08-21T17:36:37.618040Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-000000003773",
      "name": "Company 26625",
      "updated_datetime": "2025-08-21T17:36:36.907795Z"
    }
  }
}

POST /public/v1/orders Menus act as expected

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTYsImlhdCI6MTc1NTc5Nzc5NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWQ2M2ZkOWUtMTEwNS00Y2EzLWFmNDMtNzQxYTVmYzc3YWRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc0NjUiLCJ0eXAiOiJhY2Nlc3MifQ.5FsfFKfo_S-vil_FnI_MQJbT66HjOcg3WHCEqbvtB5E

{
  "category_id": "00000000-0000-0000-0000-0000000030fe",
  "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
  "inventory_tracking_method": "PACKAGE",
  "menu_visibility": "INCLUDE_IN_SELECT",
  "menus": [
    "00000000-0000-0000-0000-000000000314"
  ],
  "name": "My Product",
  "sku": "12345",
  "unit_price": "100",
  "unit_type_id": "00000000-0000-0000-0000-00000005ba7e",
  "upc": "036000291452",
  "vendor_id": "00000000-0000-0000-0000-000000003773"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e23ec7ebc9b230000000000000000001-6424473bb2d348ad-0

{
  "data": {
    "brand": null,
    "category": {
      "id": "00000000-0000-0000-0000-0000000030fe",
      "name": "Some category 9654",
      "type": "OTHER"
    },
    "custom_data": [],
    "description": null,
    "description_markdown": null,
    "external_name": null,
    "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
    "images": [],
    "is_active": true,
    "msrp": null,
    "name": "My Product",
    "sku": "12345",
    "strain": null,
    "subcategory": null,
    "unit_price": "100",
    "unit_type": {
      "id": "00000000-0000-0000-0000-00000005ba7e",
      "name": "Gram"
    },
    "units_per_case": null,
    "updated_datetime": "2025-08-21T17:36:37.701329Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-000000003773",
      "name": "Company 26625",
      "updated_datetime": "2025-08-21T17:36:36.907795Z"
    }
  }
}

POST /public/v1/orders Menus act as expected

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTYsImlhdCI6MTc1NTc5Nzc5NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWQ2M2ZkOWUtMTEwNS00Y2EzLWFmNDMtNzQxYTVmYzc3YWRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc0NjUiLCJ0eXAiOiJhY2Nlc3MifQ.5FsfFKfo_S-vil_FnI_MQJbT66HjOcg3WHCEqbvtB5E

{
  "category_id": "00000000-0000-0000-0000-0000000030fe",
  "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
  "inventory_tracking_method": "PACKAGE",
  "menu_visibility": "INCLUDE_IN_SELECT",
  "menus": [],
  "name": "My Product",
  "sku": "12345",
  "unit_price": "100",
  "unit_type_id": "00000000-0000-0000-0000-00000005ba7e",
  "upc": "036000291452",
  "vendor_id": "00000000-0000-0000-0000-000000003773"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e23ec7ebc9b230000000000000000001-10952ff9c770b35c-0

{
  "data": {
    "brand": null,
    "category": {
      "id": "00000000-0000-0000-0000-0000000030fe",
      "name": "Some category 9654",
      "type": "OTHER"
    },
    "custom_data": [],
    "description": null,
    "description_markdown": null,
    "external_name": null,
    "id": "43996878-7f0d-47b1-b528-5acab4aab84f",
    "images": [],
    "is_active": true,
    "msrp": null,
    "name": "My Product",
    "sku": "12345",
    "strain": null,
    "subcategory": null,
    "unit_price": "100",
    "unit_type": {
      "id": "00000000-0000-0000-0000-00000005ba7e",
      "name": "Gram"
    },
    "units_per_case": null,
    "updated_datetime": "2025-08-21T17:36:37.738060Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-000000003773",
      "name": "Company 26625",
      "updated_datetime": "2025-08-21T17:36:36.907795Z"
    }
  }
}

POST /public/v1/orders Error pointers are properly transformed to reflect the field name that our api users expect

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MDAsImlhdCI6MTc1NTc5NzgwMCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMWMwYzcwM2UtYWQwNC00YzMwLTllNjEtYmQzNDkyNDBlZjdjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzgxOTQiLCJ0eXAiOiJhY2Nlc3MifQ.w548GcRsQFFO_ffdp3pn9PaF17r8mhMgddZnc2IOvi4

{
  "id": "69df6e0f-2f18-4cd1-9ecb-0a80df717164",
  "menu_visibility": "INCLUDE_IN_ALL",
  "quantity_available_threshold_max": "-4.5",
  "quantity_available_threshold_min": "-5.5",
  "unit_net_weight": "3.1",
  "unit_serving_size": "5.2"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: f65daf03634550000000000000000001-0a27bba7ba6f059a-0

{
  "errors": [
    {
      "context": {
        "id": "69df6e0f-2f18-4cd1-9ecb-0a80df717164"
      },
      "message": "A unit type needs to be selected when setting Unit Net Weight/Volume or Unit Serving Size",
      "pointer": [
        "unit_net_weight_and_serving_size_unit_type_id"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "69df6e0f-2f18-4cd1-9ecb-0a80df717164"
      },
      "message": "Unit Serving Size can't be greater than Unit Net Weight/Volume",
      "pointer": [
        "unit_serving_size"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "69df6e0f-2f18-4cd1-9ecb-0a80df717164"
      },
      "message": "Cannot be negative",
      "pointer": [
        "quantity_available_threshold_max"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "69df6e0f-2f18-4cd1-9ecb-0a80df717164"
      },
      "message": "Cannot be negative",
      "pointer": [
        "quantity_available_threshold_min"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/orders Errors when threshold max is less than threshold min

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTgsImlhdCI6MTc1NTc5Nzc5OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTI0ZjlhNDYtM2Q2Ni00YzY2LTgxMjAtM2ZjYmI5NzliNjEzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc3ODgiLCJ0eXAiOiJhY2Nlc3MifQ.ZVhTuyClwoF1HNnMqTTUododU0y2EtdtKXTX9nVXeow

{
  "id": "a2d817c2-2ec2-4072-8e8b-02dbffc245c9",
  "quantity_available_threshold_max": "4.5",
  "quantity_available_threshold_min": "5.5"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: bdff74c5bedfd8000000000000000001-b1b5249cc776dea4-0

{
  "errors": [
    {
      "context": {
        "id": "a2d817c2-2ec2-4072-8e8b-02dbffc245c9"
      },
      "message": "Must be greater than threshold min",
      "pointer": [
        "quantity_available_threshold_max"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "a2d817c2-2ec2-4072-8e8b-02dbffc245c9"
      },
      "message": "Must be less than threshold max",
      "pointer": [
        "quantity_available_threshold_min"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/orders Cannot use associations from another company

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTgsImlhdCI6MTc1NTc5Nzc5OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMjkzOTlmMTgtMzZmYy00MDI1LWFmMmMtM2E3Zjc5ZmYwNjg4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc3MTkiLCJ0eXAiOiJhY2Nlc3MifQ.cv6gJCS4qaZTmhukvY74xEdlrEJfHuZfVS-q7nN4b6M

{
  "brand_id": "00000000-0000-0000-0000-0000000037fa",
  "category_id": "00000000-0000-0000-0000-000000003161",
  "cbd": "5.2",
  "description": "My Product Description",
  "description_markdown": "# My Product Description Markdown",
  "group_id": "00000000-0000-0000-0000-0000000025f9",
  "id": "38b083bb-f754-408e-8d52-9409d264aba5",
  "inventory_tracking_method": "PACKAGE",
  "is_featured": true,
  "is_inactive": true,
  "menu_visibility": "INCLUDE_IN_ALL",
  "menus": [
    "00000000-0000-0000-0000-000000000318",
    "00000000-0000-0000-0000-000000000319",
    "00000000-0000-0000-0000-00000000031a"
  ],
  "msrp": "100.5",
  "name": "My Product",
  "owner_id": "00000000-0000-0000-0000-000000009361",
  "quantity_available_threshold_max": "10.5",
  "quantity_available_threshold_min": "5.5555",
  "sku": "12345",
  "strain_id": "00000000-0000-0000-0000-000000000130",
  "subcategory_id": "00000000-0000-0000-0000-0000000033a1",
  "tags": [
    "00000000-0000-0000-0000-00000000007f",
    "00000000-0000-0000-0000-000000000080",
    "00000000-0000-0000-0000-000000000081"
  ],
  "thc": "10.4",
  "unit_cost": "50.4",
  "unit_net_weight": "3.1",
  "unit_net_weight_and_serving_size_unit_type_id": "00000000-0000-0000-0000-00000005c52a",
  "unit_price": "100",
  "unit_serving_size": "2.2",
  "unit_type_id": "00000000-0000-0000-0000-00000005c531",
  "units_per_case": "0.2",
  "upc": "036000291452",
  "vendor_id": "00000000-0000-0000-0000-0000000037f7",
  "wholesale_unit_price": "90.50"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 67336fdd276f74000000000000000001-43dff1dd67e50bfb-0

{
  "errors": [
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "Brand does not exist",
      "pointer": [
        "brand_id"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "Category does not exist",
      "pointer": [
        "category_id"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "Vendor does not exist",
      "pointer": [
        "vendor_id"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "Group does not exist",
      "pointer": [
        "group_id"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "Serving unit type does not exist",
      "pointer": [
        "unit_net_weight_and_serving_size_unit_type_id"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "Owner does not exist",
      "pointer": [
        "owner_id"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "Strain does not exist",
      "pointer": [
        "strain_id"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "Subcategory does not belong to the product category",
      "pointer": [
        "subcategory_id"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "One or more of the provided tags do not exist",
      "pointer": [
        "tags"
      ],
      "section": "body"
    },
    {
      "context": {
        "id": "38b083bb-f754-408e-8d52-9409d264aba5"
      },
      "message": "Unit type does not exist",
      "pointer": [
        "unit_type_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Menu does not exist",
      "pointer": [
        "menus",
        0,
        "00000000-0000-0000-0000-000000000318"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Menu does not exist",
      "pointer": [
        "menus",
        1,
        "00000000-0000-0000-0000-000000000319"
      ],
      "section": "body"
    }
  ]
}

Upsert a single product. To update an existing product, pass in an existing product ID in the id field. When updating a product, you must pass in all fields (no sparse update currently supported).Any existing tag you do not pass in to tags will be deleted. If the menu_visibility field isset to INCLUDE_IN_SELECT, any existing menu that you do not pass into menus will be deleted.

Request

POST /public/v1/products

Parameters

Parameter	Description	In	Type	Required	Example
id	Unique ID for this product. If it exists, an update will be performed; otherwise, it will be used as the ID of a new product record	query	string	false
inventory_tracking_method	Once the tracking method is set for a product, it cannot be changed. The tracking method can be one of the following: PACKAGE: The inventory will be defined by packages. PRODUCT: Not grouped in any manner. The inventory simply exists on your product that you can add or remove as you transact. BATCH: Grouped by batches. Batches share common traits such as expiration dates and test results.	query	string	false	PACKAGE
sku	Stock Keeping Unit (SKU) for this product	query	string	false	SKU123
name	Name of the product	query	string	false	King Size Pre-rolls
vendor_id	The ID of the company_relationship association with the vendor (company) that supplies this product.	query	string	false
category_id	The ID of the product category of the product.	query	string	false
external_name	Customer-facing name for DistruCommerce menus and Order Tracker. Defaults to Product Name if left blank	query	string	false
unit_type_id	The ID of the unit type the product.	query	string	false
unit_price	The sale price of the product per unit.	query	number	false
description	Description of the product. If this field is provided and description_markdown is not, the description field will overwrite any existing description_markdown field.	query	string	false	A pack of 5 pre-rolls
description_markdown	The description of the product in markdown format. If this field is provided, description must also be provided. The markdown display only supports italic, bold, strikethrough and links. Use any other markdown formatting at your own risk.	query	string	false	A pack of 5 pre-rolls
upc	Universal Product Code (UPC) for this product	query	string	false	123456789012
subcategory_id	The ID of the product subcategory of the product. The provided subcategory must be a child of the provided category.	query	string	false
group_id	The ID of the product's group.	query	string	false
brand_id	The ID of the company_relationship association with the brand (company) that is associated with this product.	query	query	false
quantity_available_threshold_min	The minimum quantity of the product you'd like to maintain. When the product inventory count dips below this number, it will automatically be included in scheduled Low Inventory Reports.	query	number	false
quantity_available_threshold_max	The maximum quantity of the product you'd like to maintain. When the product inventory count exceeds this number, it will automatically be included in scheduled Inventory Reports.	query	number	false
units_per_case	The number of units in a case of the product.	query	number	false
unit_cost	The cost of the product per unit.	query	number	false
msrp	The Manufacturer's Suggested Retail Price (MSRP) of the product per unit. If you have POS integrations enabled in Distru, this may be synced to your POS	query	number	false
wholesale_unit_price	The wholesale price of the product per unit.	query	number	false
is_featured	Whether the product is featured. Featured products will be displayed at the top of menus.	query	boolean	false
strain_id	The ID of the strain associated with the product.	query	string	false
owner_id	The ID of the user that is deemed to be the owner of the product.	query	string	false
is_inactive	Whether the product is inactive from use. Inactive products can be set to active at any time.	query	boolean	false
total_cannabinoid_unit	The unit of the THC/CBD content of the product (MG or PERCENT).	query	string	false
total_thc	The THC content of the product in the unit specified by total_cannabinoid_unit. Must also include total_cannabinoid_unit.	query	string	false
total_cbd	The CBD content of the product in the unit specified by total_cannabinoid_unit. Must also include total_cannabinoid_unit.	query	string	false
menu_visibility	This key is responsible for which menus (if any) the product will be displayed in. DO_NOT_INCLUDE: The product will not be displayed in any menus. INCLUDE_IN_ALL: The product will be displayed in all menus. INCLUDE_IN_SELECT: The product will be displayed in menus that have been explicitly selected (passed into the menus list).	query	string	false
unit_net_weight	The net weight of the product per unit.	query	number	false
unit_serving_size	The serving size of the product per unit.	query	number	false
unit_net_weight_and_serving_size_unit_type_id	The ID of the unit type that the net quantity per unit and serving size are measured in. This field should be null unless the product's unit type is count-based. If this field is set, the act of changing the category from 'Unit' will throw an error.	query	string	false
tags	A list of tags associated with the product.	query	array	false	["0ef8347c-b714-4cd9-ba0e-872488bc9244", "daa0294c-833c-42bd-a133-b4c9e7f64017"]
menus	A list of menus you would like this product to be included in. This field will only be used if the menu_visibility key is set to INCLUDE_IN_SELECT.	query	array	false	["0ef8347c-b714-4cd9-ba0e-872488bc9244", "daa0294c-833c-42bd-a133-b4c9e7f64017"]

Responses

Status	Description	Schema
200	A single product	Product

ProductPosMapping

Delete a product POS mapping

DELETE /public/v1/product-pos-mappings/:id deletes a POS mapping

DELETE /public/v1/product-pos-mappings/285
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcyOTIsImlhdCI6MTc1NTc5NzY5MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDQ2YmQxMzMtM2ZmOC00OTAyLWJiY2QtYWExYjlkYjY1Zjg2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NjkxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjA0MjYiLCJ0eXAiOiJhY2Nlc3MifQ.kBfG0yX89yi02LbQHuu5humhYoqz41pupL2RZ1lyWe0

Response

204
cache-control: max-age=0, private, must-revalidate
b3: ffecfb3b89a2d8000000000000000001-7d95511fadfafa13-0

Request

DELETE /public/v1/product-pos-mappings/{id}

Parameters

Parameter	Description	In	Type	Required	Default	Example
id	Mapping ID	path	string	true

Responses

Status	Description	Schema
204	No Content
401	Unauthorized
404	Not Found

List product POS mappings

GET /public/v1/product-pos-mappings returns all POS mappings for company products and supports filtering

GET /public/v1/product-pos-mappings
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcyOTQsImlhdCI6MTc1NTc5NzY5NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzgxMDNjNDQtMDVkMS00ZjkzLWE3OGQtMjY3ZDA1ZmYwY2JlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NjkzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjA3MDQiLCJ0eXAiOiJhY2Nlc3MifQ.XxovtvybnEcKkxy4VQBKt4xVet6KJ2qu47QYD2ot3Ig

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: a36482efaf6d78000000000000000001-73d0b87af513cbfa-0

{
  "data": [
    {
      "blaze_asset_id": null,
      "blaze_product_id": "blaze_123",
      "blaze_retailer_id": "e5a1d032-26e0-4e7c-bae5-2a8a76622ad9",
      "id": 295,
      "inserted_at": "2025-08-21T17:34:54.226917Z",
      "pos_type": "BLAZE",
      "product_id": "45ba2bfc-1eba-400c-ae0e-fc0a7981bf81",
      "updated_at": "2025-08-21T17:34:54.226917Z"
    },
    {
      "dutchie_product_id": 456,
      "dutchie_retailer_id": "f9d93b3f-c9c4-4cbf-99b8-558d2e1a0a53",
      "id": 296,
      "inserted_at": "2025-08-21T17:34:54.267800Z",
      "pos_type": "DUTCHIE",
      "product_id": "52c019be-1cd9-4876-9333-e491b69527f6",
      "updated_at": "2025-08-21T17:34:54.267800Z"
    }
  ]
}

Get POS mappings with optional filtering by product_id or retailer_id

Request

GET /public/v1/product-pos-mappings

Parameters

Parameter	Description	In	Type	Required
product_id	Filter by product ID	query	string	false
blaze_retailer_id	Filter by Blaze retailer ID	query	string	false
dutchie_retailer_id	Filter by Dutchie retailer ID	query	string	false
treez_retailer_id	Filter by Treez retailer ID	query	string	false

Responses

Status	Description	Schema
200	Success	ProductPosMappingsResponse
400	Bad Request
401	Unauthorized

Create or update a product POS mapping

POST /public/v1/product-pos-mappings (upsert) creates a new Blaze mapping

POST /public/v1/product-pos-mappings
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcyOTIsImlhdCI6MTc1NTc5NzY5MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDE0MzEzMWEtODU0YS00ZDFkLWJkYzMtYTU2ODgzYjg1NDI2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NjkxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjAzOTkiLCJ0eXAiOiJhY2Nlc3MifQ.ieCXdXaILMs8eYmG5KDj5LYIDF-bHbp7BtzuJrEWCRY

{
  "blaze_product_id": "blaze_123",
  "blaze_retailer_id": "cf8d8a23-2fc2-4225-89d2-a4a4f1c06e87",
  "product_id": "26eb0038-edd2-4d0f-af5e-129a36bdf68f"
}

Response

201
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 710d41aae62d4c000000000000000001-38a120f83c9b92ee-0

{
  "data": {
    "blaze_asset_id": null,
    "blaze_product_id": "blaze_123",
    "blaze_retailer_id": "cf8d8a23-2fc2-4225-89d2-a4a4f1c06e87",
    "id": 284,
    "inserted_at": "2025-08-21T17:34:52.462728Z",
    "pos_type": "BLAZE",
    "product_id": "26eb0038-edd2-4d0f-af5e-129a36bdf68f",
    "updated_at": "2025-08-21T17:34:52.462728Z"
  }
}

POST /public/v1/product-pos-mappings (upsert) updates an existing mapping (upsert behavior)

POST /public/v1/product-pos-mappings
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDcyOTIsImlhdCI6MTc1NTc5NzY5MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzAyMjViZjYtZWU5NC00M2QzLWIyMzMtY2FhN2I2NDlkN2U1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NjkxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MjA0NzEiLCJ0eXAiOiJhY2Nlc3MifQ.KHoxFpYxolpXiARcuLYepn-N1p1j0nPUSg-JiNpwgc4

{
  "blaze_product_id": "blaze_456",
  "blaze_retailer_id": "281877a4-d342-4a98-aa75-fb65a9dab48f",
  "product_id": "fb4db99f-a464-467a-a4e0-4447ab4ce3db"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 2a8a2f27cf6d1a000000000000000001-db602a0119a0bb4b-0

{
  "data": {
    "blaze_asset_id": null,
    "blaze_product_id": "blaze_456",
    "blaze_retailer_id": "281877a4-d342-4a98-aa75-fb65a9dab48f",
    "id": 288,
    "inserted_at": "2025-08-21T17:34:52.917050Z",
    "pos_type": "BLAZE",
    "product_id": "fb4db99f-a464-467a-a4e0-4447ab4ce3db",
    "updated_at": "2025-08-21T17:34:52.939298Z"
  }
}

Upserts a POS mapping - creates if new, updates if exists.

The system determines if a mapping already exists by checking for an existing mapping with the same product_id and retailer_id combination. If found, it updates the existing mapping. If not found, it creates a new mapping.

Returns 201 for new mappings, 200 for updates.

Request

POST /public/v1/product-pos-mappings

Parameters

Parameter	Description	In	Type	Required	Default	Example
mapping	POS mapping data	body	UpsertProductPosMapping	true

Responses

Status	Description	Schema
200	Updated existing mapping	ProductPosMappingResponse
201	Created new mapping	ProductPosMappingResponse
400	Bad Request
401	Unauthorized

Purchase

Get purchases

GET /public/v1/purchases returns purchases related to the company

GET /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MDAsImlhdCI6MTc1NTc5NzgwMCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMDE2ZTM3NTctODg3OS00M2IxLWFhNmEtMGVmM2RlZDU0ZWI0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzgxMzIiLCJ0eXAiOiJhY2Nlc3MifQ.W1jXHStUNTkR9ohPmMolA-Yt-qGd44q-X9pz_7czpBY

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 42a13afd108eec000000000000000001-5042756e087498b7-0

{
  "data": [
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-0000000038c6",
        "name": "Company 27141",
        "updated_datetime": "2025-08-21T17:36:40.785110Z"
      },
      "custom_data": [
        {
          "id": 130,
          "name": "Custom Field 151",
          "value": null
        }
      ],
      "due_datetime": "2025-08-21T17:36:40.814533Z",
      "id": "00000000-0000-0000-0000-0000000001e0",
      "inserted_datetime": "2025-08-21T17:36:40.815354Z",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001e57",
            "name": "B26695"
          },
          "compliance_quantity": null,
          "id": "02655254-4a36-41b6-b238-9c0748a39569",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-000000006a81",
            "id": "00000000-0000-0000-0000-000000002b22",
            "license_id": null,
            "name": "Place 10886"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "b340b9e4-0745-48a9-bfff-4ff262051c6f",
            "name": "Product 26680",
            "sku": "sku 26681",
            "updated_datetime": "2025-08-21T17:36:40.823628Z"
          },
          "quantity": "15.000000000",
          "received_quantity": "0.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001e58",
            "name": "B26696"
          },
          "compliance_quantity": null,
          "id": "f67cc20e-f1a7-4ada-8219-4be6c5f23b50",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-000000006a81",
            "id": "00000000-0000-0000-0000-000000002b22",
            "license_id": null,
            "name": "Place 10886"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "06d9a3d6-d958-42d4-98f4-a7b18e0f951e",
            "name": "Product 26684",
            "sku": "sku 26685",
            "updated_datetime": "2025-08-21T17:36:40.833343Z"
          },
          "quantity": "10.000000000",
          "received_quantity": "0.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001e59",
            "name": "B26697"
          },
          "compliance_quantity": null,
          "id": "d2e904e8-3a26-4c47-83a8-d6e533a6a04a",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-000000006a81",
            "id": "00000000-0000-0000-0000-000000002b22",
            "license_id": null,
            "name": "Place 10886"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "fb13e06f-f49c-41df-992c-4d1398396bbb",
            "name": "Product 26688",
            "sku": "sku 26689",
            "updated_datetime": "2025-08-21T17:36:40.843032Z"
          },
          "quantity": "5.000000000",
          "received_quantity": "0.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001e5a",
            "name": "B26698"
          },
          "compliance_quantity": null,
          "id": "9ac012cd-3b6e-4136-87a1-12aacd622b1e",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-000000006a81",
            "id": "00000000-0000-0000-0000-000000002b22",
            "license_id": null,
            "name": "Place 10886"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "db1432f8-c61c-4c9b-86f9-2692cabd5fc4",
            "name": "Product 26693",
            "sku": "sku 26694",
            "updated_datetime": "2025-08-21T17:36:40.851569Z"
          },
          "quantity": "2.000000000",
          "received_quantity": "0.000000000"
        }
      ],
      "order_datetime": "2025-08-21T17:36:40.814528Z",
      "purchase_number": "Purchase #430",
      "status": "PENDING",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:36:40.815354Z"
    },
    {
      "charges": [
        {
          "id": "307b257b-0c25-4311-8c96-762db2bf46f2",
          "name": "C1",
          "percent": "10.0000",
          "price": "1.00",
          "type": "CHARGE",
          "unit_type": "PERCENT"
        }
      ],
      "company": {
        "id": "00000000-0000-0000-0000-0000000038c4",
        "name": "Company 27137",
        "updated_datetime": "2030-11-01T00:00:00.000000Z"
      },
      "custom_data": [
        {
          "id": 130,
          "name": "Custom Field 151",
          "value": "Custom Field Value 1"
        }
      ],
      "due_datetime": "2020-01-01T00:00:01.000000Z",
      "id": "00000000-0000-0000-0000-0000000001df",
      "inserted_datetime": "2020-01-01T00:00:03.000000Z",
      "items": [
        {
          "batch": {
            "batch_number": "UID1",
            "id": "00000000-0000-0000-0000-000000001e51",
            "name": "B1"
          },
          "compliance_quantity": "1.0000",
          "id": "db5db5ee-d30a-416b-af00-fb51772fc210",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-000000006a81",
            "id": "00000000-0000-0000-0000-000000002b17",
            "license_id": "00000000-0000-0000-0000-000000001ce6",
            "name": "Place 10875"
          },
          "package": {
            "batch_number": "B1",
            "compliance_label": "ABCDEF012345670000076297",
            "id": "00000000-0000-0000-0000-000000000d1f",
            "metrc_label": "ABCDEF012345670000076297",
            "status": "active"
          },
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "6260341b-61cc-4b13-b9ea-02047465963d",
            "name": "P1",
            "sku": "SKU1",
            "updated_datetime": "2023-11-02T00:00:00.000000Z"
          },
          "quantity": "1.000000000",
          "received_quantity": "1.000000000"
        }
      ],
      "order_datetime": "2020-01-01T00:00:02.000000Z",
      "purchase_number": "SO-123",
      "status": "COMPLETED",
      "total": "10.00",
      "updated_datetime": "2020-01-01T00:00:04.000000Z"
    }
  ]
}

GET /public/v1/purchases allows filtering by several statuses

GET /public/v1/purchases?status[]=Completed&status[]=Pending
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczODksImlhdCI6MTc1NTc5Nzc4OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDA1N2NkYTktNTk1ZC00Y2Q1LWIzYzQtNGIzNTE0NWU4OTRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzg4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzYwMzYiLCJ0eXAiOiJhY2Nlc3MifQ.9fab4bAPjPvKv_BXXVciLOjf9u0Krl2Hh7l3VoDt7nU

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 497496f9088b3c000000000000000001-1390e259395cae5f-0

{
  "data": [
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-0000000035b1",
        "name": "Company 25790",
        "updated_datetime": "2025-08-21T17:36:30.259904Z"
      },
      "custom_data": [],
      "due_datetime": "2025-08-21T17:36:30.365883Z",
      "id": "00000000-0000-0000-0000-0000000001af",
      "inserted_datetime": "2025-08-21T17:36:30.368756Z",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c82",
            "name": "B25163"
          },
          "compliance_quantity": null,
          "id": "423f1c8c-d392-4405-985f-377a575456f6",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-0000000028ae",
            "license_id": null,
            "name": "Place 10262"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "33021e37-f9d8-4bf3-9ffd-2dec9a0b6aee",
            "name": "Product 25149",
            "sku": "sku 25150",
            "updated_datetime": "2025-08-21T17:36:30.404545Z"
          },
          "quantity": "15.000000000",
          "received_quantity": "0.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c83",
            "name": "B25166"
          },
          "compliance_quantity": null,
          "id": "f85df033-96ef-4daf-820a-11d2268bd58e",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-0000000028ae",
            "license_id": null,
            "name": "Place 10262"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "77c45b0e-7915-4c6e-8871-d1698055addb",
            "name": "Product 25154",
            "sku": "sku 25155",
            "updated_datetime": "2025-08-21T17:36:30.440222Z"
          },
          "quantity": "10.000000000",
          "received_quantity": "0.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c84",
            "name": "B25167"
          },
          "compliance_quantity": null,
          "id": "35d298d7-1380-46a6-aee5-b54361087f5a",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-0000000028ae",
            "license_id": null,
            "name": "Place 10262"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "cb48efc0-9ec1-47bb-9394-c9dac942ab07",
            "name": "Product 25159",
            "sku": "sku 25160",
            "updated_datetime": "2025-08-21T17:36:30.449245Z"
          },
          "quantity": "5.000000000",
          "received_quantity": "0.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c85",
            "name": "B25168"
          },
          "compliance_quantity": null,
          "id": "7ae68a11-dcb2-4335-8563-74ac6ac7e59e",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-0000000028ae",
            "license_id": null,
            "name": "Place 10262"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "2a5aef1d-372f-478e-a3eb-3f17dcd2d7c1",
            "name": "Product 25161",
            "sku": "sku 25162",
            "updated_datetime": "2025-08-21T17:36:30.456776Z"
          },
          "quantity": "2.000000000",
          "received_quantity": "0.000000000"
        }
      ],
      "order_datetime": "2020-01-01T12:30:00.000000Z",
      "purchase_number": "Purchase #391",
      "status": "PENDING",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:36:30.368756Z"
    },
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-0000000035a3",
        "name": "Company 25770",
        "updated_datetime": "2025-08-21T17:36:30.151578Z"
      },
      "custom_data": [],
      "due_datetime": "2025-08-21T17:36:30.183584Z",
      "id": "00000000-0000-0000-0000-0000000001ae",
      "inserted_datetime": "2025-08-21T17:36:30.184435Z",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c75",
            "name": "B25128"
          },
          "compliance_quantity": null,
          "id": "f2eb2dfb-a9ed-43ca-bc28-e69cbb2be14c",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-0000000028a7",
            "license_id": null,
            "name": "Place 10255"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "caf12c68-7a79-44fa-8e88-b0eda2d94ced",
            "name": "Product 25116",
            "sku": "sku 25117",
            "updated_datetime": "2025-08-21T17:36:30.192567Z"
          },
          "quantity": "15.000000000",
          "received_quantity": "15.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c76",
            "name": "B25129"
          },
          "compliance_quantity": null,
          "id": "23abb755-c91f-420f-b0d3-ac0c2bd5f041",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-0000000028a7",
            "license_id": null,
            "name": "Place 10255"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "0b15bfb7-d666-4c0d-9896-37a73d565bc6",
            "name": "Product 25118",
            "sku": "sku 25119",
            "updated_datetime": "2025-08-21T17:36:30.205967Z"
          },
          "quantity": "10.000000000",
          "received_quantity": "10.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c78",
            "name": "B25131"
          },
          "compliance_quantity": null,
          "id": "f775c523-ca64-4763-909d-551c9120dab2",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-0000000028a7",
            "license_id": null,
            "name": "Place 10255"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "73394244-9c1a-4684-ba71-00624326a928",
            "name": "Product 25121",
            "sku": "sku 25122",
            "updated_datetime": "2025-08-21T17:36:30.217201Z"
          },
          "quantity": "5.000000000",
          "received_quantity": "5.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c79",
            "name": "B25132"
          },
          "compliance_quantity": null,
          "id": "2558b8b2-4fae-4efc-ae4c-04910bc08cb4",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-0000000028a7",
            "license_id": null,
            "name": "Place 10255"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "d623749a-a39f-4733-b7da-6d98d0bef7ff",
            "name": "Product 25123",
            "sku": "sku 25125",
            "updated_datetime": "2025-08-21T17:36:30.226771Z"
          },
          "quantity": "2.000000000",
          "received_quantity": "2.000000000"
        }
      ],
      "order_datetime": "2020-01-01T12:20:00.000000Z",
      "purchase_number": "Purchase #390",
      "status": "COMPLETED",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:36:30.184435Z"
    },
    {
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-000000003578",
        "name": "Company 25692",
        "updated_datetime": "2025-08-21T17:36:29.555220Z"
      },
      "custom_data": [],
      "due_datetime": "2025-08-21T17:36:29.590981Z",
      "id": "00000000-0000-0000-0000-0000000001ac",
      "inserted_datetime": "2025-08-21T17:36:29.591845Z",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c55",
            "name": "B25036"
          },
          "compliance_quantity": null,
          "id": "4cd9bf82-debd-4a61-857a-3c6b509e6ca3",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-000000002886",
            "license_id": null,
            "name": "Place 10222"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "bc32adbc-00bf-4868-a24a-9d66c0932fd4",
            "name": "Product 25012",
            "sku": "sku 25013",
            "updated_datetime": "2025-08-21T17:36:29.599850Z"
          },
          "quantity": "15.000000000",
          "received_quantity": "15.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c56",
            "name": "B25037"
          },
          "compliance_quantity": null,
          "id": "d2bda7e2-8788-40cf-9c6f-f67054b0a1ea",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-000000002886",
            "license_id": null,
            "name": "Place 10222"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "6daae493-c5df-4cf2-ab91-f80f8f0fb127",
            "name": "Product 25014",
            "sku": "sku 25015",
            "updated_datetime": "2025-08-21T17:36:29.608341Z"
          },
          "quantity": "10.000000000",
          "received_quantity": "10.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c57",
            "name": "B25038"
          },
          "compliance_quantity": null,
          "id": "33e83822-a549-43ba-9c88-11f7dbde6854",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-000000002886",
            "license_id": null,
            "name": "Place 10222"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "50d1a92c-0b18-4052-890e-ae0dbce10667",
            "name": "Product 25016",
            "sku": "sku 25017",
            "updated_datetime": "2025-08-21T17:36:29.625555Z"
          },
          "quantity": "5.000000000",
          "received_quantity": "5.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000001c58",
            "name": "B25039"
          },
          "compliance_quantity": null,
          "id": "306060ff-657d-4cf1-bb48-ec732fafbf17",
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
            "company_id": "00000000-0000-0000-0000-0000000064e8",
            "id": "00000000-0000-0000-0000-000000002886",
            "license_id": null,
            "name": "Place 10222"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "85fdf28c-a421-4412-815a-92bb726ea78a",
            "name": "Product 25032",
            "sku": "sku 25033",
            "updated_datetime": "2025-08-21T17:36:29.767664Z"
          },
          "quantity": "2.000000000",
          "received_quantity": "2.000000000"
        }
      ],
      "order_datetime": "2020-01-01T12:00:00.000000Z",
      "purchase_number": "Purchase #388",
      "status": "COMPLETED",
      "total": "32.00",
      "updated_datetime": "2025-08-21T17:36:29.591845Z"
    }
  ]
}

Get purchases sorted by Order Date descendingly date and filtered by various attributes.

Note: The page size for this endpoint is 500 purchase orders per page.

Request

GET /public/v1/purchases

Parameters

Parameter	Description	In	Type	Required	Example
due_datetime	Filter purchases by the due datetime	query	string	false	,2022-07-10T00:00:00Z
inserted_datetime	Filter purchases by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
order_datetime	Filter purchases by the order datetime	query	string	false	2022-07-10T00:00:00Z,2022-07-11T00:00:00Z
page	Pagination information	body	Page	false
status	Filter purchases by their status. Accepted values are "Completed", "Delivering", "Partially Received", "Pending", "Processing".	query	array	false	["Pending","Processing"]
updated_datetime	Filter purchases by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of purchases	Purchases

Insert a payment for a purchase

POST /purchases/:id/payments can create a payment for an purchase with both quickbooks id and name

POST /public/v1/purchases/00000000-0000-0000-0000-0000000001cd/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTgsImlhdCI6MTc1NTc5Nzc5OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTBiYWVlNTItMmQ3My00MDI2LTllMmYtY2NiNTgwOWEwM2U1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc3NTgiLCJ0eXAiOiJhY2Nlc3MifQ.pzRwz41cAM36gweeOUUa_xw5pjYMLucbvzxrfSIWSL8

{
  "amount": 100.01,
  "description": "Payment for purchase",
  "payment_datetime": "2020-01-01T00:00:00.000000Z",
  "payment_method_id": "00000000-0000-0000-0000-0000000000c6",
  "quickbooks_deposit_account_id": "QBD-123"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 46e65155760134000000000000000001-2d0c6f1c5a354c99-0

{
  "data": {
    "amount": "100.01",
    "description": "Payment for purchase",
    "id": "00000000-0000-0000-0000-000000000032",
    "inserted_datetime": "2025-08-21T17:36:38.510939Z",
    "payment_date": "2020-01-01T00:00:00.000000Z",
    "payment_method": {
      "id": "00000000-0000-0000-0000-0000000000c6",
      "name": "Payment Method 0"
    },
    "payment_number": "PYT-0000001",
    "purchase_id": "00000000-0000-0000-0000-0000000001cd",
    "quickbooks_deposit_account_id": "QBD-123"
  }
}

POST /purchases/:id/payments can create a payment for an purchase with both quickbooks id and name

POST /public/v1/purchases/00000000-0000-0000-0000-0000000001cd/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTgsImlhdCI6MTc1NTc5Nzc5OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTBiYWVlNTItMmQ3My00MDI2LTllMmYtY2NiNTgwOWEwM2U1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc3NTgiLCJ0eXAiOiJhY2Nlc3MifQ.pzRwz41cAM36gweeOUUa_xw5pjYMLucbvzxrfSIWSL8

{
  "amount": 100.01,
  "description": "Payment for purchase",
  "payment_datetime": "2020-01-01T00:00:00.000000Z",
  "payment_method_id": "00000000-0000-0000-0000-0000000000c6",
  "quickbooks_deposit_account_name": "QBD-NAME"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 46e65155760134000000000000000001-9983effb07a4d91b-0

{
  "data": {
    "amount": "100.01",
    "description": "Payment for purchase",
    "id": "00000000-0000-0000-0000-000000000033",
    "inserted_datetime": "2025-08-21T17:36:38.618867Z",
    "payment_date": "2020-01-01T00:00:00.000000Z",
    "payment_method": {
      "id": "00000000-0000-0000-0000-0000000000c6",
      "name": "Payment Method 0"
    },
    "payment_number": "PYT-0000002",
    "purchase_id": "00000000-0000-0000-0000-0000000001cd",
    "quickbooks_deposit_account_id": "QBD-123"
  }
}

Request

POST /public/v1/purchases/{id}/payments

Parameters

Parameter	Description	In	Type	Required
payment_method_id	Payment method ID	query	string	true
amount	Amount of the payment. Will round to 2 decimal places	query	decimal	true
payment_datetime	Payment date	query	string	true
description	Description of the payment	query	string	true
quickbooks_deposit_account_id	Quickbooks deposit account ID. Cannot include both this and quickbooks_deposit_account_name. If user's company is integrated with Quickbooks, either this or quickbooks_deposit_account_name must be provided. Account type must be "Bank" or "Credit Card"	query	string	false
quickbooks_deposit_account_name	Quickbooks deposit account name. Cannot include both this and quickbooks_deposit_account_id. If user's company is integrated with Quickbooks, either this or quickbooks_deposit_account_id must be provided. Account type must be "Bank" or "Credit Card"	query	string	false

Responses

Status	Description	Schema
200	A single payment	PurchasePayment

Upsert a purchase order

POST /public/v1/purchases creates a purchase (with product-tracked item)

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTIsImlhdCI6MTc1NTc5Nzc5MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTkwYjI4NTctNDg4ZC00OTFmLWE0MWItYmMxZDJmNTg5MzQzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY1NTUiLCJ0eXAiOiJhY2Nlc3MifQ.LiWk_cllZ1b8vo6Gy87S2ulybajI3SVFNhEzT677EYE

{
  "billing_location_id": "00000000-0000-0000-0000-000000002911",
  "charges": [
    {
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "name": "C2",
      "price": "-5.0000",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "company_id": "00000000-0000-0000-0000-00000000363c",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-00000000290f",
      "price": "10.000000000",
      "product_id": "d5094b17-8edf-4928-9acf-8c3fc6400481",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-00000000290f",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 41e76eabb1552c000000000000000001-a3e8836c46a8cd1c-0

{
  "data": {
    "charges": [
      {
        "id": "83c240fd-7b3b-4de4-aaf4-4705a2f15341",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "1ff8b7f0-7988-413d-a377-4a9ed541b7dc",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-00000000363c",
      "name": "Company 26043",
      "updated_datetime": "2025-08-21T17:36:32.420547Z"
    },
    "custom_data": [
      {
        "id": 128,
        "name": "Custom Field 149",
        "value": null
      }
    ],
    "due_datetime": "2020-01-30T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-0000000001b4",
    "inserted_datetime": "2025-08-21T17:36:32.484933Z",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001cc7",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "1c4be35d-d4d2-4843-bdf6-88f4c7f5d9fe",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000006648",
          "id": "00000000-0000-0000-0000-00000000290f",
          "license_id": "00000000-0000-0000-0000-000000001ba7",
          "name": "Place 10358"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "d5094b17-8edf-4928-9acf-8c3fc6400481",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:36:32.459411Z"
        },
        "quantity": "1.000000000",
        "received_quantity": "0.000000000"
      }
    ],
    "order_datetime": "2020-01-01T00:00:00.000000Z",
    "purchase_number": "PO-0000001",
    "status": "PENDING",
    "total": "6.00",
    "updated_datetime": "2025-08-21T17:36:32.496185Z"
  }
}

POST /public/v1/purchases creates a purchase (with batch-tracked item)

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTAsImlhdCI6MTc1NTc5Nzc5MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTU5ZTIwNjctZjE4OS00YjExLWFiOTYtYzhmMTk3ZjIxYjU5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzg5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzYyNjgiLCJ0eXAiOiJhY2Nlc3MifQ.B_YE_-HbwH1RrTmKOEYOPyNthfGbn0_TDuAd6MM194k

{
  "billing_location_id": "00000000-0000-0000-0000-0000000028c2",
  "charges": [
    {
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "name": "C2",
      "price": "-5.0000",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "company_id": "00000000-0000-0000-0000-0000000035ca",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "batch_id": "00000000-0000-0000-0000-000000001c8f",
      "location_id": "00000000-0000-0000-0000-0000000028c2",
      "price": "10.000000000",
      "product_id": "e6526cb8-758e-4e4f-835e-190f7bcb7ad9",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-0000000028c2",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 18fb9b5b519713000000000000000001-3d1ee38b8e78c4bf-0

{
  "data": {
    "charges": [
      {
        "id": "41cbe63f-f22e-489d-8a07-c7f0f147a1d0",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "958b159e-a4da-4d32-86e8-bcf021ae2573",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-0000000035ca",
      "name": "Company 25847",
      "updated_datetime": "2025-08-21T17:36:30.791085Z"
    },
    "custom_data": [],
    "due_datetime": "2020-01-30T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-0000000001b0",
    "inserted_datetime": "2025-08-21T17:36:30.909086Z",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001c8f",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "04a2997a-7ac3-4367-a590-72742442d174",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000006584",
          "id": "00000000-0000-0000-0000-0000000028c2",
          "license_id": "00000000-0000-0000-0000-000000001b69",
          "name": "Place 10282"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "e6526cb8-758e-4e4f-835e-190f7bcb7ad9",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:36:30.861838Z"
        },
        "quantity": "1.000000000",
        "received_quantity": "0.000000000"
      }
    ],
    "order_datetime": "2020-01-01T00:00:00.000000Z",
    "purchase_number": "PO-0000001",
    "status": "PENDING",
    "total": "6.00",
    "updated_datetime": "2025-08-21T17:36:30.918944Z"
  }
}

POST /public/v1/purchases creates a purchase (with package-tracked item)

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTksImlhdCI6MTc1NTc5Nzc5OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDYwYjMzZDYtZmMzZS00OTgzLTk5NDgtNDZjZmFmNzA4ZmRmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzgwMDkiLCJ0eXAiOiJhY2Nlc3MifQ.260d-wSm-jwn_bTwWgUqYwu7qsy5qx_JIHOU5X4MkxY

{
  "billing_location_id": "00000000-0000-0000-0000-000000002ae6",
  "charges": [
    {
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "name": "C2",
      "price": "-5.0000",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "company_id": "00000000-0000-0000-0000-00000000387e",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-000000002ae6",
      "price": "10.000000000",
      "product_id": "7e90fbf8-9371-4c61-a52c-891b7daf3aab",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-000000002ae6",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: a8424d003cb170000000000000000001-e341893f715dfb2b-0

{
  "data": {
    "charges": [
      {
        "id": "a666e5d6-0be7-44c9-b6c5-1ee233695581",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "5112c2a0-b4d1-45bd-a8c8-bfe7eb2eb05e",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-00000000387e",
      "name": "Company 27035",
      "updated_datetime": "2025-08-21T17:36:39.940437Z"
    },
    "custom_data": [],
    "due_datetime": "2020-01-30T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-0000000001d3",
    "inserted_datetime": "2025-08-21T17:36:40.007959Z",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001e2f",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "6139ccff-01b3-4ca5-8a1a-9f1ed1a27d4d",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-000000006a25",
          "id": "00000000-0000-0000-0000-000000002ae6",
          "license_id": "00000000-0000-0000-0000-000000001cd2",
          "name": "Place 10826"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "7e90fbf8-9371-4c61-a52c-891b7daf3aab",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:36:39.977547Z"
        },
        "quantity": "1.000000000",
        "received_quantity": "0.000000000"
      }
    ],
    "order_datetime": "2020-01-01T00:00:00.000000Z",
    "purchase_number": "PO-0000001",
    "status": "PENDING",
    "total": "6.00",
    "updated_datetime": "2025-08-21T17:36:40.016707Z"
  }
}

POST /public/v1/purchases updates a purchase

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTUsImlhdCI6MTc1NTc5Nzc5NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTUwNDQwYWQtYmZiOS00ZWIxLTg1NTEtZmVlMGFlMmVmYTRlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzcxNzgiLCJ0eXAiOiJhY2Nlc3MifQ.uETL6nBQFZ1fO1FL-FgzsX8Kg_CgFHXJSuNtcp7mK4s

{
  "billing_location_id": "00000000-0000-0000-0000-0000000029ca",
  "charges": [
    {
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    }
  ],
  "company_id": "00000000-0000-0000-0000-000000003700",
  "due_datetime": "2020-01-20T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-0000000029ca",
      "price": "10.000000000",
      "product_id": "921742e6-d51d-4630-96a4-764150a411f0",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-0000000029ca",
  "order_datetime": "2020-01-02T00:00:00.000000Z"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: ea27dae64d6a70000000000000000001-a5ca35f00c567462-0

{
  "data": {
    "charges": [
      {
        "id": "0c153bb1-6d0d-4e18-8ebb-e8442638721e",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-000000003700",
      "name": "Company 26414",
      "updated_datetime": "2025-08-21T17:36:35.494275Z"
    },
    "custom_data": [],
    "due_datetime": "2020-01-20T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-0000000001bf",
    "inserted_datetime": "2025-08-21T17:36:35.688692Z",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001d50",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "653def49-5a61-464b-bae0-fef1cb58c957",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-0000000067bc",
          "id": "00000000-0000-0000-0000-0000000029ca",
          "license_id": "00000000-0000-0000-0000-000000001c3a",
          "name": "Place 10542"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "921742e6-d51d-4630-96a4-764150a411f0",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:36:35.642818Z"
        },
        "quantity": "1.000000000",
        "received_quantity": "0.000000000"
      }
    ],
    "order_datetime": "2020-01-02T00:00:00.000000Z",
    "purchase_number": "PO-0000001",
    "status": "PENDING",
    "total": "11.00",
    "updated_datetime": "2025-08-21T17:36:35.699031Z"
  }
}

POST /public/v1/purchases updates a purchase

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTUsImlhdCI6MTc1NTc5Nzc5NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTUwNDQwYWQtYmZiOS00ZWIxLTg1NTEtZmVlMGFlMmVmYTRlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzcxNzgiLCJ0eXAiOiJhY2Nlc3MifQ.uETL6nBQFZ1fO1FL-FgzsX8Kg_CgFHXJSuNtcp7mK4s

{
  "billing_location_id": "00000000-0000-0000-0000-0000000029ca",
  "charges": [
    {
      "id": "0c153bb1-6d0d-4e18-8ebb-e8442638721e",
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "name": "C2",
      "percent": null,
      "price": "-5.00",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "company_id": "00000000-0000-0000-0000-000000003700",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "id": "00000000-0000-0000-0000-0000000001bf",
  "items": [
    {
      "id": "653def49-5a61-464b-bae0-fef1cb58c957",
      "location_id": "00000000-0000-0000-0000-0000000029ca",
      "price": "10.000000000",
      "product_id": "921742e6-d51d-4630-96a4-764150a411f0",
      "quantity": "1.000000000"
    },
    {
      "batch_id": "00000000-0000-0000-0000-000000001d51",
      "location_id": "00000000-0000-0000-0000-0000000029ca",
      "price": "5.000000000",
      "product_id": "6fbe5bc4-f33b-4e75-8d44-571f5143ddc2",
      "quantity": "2.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-0000000029ca",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: ea27dae64d6a70000000000000000001-caf656caf3f5ebd9-0

{
  "data": {
    "charges": [
      {
        "id": "0c153bb1-6d0d-4e18-8ebb-e8442638721e",
        "name": "C1",
        "percent": "10.0000",
        "price": "2.00",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "6292f29a-29f5-4f92-868c-0b6436408795",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-000000003700",
      "name": "Company 26414",
      "updated_datetime": "2025-08-21T17:36:35.494275Z"
    },
    "custom_data": [],
    "due_datetime": "2020-01-30T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-0000000001bf",
    "inserted_datetime": "2025-08-21T17:36:35.688692Z",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001d50",
          "name": "B1"
        },
        "compliance_quantity": null,
        "id": "653def49-5a61-464b-bae0-fef1cb58c957",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-0000000067bc",
          "id": "00000000-0000-0000-0000-0000000029ca",
          "license_id": "00000000-0000-0000-0000-000000001c3a",
          "name": "Place 10542"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "921742e6-d51d-4630-96a4-764150a411f0",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2025-08-21T17:36:35.642818Z"
        },
        "quantity": "1.000000000",
        "received_quantity": "0.000000000"
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001d51",
          "name": "B2"
        },
        "compliance_quantity": null,
        "id": "9d2bc8f9-c597-4ba5-9c06-ff60a797860a",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-0000000067bc",
          "id": "00000000-0000-0000-0000-0000000029ca",
          "license_id": "00000000-0000-0000-0000-000000001c3a",
          "name": "Place 10542"
        },
        "package": null,
        "price": "5.000000000",
        "price_base": "5.000000000",
        "product": {
          "id": "6fbe5bc4-f33b-4e75-8d44-571f5143ddc2",
          "name": "P2",
          "sku": "SKU2",
          "updated_datetime": "2025-08-21T17:36:35.666823Z"
        },
        "quantity": "2.000000000",
        "received_quantity": "0.000000000"
      }
    ],
    "order_datetime": "2020-01-01T00:00:00.000000Z",
    "purchase_number": "PO-0000001",
    "status": "PENDING",
    "total": "17.00",
    "updated_datetime": "2025-08-21T17:36:35.927060Z"
  }
}

POST /public/v1/purchases updating a purchase removes line items that aren't included in the payload

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTEsImlhdCI6MTc1NTc5Nzc5MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOWQ4NWZhNmYtMzg0Mi00ZGE2LWFlZjgtN2ViODAxZDVmOGU4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY0NTUiLCJ0eXAiOiJhY2Nlc3MifQ.Xm82s0fSQBDswgOaTBggugyFSfqOwRwKgRo75LjMTrg

{
  "billing_location_id": "00000000-0000-0000-0000-0000000028fa",
  "company_id": "00000000-0000-0000-0000-00000000361a",
  "due_datetime": "2020-01-20T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-0000000028fa",
      "price": "10",
      "product_id": "2ac5ab90-6b46-43b1-8cf6-0750c24a65ca",
      "quantity": "1"
    }
  ],
  "location_id": "00000000-0000-0000-0000-0000000028fa",
  "order_datetime": "2020-01-02T00:00:00.000000Z"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: b772eee54b4620000000000000000001-7fdbc64f06c3a2ce-0

{
  "data": {
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-00000000361a",
      "name": "Company 25987",
      "updated_datetime": "2025-08-21T17:36:31.940037Z"
    },
    "custom_data": [],
    "due_datetime": "2020-01-20T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-0000000001b3",
    "inserted_datetime": "2025-08-21T17:36:32.004660Z",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001cb2",
          "name": "B25347"
        },
        "compliance_quantity": null,
        "id": "8e4ee9b7-4c99-4f1c-a310-4e91347664b5",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-00000000660a",
          "id": "00000000-0000-0000-0000-0000000028fa",
          "license_id": "00000000-0000-0000-0000-000000001b95",
          "name": "Place 10337"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "2ac5ab90-6b46-43b1-8cf6-0750c24a65ca",
          "name": "Product 25343",
          "sku": "sku 25344",
          "updated_datetime": "2025-08-21T17:36:31.972423Z"
        },
        "quantity": "1.000000000",
        "received_quantity": "0.000000000"
      }
    ],
    "order_datetime": "2020-01-02T00:00:00.000000Z",
    "purchase_number": "PO-0000001",
    "status": "PENDING",
    "total": "10.00",
    "updated_datetime": "2025-08-21T17:36:32.004660Z"
  }
}

POST /public/v1/purchases updating a purchase removes line items that aren't included in the payload

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTEsImlhdCI6MTc1NTc5Nzc5MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOWQ4NWZhNmYtMzg0Mi00ZGE2LWFlZjgtN2ViODAxZDVmOGU4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY0NTUiLCJ0eXAiOiJhY2Nlc3MifQ.Xm82s0fSQBDswgOaTBggugyFSfqOwRwKgRo75LjMTrg

{
  "company_id": "00000000-0000-0000-0000-00000000361a",
  "id": "00000000-0000-0000-0000-0000000001b3",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-0000000028fa",
      "price": "2",
      "product_id": "2ac5ab90-6b46-43b1-8cf6-0750c24a65ca",
      "quantity": "1"
    }
  ]
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: b772eee54b4620000000000000000001-74e4f9253973d1a4-0

{
  "data": {
    "charges": [],
    "company": {
      "id": "00000000-0000-0000-0000-00000000361a",
      "name": "Company 25987",
      "updated_datetime": "2025-08-21T17:36:31.940037Z"
    },
    "custom_data": [],
    "due_datetime": "2020-01-20T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-0000000001b3",
    "inserted_datetime": "2025-08-21T17:36:32.004660Z",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000001cb2",
          "name": "B25347"
        },
        "compliance_quantity": null,
        "id": "c3e83f8d-11b7-4ff9-899e-959a1fdf5078",
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 88888, USA",
          "company_id": "00000000-0000-0000-0000-00000000660a",
          "id": "00000000-0000-0000-0000-0000000028fa",
          "license_id": "00000000-0000-0000-0000-000000001b95",
          "name": "Place 10337"
        },
        "package": null,
        "price": "2.000000000",
        "price_base": "2.000000000",
        "product": {
          "id": "2ac5ab90-6b46-43b1-8cf6-0750c24a65ca",
          "name": "Product 25343",
          "sku": "sku 25344",
          "updated_datetime": "2025-08-21T17:36:31.972423Z"
        },
        "quantity": "1.000000000",
        "received_quantity": "0.000000000"
      }
    ],
    "order_datetime": "2020-01-02T00:00:00.000000Z",
    "purchase_number": "PO-0000001",
    "status": "PENDING",
    "total": "2.00",
    "updated_datetime": "2025-08-21T17:36:32.225605Z"
  }
}

POST /public/v1/purchases does not update a purchase that has moved beyond Pending status

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTEsImlhdCI6MTc1NTc5Nzc5MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDdmZTUyM2YtZDdmNy00Mjg1LWI5YzQtMGVkY2M0OGJhNTQ0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzYzNDgiLCJ0eXAiOiJhY2Nlc3MifQ.ef4rJvsa-qtoAZeQqulcSSvANVe1FEbQjb2kJGnfMLE

{
  "billing_location_id": "00000000-0000-0000-0000-0000000028d6",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-0000000035e1",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "id": "00000000-0000-0000-0000-0000000001b1",
  "items": [
    {
      "batch_id": "00000000-0000-0000-0000-000000001c9b",
      "id": "aaf6f717-acfe-4d76-adbf-07ef2d4c9a48",
      "location_id": "00000000-0000-0000-0000-0000000028d6",
      "price": "10.000000000",
      "product_id": "d6da9f2a-fcc5-48dd-b0bf-672001edbc30",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-0000000028d6",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 4daac7d8e81f6c000000000000000001-7e5040c0bdb85748-0

{
  "errors": [
    {
      "context": {},
      "message": "Cannot change this PO through the Distru API because it's beyond Pending status",
      "pointer": [
        "status"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/purchases does not create a purchase with a company relationship that belongs to another company

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTAsImlhdCI6MTc1NTc5Nzc5MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOGUwMzVkYzktZjU0ZS00MWUzLTllNGYtNTIyNjU3MjVkN2ViIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzg5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzYyMzIiLCJ0eXAiOiJhY2Nlc3MifQ.Mls6-Ci9fbojoj06HTaRzup0H9Xjv6_HZ1qU59c8HVs

{
  "billing_location_id": "00000000-0000-0000-0000-0000000028c0",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-0000000035c2",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-0000000028c0",
      "price": "10.000000000",
      "product_id": "4912a3bb-1427-4c2a-a667-c93ee3b90487",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-0000000028c0",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 6bf5a9e6920e7c000000000000000001-e093b5604455fc66-0

{
  "errors": [
    {
      "context": {},
      "message": "The provided supplier does not exist",
      "pointer": [
        "company_id"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/purchases does not create a purchase with a product that belongs to another company

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTcsImlhdCI6MTc1NTc5Nzc5NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjMwYWUzZWYtZmE2MS00ODkyLTg4M2ItZDgwYTFkYTZmZDBlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc1NzMiLCJ0eXAiOiJhY2Nlc3MifQ.nrCmCnggFVLkDUOr9_PpXaTO2sTRn2UN9tsqPASPw5k

{
  "billing_location_id": "00000000-0000-0000-0000-000000002a58",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-0000000037a2",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-000000002a58",
      "price": "10.000000000",
      "product_id": "8a05387a-3512-4394-ab06-b22198db2e43",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-000000002a58",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 25d8ab23a453ae000000000000000001-4e514884f3559fef-0

{
  "errors": [
    {
      "context": {
        "id": "6c58dff3-68c1-4274-b918-79fcd4ca0860"
      },
      "message": "This record does not belong to your company.",
      "pointer": [
        "items",
        0,
        "product_id"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/purchases does not create a purchase with a batch that belongs to another company

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTcsImlhdCI6MTc1NTc5Nzc5NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTU0OWIyMjctZGJiYy00ZjE3LWE3ZjUtNTYzY2MxNTY1ZWNmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc1NDUiLCJ0eXAiOiJhY2Nlc3MifQ.hjvRMOGTpAZsdeV9zmAndathlupJXL7rjNFyF6znQpw

{
  "billing_location_id": "00000000-0000-0000-0000-000000002a50",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-00000000379a",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "batch_id": "00000000-0000-0000-0000-000000001d9d",
      "location_id": "00000000-0000-0000-0000-000000002a50",
      "price": "10.000000000",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-000000002a50",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 5c5a2a38b95ddc000000000000000001-a20550a23807b229-0

{
  "errors": [
    {
      "context": {
        "id": "55604020-fdbc-46d1-a8a5-24e5f25eaffb"
      },
      "message": "This record does not belong to your company.",
      "pointer": [
        "items",
        0,
        "product_id"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/purchases does not create a purchase with a location that belongs to another company

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTMsImlhdCI6MTc1NTc5Nzc5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGY2ZDBmNmQtNTJiYS00N2FiLWExYjQtNjdjOGM2ZTRmNDRlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY2NTYiLCJ0eXAiOiJhY2Nlc3MifQ.gm5NF-HaunSSido0K6L4850LqmyescP9aYD08iWnHRo

{
  "billing_location_id": "00000000-0000-0000-0000-000000002920",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-000000003648",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-000000002922",
      "price": "10.000000000",
      "product_id": "a0b0a0fe-4929-44a1-bad3-b00257e3cecc",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-000000002922",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 3e527bcdb038fa000000000000000001-278ea64a0d710adc-0

{
  "errors": [
    {
      "context": {
        "id": "cb0cae73-ad32-4e24-95bf-61b01e268e22"
      },
      "message": "This record does not belong to your company.",
      "pointer": [
        "items",
        0,
        "location_id"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/purchases does not create a purchase with a location different from the order items

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0MDEsImlhdCI6MTc1NTc5NzgwMSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzAzZWVmYjMtYjY4Yi00YzQ1LTkzZWMtNGExYmExZjBiYmIyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODAwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzgyNDkiLCJ0eXAiOiJhY2Nlc3MifQ.N-RIw_xs_czIN6UIvfh_C1phGs9rw3SfKSID5bmI-gU

{
  "billing_location_id": "00000000-0000-0000-0000-000000002b37",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-0000000038f4",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-000000002b37",
      "price": "10.000000000",
      "product_id": "4d532102-66e9-416a-bfd2-a7dd5003d05b",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-000000002b38",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 2ff420f9312b26000000000000000001-351b6c8146682b78-0

{
  "errors": [
    {
      "context": {
        "id": "79b5571c-e8ce-4dca-a79a-920c3dd72893"
      },
      "message": "Purchase item delivery location must be the same as purchase delivery location.",
      "pointer": [
        "items",
        0,
        "location_id"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/purchases does not create a purchase with a billing location that belongs to another company

POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTEsImlhdCI6MTc1NTc5Nzc5MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMGJkOTFlMDYtMGE5YS00ZmI0LTkzN2EtMDY1ZDI3YTQ3Mjc5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY0MTMiLCJ0eXAiOiJhY2Nlc3MifQ.wae50SC0O-IRO8dMc-_AC46nTDjeGGit8RkuR6_fIYY

{
  "billing_location_id": "00000000-0000-0000-0000-0000000028e9",
  "charges": [],
  "company_id": "00000000-0000-0000-0000-0000000035ff",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-0000000028e8",
      "price": "10.000000000",
      "product_id": "1ff6125f-9cc0-464f-a2c0-9a43a550515a",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-0000000028e8",
  "order_datetime": "2020-01-01T00:00:00.000000Z"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 09a96215436281000000000000000001-f55e31afd2e01672-0

{
  "errors": [
    {
      "context": {},
      "message": "The provided billing address does not exist",
      "pointer": [
        "billing_location_id"
      ],
      "section": "body"
    }
  ]
}

Upsert a single purchase order. To update an existing purchase order, pass in an existing purchase order ID in the id field. When updating a purchase order, you must pass in all fields (no sparse update currently supported). Any existing order item or charge you do not pass in to items and charges respectively will be deleted

Request

POST /public/v1/purchases

Parameters

Parameter	Description	In	Type	Required
id	Unique ID for this purchase order. If it exists, an update will be performed; otherwise, it will be used as the ID of a new purchase order record	query	string	false
description	A description of the purchase order	query	string	false
location_id	The location into which the inventory in this purchase will be received	query	string	false
billing_location_id	The billing address for this purchase order	query	string	false
company_id	The company that is the supplier for this purchase order	query	string	false
order_datetime	The datetime on which the purchase order was placed	query	string	false
due_datetime	The datetime by which the purchase order should be paid	query	string	false
charges	The additional lines of Charge, Discount, or Tax added to this purchase order	body	PurchaseChargesRequest	false
items	The items present on this purchase order	body	PurchaseItemsRequest	false
billing_location_id	The billing location's ID	query	string	false

Responses

Status	Description	Schema
200	A single purchase orders	Purchase

StockAdjustment

Get adjustments

GET /public/v1/adjustments returns proper data for stock adjustments of product/batch/package tracked

GET /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTUsImlhdCI6MTc1NTc5Nzc5NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGQzZDQ4NWItN2E2Ni00MzQ4LTgyY2EtYjc1NTk0NTRkNzhlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3Nzk0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzcwODgiLCJ0eXAiOiJhY2Nlc3MifQ.SHA8EzLWFN14Mxtqr9QiNEYoQRcZ3Bo4Oliwq2hS1Yk

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: d5cec5b5e9e840000000000000000001-712881f5e7109a7a-0

{
  "data": [
    {
      "batch_id": null,
      "completion_datetime": "2025-08-21T17:36:35.189619Z",
      "compliance_quantity": null,
      "description": null,
      "id": "00000000-0000-0000-0000-000000000163",
      "license_id": null,
      "location_id": null,
      "owner_id": "00000000-0000-0000-0000-0000000090e0",
      "package_id": null,
      "product_id": "7ee7b900-97e9-4de2-b538-01f6f5b3b053",
      "quantity": "10",
      "reason": "revaluation",
      "total_cost": "10000"
    },
    {
      "batch_id": null,
      "completion_datetime": "2025-08-21T17:36:35.545275Z",
      "compliance_quantity": "1",
      "description": "A default note describing this transaction",
      "id": "00000000-0000-0000-0000-000000000164",
      "license_id": "00000000-0000-0000-0000-000000001c24",
      "location_id": "00000000-0000-0000-0000-0000000029b4",
      "owner_id": null,
      "package_id": "00000000-0000-0000-0000-000000000ccd",
      "product_id": "a3c1cc48-34ab-4020-a605-ce97cbd9e5f8",
      "quantity": "1",
      "reason": "Voluntary Surrender",
      "total_cost": "900"
    },
    {
      "batch_id": "00000000-0000-0000-0000-000000001d4f",
      "completion_datetime": "2025-08-21T17:36:35.616886Z",
      "compliance_quantity": null,
      "description": null,
      "id": "00000000-0000-0000-0000-000000000165",
      "license_id": null,
      "location_id": "00000000-0000-0000-0000-0000000029af",
      "owner_id": null,
      "package_id": null,
      "product_id": "fb65ca1a-553e-41f3-9a9e-d6aa98fa86f5",
      "quantity": "1",
      "reason": "revaluation",
      "total_cost": "-800"
    }
  ]
}

Get stock adjustments sorted by their creation date and filtered by various attributes

Note: The page size for this endpoint is 5000 stock adjustments per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/adjustments

Parameters

Parameter	Description	In	Type	Required	Default	Example
inserted_datetime	Filter stock adjustments by their creation datetime	query	string	false		2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false

Responses

Status	Description	Schema
200	A list of stock adjustments	StockAdjustments

Insert a stock adjustment

POST /public/v1/adjustments creates an adjustment for a product tracked product

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTIsImlhdCI6MTc1NTc5Nzc5MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNmM4ZTIyYjQtM2NkMy00YWQyLWJjZmYtODFlYmZhMjgxZjRkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY2MzUiLCJ0eXAiOiJhY2Nlc3MifQ.8q702YKuj9QiEEq1xDsLiUj8tqVcOIcKoG6oksIdM78

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "00000000-0000-0000-0000-00000000292a",
  "product_id": "79bc3948-01ba-4e41-988a-748f46841468",
  "quantity": 10,
  "reason": "expired"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: fc9a85b41fc908000000000000000001-0e0baee2ef4e0317-0

{
  "data": {
    "batch_id": null,
    "completion_datetime": "2020-01-03T12:20:00.000000Z",
    "compliance_quantity": null,
    "description": "test",
    "id": "00000000-0000-0000-0000-000000000152",
    "license_id": null,
    "location_id": "00000000-0000-0000-0000-00000000292a",
    "owner_id": null,
    "package_id": null,
    "product_id": "79bc3948-01ba-4e41-988a-748f46841468",
    "quantity": "10",
    "reason": "expired",
    "total_cost": null
  }
}

POST /public/v1/adjustments creates an adjustment for a batch tracked product

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTQsImlhdCI6MTc1NTc5Nzc5NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODJjMGMzMTUtMTkxOS00NTlkLWE3NzUtZjk0ZmRkMTYzZjdkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY5NTIiLCJ0eXAiOiJhY2Nlc3MifQ.tuJHWP6d1cVlwnY92Tcw7Oe2uCEyoshXTlCgD6OmwS4

{
  "batch_id": "00000000-0000-0000-0000-000000001d1a",
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "00000000-0000-0000-0000-00000000298f",
  "quantity": 10,
  "reason": "expired",
  "unit_cost": 1000
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 583b6daa2136c0000000000000000001-6e0ad21c9b6f776b-0

{
  "data": {
    "batch_id": "00000000-0000-0000-0000-000000001d1a",
    "completion_datetime": "2020-01-03T12:20:00.000000Z",
    "compliance_quantity": null,
    "description": "test",
    "id": "00000000-0000-0000-0000-00000000015e",
    "license_id": null,
    "location_id": "00000000-0000-0000-0000-00000000298f",
    "owner_id": null,
    "package_id": null,
    "product_id": "fcc1cee2-dc83-4279-8e82-75ff441aeb67",
    "quantity": "10",
    "reason": "expired",
    "total_cost": "10000"
  }
}

POST /public/v1/adjustments creates an adjustment for a package tracked product

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTIsImlhdCI6MTc1NTc5Nzc5MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTNjMjRmYjEtMzFhNy00NGFkLWJjYTUtY2ZhMDRjMTI2ODBjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY1MzUiLCJ0eXAiOiJhY2Nlc3MifQ.NWG9nBlORFkqI351WBL07iM4aiSYPpIXJ8gyZwJ7wrM

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "compliance_quantity": 10,
  "description": "test",
  "package_id": "00000000-0000-0000-0000-000000000ca2",
  "reason": "Damage (BCC)",
  "unit_cost": 1000
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: fb69ab257a70e8000000000000000001-bf8c1c79f4ab78e4-0

{
  "data": {
    "batch_id": null,
    "completion_datetime": "2020-01-03T12:20:00.000000Z",
    "compliance_quantity": "10",
    "description": "test",
    "id": "00000000-0000-0000-0000-000000000150",
    "license_id": "00000000-0000-0000-0000-000000001ba1",
    "location_id": "00000000-0000-0000-0000-00000000290c",
    "owner_id": null,
    "package_id": "00000000-0000-0000-0000-000000000ca2",
    "product_id": "901f7d59-26b1-4bb3-9966-2f6378a93951",
    "quantity": "0.35274",
    "reason": "Damage (BCC)",
    "total_cost": "10000.000000005834"
  }
}

POST /public/v1/adjustments pointer translation works as intended

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTQsImlhdCI6MTc1NTc5Nzc5NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDExZDRjMDMtOWRhYy00YTk0LWIwNjMtODBlYzM3YjBlNGRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY4NzYiLCJ0eXAiOiJhY2Nlc3MifQ.xJmZ_mwYQllRP-a2S_blyPAsw2s_iK9ed4smsjVNonA

{
  "description": "test",
  "package_id": "00000000-0000-0000-0000-000000000cc0",
  "quantity": 10,
  "reason": "Damage (BCC)"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: f49535b2408c40000000000000000001-c4e5770f4083b4e9-0

{
  "errors": [
    {
      "context": {},
      "message": "can't be blank",
      "pointer": [
        "completion_datetime"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Required for adjustments of package tracked products",
      "pointer": [
        "compliance_quantity"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Cannot be set for adjustments of package tracked products",
      "pointer": [
        "quantity"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/adjustments pointer translation works for cost accounting as well

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTMsImlhdCI6MTc1NTc5Nzc5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMDU4Zjk3YzQtMGU3Zi00MGFiLTlhYzItMDVhYmE3NjRlODdhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY4MzkiLCJ0eXAiOiJhY2Nlc3MifQ.mnHxCTvFbHPzirMcQ7TRAI3xY8uXYaw3E8Y3nUMyDRE

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "00000000-0000-0000-0000-00000000296f",
  "product_id": "6a7ff6a6-6a29-4011-a391-c891da64ae7a",
  "quantity": 10,
  "reason": "expired"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: f3df0257e13e30000000000000000001-20e403d4dbfac327-0

{
  "errors": [
    {
      "context": {},
      "message": "Your company cost settings require a cost to be set when adding quantity",
      "pointer": [
        "unit_cost"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/adjustments validates quantity for non-compliance adjustments

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTIsImlhdCI6MTc1NTc5Nzc5MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzJlODUwYjgtNjA0NS00MDE3LThhZDMtMmZiMjYwZTE5NjY0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY1MDMiLCJ0eXAiOiJhY2Nlc3MifQ.KIxQ5y2NU891pGuRfTRoSDZjifBR17_Ldzm1iTaDEb0

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "compliance_quantity": 10,
  "description": "test",
  "location_id": "00000000-0000-0000-0000-000000002908",
  "product_id": "b943b074-ec22-4da0-8ae7-37e2d9b964cb",
  "reason": "expired"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 545256997ad624000000000000000001-9af396d96144c671-0

{
  "errors": [
    {
      "context": {},
      "message": "Cannot be set for adjustments of non-package tracked products",
      "pointer": [
        "compliance_quantity"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Required for adjustments of non-package tracked products",
      "pointer": [
        "quantity"
      ],
      "section": "body"
    }
  ]
}

validates only one id can be passed

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTQsImlhdCI6MTc1NTc5Nzc5NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjQ0YzA2N2MtYjViZC00OTIxLWFjNGQtMGRkMDYzYjYwNjBhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY5OTUiLCJ0eXAiOiJhY2Nlc3MifQ.fBVkqfxmoFb633YQeNg2F3DWSNFGvBXXaUV-SIPnbag

{
  "batch_id": "4d4793e1-aff9-4ed2-b3b6-9e59961c3b75",
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "c19046c5-ee7a-4d3e-9582-5e9ec6775553",
  "package_id": "eb5f1019-71d0-4458-b114-a56ab0c696fe",
  "product_id": "e0d8dff7-17e9-4f10-b7bb-92f84b68d634",
  "reason": "expired"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 9f9c55780b2aa0000000000000000001-bed5defc8e25ef6b-0

{
  "errors": [
    {
      "context": {},
      "message": "Only one of batch_id, package_id, or product_id can be set",
      "pointer": [
        "batch_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Required for adjustments of package tracked products",
      "pointer": [
        "compliance_quantity"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Cannot be set for adjustments of package tracked products because the source will automatically be set to the location of the package",
      "pointer": [
        "location_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Only one of batch_id, package_id, or product_id can be set",
      "pointer": [
        "package_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Only one of batch_id, package_id, or product_id can be set",
      "pointer": [
        "product_id"
      ],
      "section": "body"
    }
  ]
}

validates at least one id is passed

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTMsImlhdCI6MTc1NTc5Nzc5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjhmZjRjMWEtZjY0ZC00Njg1LTg0MWYtYzFmNzBhNmJmZjk1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY3NDMiLCJ0eXAiOiJhY2Nlc3MifQ.mHzT9tjT_KaB5Abbuuv6E2x5P96K52C3keClGFAiZjA

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "ebf243f7-9f85-4ba4-8368-27bb963a1fed",
  "reason": "expired"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 63a898df7f273c000000000000000001-9b013dff61d657eb-0

{
  "errors": [
    {
      "context": {},
      "message": "At least one of batch_id, package_id, or product_id must be set",
      "pointer": [
        "batch_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "At least one of batch_id, package_id, or product_id must be set",
      "pointer": [
        "package_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "At least one of batch_id, package_id, or product_id must be set",
      "pointer": [
        "product_id"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Required for adjustments of non-package tracked products",
      "pointer": [
        "quantity"
      ],
      "section": "body"
    }
  ]
}

validate waste must be negative

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTMsImlhdCI6MTc1NTc5Nzc5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjA3NzdkMmMtMTJmMi00OGQ2LTg2M2EtMjM5ODRjNGQzNGMyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY3MzMiLCJ0eXAiOiJhY2Nlc3MifQ.cyFwZ6Udcr0yvFnsTnMRyOne8-ZNMY9N7g70-oIvHMM

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "b1367dbc-25df-4962-a06c-ec22494cb849",
  "product_id": "00097410-982b-466d-bb27-4703a6b87116",
  "quantity": 10,
  "reason": "waste"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: c59add7e75ff48000000000000000001-6163d09c1ebb9c48-0

{
  "errors": [
    {
      "context": {},
      "message": "Quantity must be negative for waste adjustments",
      "pointer": [
        "quantity"
      ],
      "section": "body"
    }
  ]
}

validate compliance adjustments must not include location_id

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTMsImlhdCI6MTc1NTc5Nzc5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMjMzMmM4ZmItMGMzYS00N2VlLTg2NGQtZTA5YTBkN2M5YzEyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY2ODgiLCJ0eXAiOiJhY2Nlc3MifQ.HQ-emFQn9Nxd3bygDOHZLBNHqIZOkAXZp1ie9bwNURE

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "compliance_quantity": 10,
  "description": "test",
  "location_id": "1df7afe5-7cd4-4478-82cb-cc0f03eb8685",
  "package_id": "aa57431b-61c9-40e5-91ad-9207857aba02",
  "reason": "compliance"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 52a42a102da914000000000000000001-82fb8d2a09638492-0

{
  "errors": [
    {
      "context": {},
      "message": "Cannot be set for adjustments of package tracked products because the source will automatically be set to the location of the package",
      "pointer": [
        "location_id"
      ],
      "section": "body"
    }
  ]
}

validate compliance adjustments must include location_id

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTQsImlhdCI6MTc1NTc5Nzc5NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjc3MTg4ZDktOWMzMS00MjYzLWI3NmUtNjg2MTQyZTY4MmNlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzcwMDQiLCJ0eXAiOiJhY2Nlc3MifQ.cJWdeLC4XE4Ow3YcogjLy857Yqei5r1io99QTL8fdrc

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "product_id": "5915632f-48df-4bce-922e-55f0e5f9e7ad",
  "quantity": 10,
  "reason": "compliance"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: d70d6d8e698d30000000000000000001-3798c73bd207f122-0

{
  "errors": [
    {
      "context": {},
      "message": "Source location is required for non-compliance adjustments",
      "pointer": [
        "location_id"
      ],
      "section": "body"
    }
  ]
}

validates product exists

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTMsImlhdCI6MTc1NTc5Nzc5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjgzMDM0MDktZDkzNi00NjgzLThiMmUtMjllZGMzZjEzNmJiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY4NTAiLCJ0eXAiOiJhY2Nlc3MifQ.ev8qBODVn3FB91ce_Y0KT2FEijR0MEqhOHpIzhC2JLo

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "7d91f5cb-b964-403a-a937-dbe1ce688739",
  "product_id": "219d5698-3e30-4271-85fe-20f041506fe7",
  "quantity": 10,
  "reason": "compliance"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 9f1765ecbce2d8000000000000000001-a88929e635d7e1fd-0

{
  "errors": [
    {
      "context": {},
      "message": "Product not found",
      "pointer": [
        "product_id"
      ],
      "section": "body"
    }
  ]
}

validates batch exists

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTMsImlhdCI6MTc1NTc5Nzc5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZWMzNTRkMWEtMTYzYy00YmJkLTk4MjUtYTlhYTIyMWY0ZTAyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY3MjIiLCJ0eXAiOiJhY2Nlc3MifQ.1LP-aQuVPlqZa070CbceENPUXGK7vwVUtQUoMr_o--Q

{
  "batch_id": "00000000-0000-0000-0000-000000001ce0",
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "2b7e411f-2779-4304-bf45-cdffc7baf3a7",
  "quantity": 10,
  "reason": "compliance"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 0199f6ab3deb1bc00000000000000001-810c6a9ccd3e9c75-0

{
  "errors": [
    {
      "context": {},
      "message": "Batch not found",
      "pointer": [
        "batch_id"
      ],
      "section": "body"
    }
  ]
}

validates package exists

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTMsImlhdCI6MTc1NTc5Nzc5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTRkMjA3NTktYTU2ZC00YmFmLTg4ODctYmFjNWIxMDYyZWRmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY2OTciLCJ0eXAiOiJhY2Nlc3MifQ.-dOtMZl3zeapLt18FJyxvmgl0E6SkFAYGma-QJJ2Eng

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "compliance_quantity": 10,
  "description": "test",
  "package_id": "00000000-0000-0000-0000-000000000cad",
  "reason": "compliance"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: a67e89c462b740000000000000000001-a8a9ad29d36b9e00-0

{
  "errors": [
    {
      "context": {},
      "message": "Package not found",
      "pointer": [
        "package_id"
      ],
      "section": "body"
    }
  ]
}

validates location exists

POST /public/v1/adjustments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczOTMsImlhdCI6MTc1NTc5Nzc5MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzQxYzg0YTctODMxMi00NWQ4LTg4NzYtMjMwNjVmODI5MDE5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzkyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY2NjAiLCJ0eXAiOiJhY2Nlc3MifQ._iSazVFnmxP4yGEEnujFw5LvVOgEt4U9HydnxnAvtWc

{
  "batch_id": "00000000-0000-0000-0000-000000001cd4",
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "00000000-0000-0000-0000-000000002938",
  "quantity": 10,
  "reason": "compliance"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 69dc6026c3ef0c000000000000000001-85dacdee721fafd6-0

{
  "errors": [
    {
      "context": {},
      "message": "Location not found",
      "pointer": [
        "location_id"
      ],
      "section": "body"
    }
  ]
}

Request

POST /public/v1/adjustments

Parameters

Parameter	Description	In	Type	Required
product_id	The ID of the product to adjust. Must only be provided if the product is product-tracked.	query	string	false
batch_id	The ID of the batch to adjust. Must only be provided if the batch's associated product is batch-tracked.	query	string	false
package_id	The ID of the package to adjust. Must only be provided if the package's associated product is package-tracked.	query	string	false
quantity	The quantity to adjust the stock by. Must only be provided for non-compliance adjustments. Must be negative if the adjustment reason is 'waste'.	query	number	false
compliance_quantity	The quantity to adjust the stock by. Must only be provided for compliance adjustments.	query	number	false
description	The description of the stock adjustment. Required for compliance adjustmenst. Has a max length of 800 characters for non-compliance adjustments, and 250 characters for compliance adjustments.	query	string	false
unit_cost	The cost per unit of the stock adjustment. Can only be provided for companies with cost accounting enabled. Must be empty when the quantity is negative. Must be provided if the company setting 'Require Cost on Intake and Quantity Adjustments' is true.	query	number	false
completion_datetime	The datetime of the stock adjustment. Must only be provided for compliance adjustments.	query	string	false
reason	The reason for the stock adjustment. For non-compliance adjustments, must be one of the following: 'waste', 'stolen', 'damaged', 'fire', 'write-off', 'expired', 'lab-testing', 'revaluation', 'other.' For compliance adjustments, must be a reason that is accepted by the the compliance API	query	string	false
location_id	The ID of the source location of the stock adjustment. Must only be provided for non-compliance adjustments.	query	string	false

Responses

Status	Description	Schema
200	The stock adjustment was inserted successfully	StockAdjustment

Strain

Get strains

GET /public/v1/strains returns strains related to the company

GET /public/v1/strains
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0NjEsImlhdCI6MTc1NTc5Nzg2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTlkYjJjOTMtZjMyMS00ZDM4LWE2MjUtMDMyNDk5NWVjMmYxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDk5MTIiLCJ0eXAiOiJhY2Nlc3MifQ.BFe-Xg4R8onn9vatV3I1AK6eHN7V2_fQ6mvUjfHhlJQ

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: af0dc227828fe8000000000000000001-5469fda4bc570467-0

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-0000000001f2",
      "name": "Strain 492"
    },
    {
      "id": "00000000-0000-0000-0000-0000000001f3",
      "name": "Strain 493"
    }
  ]
}

Get strains filtered by various attributes

Note: The page size for this endpoint is 50k strains per page.

Request

GET /public/v1/strains

Parameters

Parameter	Description	In	Type	Required	Example
inserted_datetime	Filter strains by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false
updated_datetime	Filter strains by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of strains	Strains

TestResult

Get test results

GET /public/v1/test-results returns test results

GET /public/v1/test-results
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0NDMsImlhdCI6MTc1NTc5Nzg0MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiY2NhZmRkOTktZTBlYi00NWRhLWJiZmYtMWM2YThjNmNhMmM3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODQyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYzOTIiLCJ0eXAiOiJhY2Nlc3MifQ.l4mXyc8PzwX_TRIruB3smCSqZ4bz6UgA4dytAscJPLU

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 30ef5928f08a54000000000000000001-a5558f52bc6364df-0

{
  "data": [
    {
      "additional_test_results": {
        "thca_percentage": "12"
      },
      "batch_id": null,
      "cbd_mg_per_unit": "1.12345",
      "cbd_percentage": "60.1234",
      "id": "00000000-0000-0000-0000-00000000017b",
      "is_primary": false,
      "lab_license_number": "1234567890",
      "lab_name": "Test Lab",
      "mg_per_unit_type": "mg/g",
      "name": "Test result 1",
      "package_id": "00000000-0000-0000-0000-000000000fc7",
      "release_date": "2025-08-21",
      "thc_mg_per_unit": "2.12345",
      "thc_percentage": "20.1234",
      "total_cbd_mg_per_unit": "3.12345",
      "total_cbd_percentage": "80.1234",
      "total_thc_mg_per_unit": "4.12345",
      "total_thc_percentage": "40.1234",
      "updated_datetime": "2025-08-21T17:37:23.867418Z"
    },
    {
      "additional_test_results": {
        "thca_percentage": "12"
      },
      "batch_id": "00000000-0000-0000-0000-000000002687",
      "cbd_mg_per_unit": null,
      "cbd_percentage": null,
      "id": "00000000-0000-0000-0000-00000000017c",
      "is_primary": false,
      "lab_license_number": null,
      "lab_name": null,
      "mg_per_unit_type": "mg/g",
      "name": "File.pdf",
      "package_id": null,
      "release_date": null,
      "thc_mg_per_unit": null,
      "thc_percentage": null,
      "total_cbd_mg_per_unit": null,
      "total_cbd_percentage": null,
      "total_thc_mg_per_unit": null,
      "total_thc_percentage": null,
      "updated_datetime": "2025-08-21T17:37:23.879273Z"
    },
    {
      "additional_test_results": {},
      "batch_id": null,
      "cbd_mg_per_unit": null,
      "cbd_percentage": null,
      "id": "00000000-0000-0000-0000-00000000017f",
      "is_primary": false,
      "lab_license_number": null,
      "lab_name": null,
      "mg_per_unit_type": "mg/g",
      "name": "File.pdf",
      "package_id": "00000000-0000-0000-0000-000000000fd0",
      "release_date": null,
      "thc_mg_per_unit": null,
      "thc_percentage": null,
      "total_cbd_mg_per_unit": null,
      "total_cbd_percentage": null,
      "total_thc_mg_per_unit": null,
      "total_thc_percentage": null,
      "updated_datetime": "2025-08-21T17:37:24.115674Z"
    }
  ]
}

GET /public/v1/test-results returns only the additional test results that are present in the test result settings

GET /public/v1/test-results
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0NDMsImlhdCI6MTc1NTc5Nzg0MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTYwM2ViNzAtZTZiYi00NWJkLWE2YmEtOWE3ZDJiOTkyMmZjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODQyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYzNjAiLCJ0eXAiOiJhY2Nlc3MifQ._fZp4JaPnM9_FoJ3DgybXZSnZSQy8EEIqEXffj06e0E

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 334aac45e4720a000000000000000001-8a76147c2ec75fe8-0

{
  "data": [
    {
      "additional_test_results": {
        "spiroxamine_a_ug_per_g": "13",
        "thiacloprid_ug_per_g": "14"
      },
      "batch_id": "00000000-0000-0000-0000-000000002679",
      "cbd_mg_per_unit": null,
      "cbd_percentage": null,
      "id": "00000000-0000-0000-0000-00000000017a",
      "is_primary": false,
      "lab_license_number": null,
      "lab_name": null,
      "mg_per_unit_type": "mg/g",
      "name": "File.pdf",
      "package_id": null,
      "release_date": null,
      "thc_mg_per_unit": null,
      "thc_percentage": null,
      "total_cbd_mg_per_unit": null,
      "total_cbd_percentage": null,
      "total_thc_mg_per_unit": null,
      "total_thc_percentage": null,
      "updated_datetime": "2025-08-21T17:37:23.696342Z"
    }
  ]
}

Get test results filtered by various attributes.

Note: The page size for this endpoint is 5000 test results per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/test-results

Parameters

Parameter	Description	In	Type	Required	Default	Example
updated_datetime	Filter test results by the datetime they were most recently modified	query	string	false		,2022-07-10T00:00:00Z
page	Pagination information	body	Page	false

Responses

Status	Description	Schema
200	A list of test results	TestResults

Upsert a test result

POST /public/v1/test-results creates a test result for a batch tracked product

POST /public/v1/test-results
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0NDIsImlhdCI6MTc1NTc5Nzg0MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjM1NWNkNGItMGFkYS00OWViLWE0YWUtMDYyZDZhODRkMDAxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODQxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYwNTAiLCJ0eXAiOiJhY2Nlc3MifQ.2K_ygzKR3UFVvPQqYiRWx7OQpHFZjn9yQC3qNnlNIdk

{
  "additional_test_results": {
    "delta_8_thc_mg_per_unit": "17.3333",
    "delta_8_thc_percentage": "12.55",
    "thcva_percentage": "100"
  },
  "batch_id": "00000000-0000-0000-0000-000000002616",
  "cbd_mg_per_unit": "1.1",
  "cbd_percentage": "2.2",
  "is_primary": true,
  "lab_license_number": "1234567890",
  "lab_name": "Test Lab",
  "mg_per_unit_type": "mg/g",
  "name": "Name",
  "release_date": "2025-05-22",
  "thc_mg_per_unit": "3.3",
  "thc_percentage": "4.4",
  "total_cbd_mg_per_unit": "5.5",
  "total_cbd_percentage": "6.6",
  "total_thc_mg_per_unit": "7.7",
  "total_thc_percentage": "8.8"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 79dc92ed14cfac000000000000000001-5104a4c713ac4e84-0

{
  "data": {
    "additional_test_results": {
      "delta_8_thc_mg_per_unit": "17.3333",
      "delta_8_thc_percentage": "12.55",
      "thcva_percentage": "100"
    },
    "batch_id": "00000000-0000-0000-0000-000000002616",
    "cbd_mg_per_unit": "1.1",
    "cbd_percentage": "2.2",
    "id": "00000000-0000-0000-0000-00000000016a",
    "is_primary": true,
    "lab_license_number": "1234567890",
    "lab_name": "Test Lab",
    "mg_per_unit_type": "mg/g",
    "name": "Name",
    "package_id": null,
    "release_date": "2025-05-22",
    "thc_mg_per_unit": "3.3",
    "thc_percentage": "4.4",
    "total_cbd_mg_per_unit": "5.5",
    "total_cbd_percentage": "6.6",
    "total_thc_mg_per_unit": "7.7",
    "total_thc_percentage": "8.8",
    "updated_datetime": "2025-08-21T17:37:22.333811Z"
  }
}

POST /public/v1/test-results creates a test result for a package tracked product

POST /public/v1/test-results
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0NDMsImlhdCI6MTc1NTc5Nzg0MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDFmNjBlMjYtZDI0NC00NWI4LTkzZWYtNjRiNzQxYWU2YmU1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODQyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYyMjkiLCJ0eXAiOiJhY2Nlc3MifQ.JWqbBr352BwjxbLHhtE94FMXDm1Gcjqy8lCUoI0Xp1s

{
  "additional_test_results": {},
  "is_primary": false,
  "lab_license_number": "1234567890",
  "lab_name": "Test Lab",
  "mg_per_unit_type": "mg/mL",
  "name": "Name",
  "package_id": "00000000-0000-0000-0000-000000000fbf"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 7cb46ea05bebe0000000000000000001-7587d4480b321e52-0

{
  "data": {
    "additional_test_results": {},
    "batch_id": null,
    "cbd_mg_per_unit": null,
    "cbd_percentage": null,
    "id": "00000000-0000-0000-0000-000000000178",
    "is_primary": true,
    "lab_license_number": "1234567890",
    "lab_name": "Test Lab",
    "mg_per_unit_type": "mg/mL",
    "name": "Name",
    "package_id": "00000000-0000-0000-0000-000000000fbf",
    "release_date": null,
    "thc_mg_per_unit": null,
    "thc_percentage": null,
    "total_cbd_mg_per_unit": null,
    "total_cbd_percentage": null,
    "total_thc_mg_per_unit": null,
    "total_thc_percentage": null,
    "updated_datetime": "2025-08-21T17:37:23.299214Z"
  }
}

POST /public/v1/test-results properly transforms pointer on error

POST /public/v1/test-results
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0NDMsImlhdCI6MTc1NTc5Nzg0MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTI2MzA3MDQtYzYyOC00NTJhLTgzMmUtOGQ1NTAxYjlkN2ZiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODQyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYyMTIiLCJ0eXAiOiJhY2Nlc3MifQ.lEowUVE5V9ogrL5QBfjuopd1zC7HkigYAi-7suMdr2A

{
  "batch_id": "00000000-0000-0000-0000-000000002654",
  "mg_per_unit_type": "mg/g",
  "name": "Name"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: a52c1b4fb94e20000000000000000001-b2ce655602d6dd27-0

{
  "errors": [
    {
      "context": {},
      "message": "can't be blank",
      "pointer": [
        "additional_test_results"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "can't be blank",
      "pointer": [
        "is_primary"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/test-results properly transforms pointer on service function error

POST /public/v1/test-results
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0NDIsImlhdCI6MTc1NTc5Nzg0MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTY0MDQxYjItYzU2OC00ZDhkLWI5MmEtNzhhZmQ5ZjBmOTUzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODQxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYwMzIiLCJ0eXAiOiJhY2Nlc3MifQ.CUTm4vR2TqFxF8ZTwkzNXEqPSqETZX4vVNmHOVHMAe8

{
  "additional_test_results": {},
  "batch_id": "00000000-0000-0000-0000-000000002610",
  "is_primary": false,
  "mg_per_unit_type": "mg/g",
  "name": "Name",
  "total_cbd_mg_per_unit": "-3.3456",
  "total_cbd_percentage": "2.234567",
  "total_thc_mg_per_unit": "-4.4567",
  "total_thc_percentage": "1.123456"
}

Response

400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 65870221afa0bc000000000000000001-2d179247b7d4ff6f-0

{
  "errors": [
    {
      "context": {},
      "message": "must be greater than or equal to 0",
      "pointer": [
        "total_cbd_mg_per_unit"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Must have at most 4 decimal digits",
      "pointer": [
        "total_cbd_percentage"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "must be greater than or equal to 0",
      "pointer": [
        "total_thc_mg_per_unit"
      ],
      "section": "body"
    },
    {
      "context": {},
      "message": "Must have at most 4 decimal digits",
      "pointer": [
        "total_thc_percentage"
      ],
      "section": "body"
    }
  ]
}

POST /public/v1/test-results properly updates a test result

POST /public/v1/test-results
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDc0NDIsImlhdCI6MTc1NTc5Nzg0MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZmM0YjM3MTEtNDBlYi00ZGExLTg2MzAtOTkyZmE5ZDUwMTY1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3ODQxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYxNzkiLCJ0eXAiOiJhY2Nlc3MifQ.Pn1qZRe_PvlUE4v079M-Xxg4yfw6pfnLtqHz_R82x-I

{
  "additional_test_results": {
    "thca_percentage": "15"
  },
  "id": "00000000-0000-0000-0000-000000000177",
  "is_primary": true,
  "lab_name": "after lab name",
  "mg_per_unit_type": "mg/mL",
  "name": "after name",
  "release_date": "2025-05-23",
  "total_thc_percentage": "14"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 8942e990114aa0000000000000000001-28edb71e45467b98-0

{
  "data": {
    "additional_test_results": {
      "thca_percentage": "15"
    },
    "batch_id": "00000000-0000-0000-0000-000000002646",
    "cbd_mg_per_unit": null,
    "cbd_percentage": null,
    "id": "00000000-0000-0000-0000-000000000177",
    "is_primary": true,
    "lab_license_number": null,
    "lab_name": "after lab name",
    "mg_per_unit_type": "mg/mL",
    "name": "after name",
    "package_id": null,
    "release_date": "2025-05-23",
    "thc_mg_per_unit": null,
    "thc_percentage": null,
    "total_cbd_mg_per_unit": null,
    "total_cbd_percentage": null,
    "total_thc_mg_per_unit": null,
    "total_thc_percentage": "14",
    "updated_datetime": "2025-08-21T17:37:22.989913Z"
  }
}

Upsert a single test result. To update an existing test result, pass in an existing test result ID in the id field. When updating a test result, you must pass in all fields including all additional test results (no sparse update currently supported). Result percentage values can have no more than 4 decimal places.

Request

POST /public/v1/test-results

Parameters

Parameter	Description	In	Type	Required	Example
id	Unique ID for this test result. If it exists, an update will be performed, and will otherwise throw an error. Only non-compliance tracked test results can be updated.	query	string	false
package_id	The ID of the package this test result belongs to. Cannot be provided if either id or batch_id is provided.	query	string	false	123e4567-e89b-12d3-a456-426614174000
batch_id	The ID of the batch this test result belongs to. Cannot be provided if either id or package_id is provided.	query	string	false	123e4567-e89b-12d3-a456-426614174000
additional_test_results	The additional tests results for this test result. Check here for the valid options.	query	object	false
mg_per_unit_type	The unit type for the mg per unit fields	query	string	false	mg/g
is_primary	Setting a test result to is_primary: true will propagate the test result to child packages if applicable. Cannot update a test_result from is_primary: true to is_primary: false. If you want to do this, you must set a different test result on the same package/batch to is_primary: true. Once done, this test_result will be set to is_primary: false automatically.	query	boolean	false	true
release_date	The release date for this test result	query	string	false	2022-07-10
lab_license_number	The license number of this test result's lab	query	string	false	1234567890
lab_name	The name of this test result's lab	query	string	false	Lab Name
name	The name of this test result	query	string	false	Test Result Name
thc_percentage	The THC percentage for this test result. Max precision is 4 decimal places.	query	decimal	false	1.5
total_thc_percentage	The total THC percentage for this test result. Max precision is 4 decimal places.	query	decimal	false	1.5
thc_mg_per_unit	The THC mg per unit for this test result.	query	decimal	false	1.5
total_thc_mg_per_unit	The total THC mg per unit for this test result.	query	decimal	false	1.5
cbd_percentage	The CBD percentage for this test result. Max precision is 4 decimal places.	query	decimal	false	1.5
total_cbd_percentage	The total CBD percentage for this test result. Max precision is 4 decimal places.	query	decimal	false	1.5
cbd_mg_per_unit	The CBD mg per unit for this test result.	query	decimal	false	1.5
total_cbd_mg_per_unit	The total CBD mg per unit for this test result.	query	decimal	false	1.5

Responses

Status	Description	Schema
200	A single test result	TestResult

User

Get users

GET /public/v1/users returns users related to the company

GET /public/v1/users
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODcyNDczODMsImlhdCI6MTc1NTc5Nzc4MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZmJhNmI3N2ItYzUwMC00MDk2LThkNjMtNDJjZmVhNzY5OTE1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU1Nzk3NzgyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzQ4ODAiLCJ0eXAiOiJhY2Nlc3MifQ.xdSW_lOxfDzH-mXvv4dOn9KayYs4lorhgtddqecJuf4

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e1c2645ff144f0000000000000000001-694dbf929597f1f9-0

{
  "data": [
    {
      "banned": false,
      "email": "owner-35188@example.com",
      "full_name": "FirstName69615 LastName69616",
      "id": "00000000-0000-0000-0000-000000008840",
      "role": {
        "id": "00000000-0000-0000-0000-0000000087b5",
        "name": "Admin 34636"
      }
    },
    {
      "banned": false,
      "email": "owner-35191@example.com",
      "full_name": "FirstName69621 LastName69622",
      "id": "00000000-0000-0000-0000-000000008843",
      "role": {
        "id": "00000000-0000-0000-0000-0000000087b8",
        "name": "Admin 34639"
      }
    }
  ]
}

Get users sorted by their creation date and filtered by various attributes

Note: The page size for this endpoint is 1000 users per page. This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Request

GET /public/v1/users

Parameters

Parameter	Description	In	Type	Required	Example
inserted_datetime	Filter users by their creation datetime	query	string	false	2022-07-10T00:00:00Z,
page	Pagination information	body	Page	false
updated_datetime	Filter users by the datetime they were most recently modified	query	string	false	,2022-07-10T00:00:00Z

Responses

Status	Description	Schema
200	A list of users	Users

Changelog

2024-10-2

Added GET /public/v1/strains endpoint.
In endpoint GET /public/v1/companies, added fields category and relationship to the response.

2024-11-6

Field thc of type string in the Product object was replaced with total_thc field of type number.
Field cbd of type string in the Product object was replaced with total_cbd field of type number.
Added total_cannabinoid_unit field to Product object. Allowed values are either "MG" or "PERCENT".

2024-12-24

Added billing_location_id to POST /public/v1/purchases endpoint.

2024-12-26

Added msrp, is_active, category.type and images.rank to GET /public/v1/products.

2025-01-08

Added GET /public/v1/payment-methods endpoint.

2025-01-15

Added POST /public/v1/purchases/:id/payments endpoint.
Added POST /public/v1/invoices/:id/payments endpoint.

2025-01-17

Added product_unit_quantity to GET /public/v1/packages endpoint.
Added product_unit_type to GET /public/v1/packages endpoint.

2025-01-31

Added POST /public/v1/batches endpoint.
Added batch_number, product_id, owner_id and description to GET /public/v1/batches endpoint.
Added title and phone_number to GET /public/v1/contacts endpoint.

2025-02-26

Page size change from 50,000 to 5000 for the following endpoints:
- GET /public/v1/batches
- GET /public/v1/companies
- GET /public/v1/contacts
- GET /public/v1/inventory
- GET /public/v1/packages
- GET /public/v1/products
- GET /public/v1/purchases

2025-08-19

All GET endpoints now return eventually consistent data, with changes taking up to 1 second to propagate in responses

2025-03-05

Added GET /public/v1/assemblies endpoint.

2025-03-11

Added total_cost_actual, total_cost_default and returned_quantity to "items" in GET /public/v1/invoices endpoint.
Added total_cost_actual, total_cost_default and returned_quantity to "items" in GET /public/v1/invoices/:id endpoint.
Added total_cost_actual, total_cost_default and returned_quantity to "items" in GET /public/v1/orders endpoint.
Added total_cost_actual, total_cost_default and returned_quantity to "items" in GET /public/v1/orders/:id endpoint.

2025-03-18

Modified unit_net_weight and unit_serving_size in GET /public/v1/products endpoint: These fields can now be populated regardless of the product's unit type.

2025-04-09

Added the following fields to GET /public/v1/companies endpoint:
- legal_business_name
- default_email
- phone_number
- invoice_email
- sales_order_email
- purchase_order_email
- order_shipment_email
- website
- default_sales_order_notes
- default_purchase_order_notes
- outstanding_balance_threshold
- owner_id

2025-05-06

Added is_trade_sample to GET /public/v1/packages endpoint.

2025-05-13

Added GET /public/v1/adjustments endpoint.

2025-05-14

Added custom_data to the response of the following endpoints:
- GET /public/v1/assemblies
- GET /public/v1/batches
- POST /public/v1/batches
- GET /public/v1/companies
- GET /public/v1/contacts
- GET /public/v1/invoices
- GET /public/v1/invoices/:id
- POST /public/v1/invoices
- GET /public/v1/orders
- GET /public/v1/orders/:id
- POST /public/v1/orders
- GET /public/v1/packages
- GET /public/v1/products
- POST /public/v1/products
- GET /public/v1/purchases
- POST /public/v1/purchases

2025-05-15

Added POST /public/v1/stock_adjustments endpoint.

2025-05-16

Added GET /public/v1/test-results
Added POST /public/v1/test-results

2025-05-18

Added leaflink_order_number to GET /public/v1/orders

2025-05-22

Added external_name to GET/POST /public/v1/products

2025-05-27

Added biotrack_id and metrc_transfer_id to POST /public/v1/orders

2025-06-09

Added POST /public/v1/file-attachments endpoint for uploading files and attaching them to business entities (products, orders, purchases, etc.).

2025-06-12

Added metrc_transfer_id and biotrack_id to GET /public/v1/orders

2025-06-12

Changed cost on GET /public/v1/assemblies to total_cost_actual in ingredients
Added total_cost_default to GET /public/v1/assemblies in ingredients
Added total_cost_actual to GET /public/v1/assemblies in additional_costs
Added total_cost_default to GET /public/v1/assemblies in additional_costs

2025-07-01

Added description_markdown to GET/POST /public/v1/products

2025-08-20

Added GET /public/v1/product-pos-mappings endpoint
Added POST /public/v1/product-pos-mappings endpoint
Added DELETE /public/v1/product-pos-mappings/:id endpoint

2025-08-21

Added group to GET /public/v1/companies