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 |
cost_per_unit | The cost per unit of this invoice item. | number | false |
cost_per_unit_default | The default cost per unit (from the configured product unit cost) of this invoice item. | number | 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 |
is_sample | True if this order is a sample | boolean | 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 |
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 |
cost_per_unit_actual | The cost per unit of this batch | number | false |
cost_per_unit_default | The default cost per unit (from the configured product unit cost) of this batch | number | 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 |
total_cost_actual | The total actual cost of this batch | number | false |
total_cost_default | The total default cost (from the configured product unit cost) of this batch | number | 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 |
cost_per_unit_actual | The cost per unit of this order item | number | 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 |
cost_per_unit_actual | The cost per unit of this package | number | false |
cost_per_unit_default | The default cost per unit (from the configured product unit cost) of this package | number | 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 |
total_cost_actual | The total actual cost of this package | number | false |
total_cost_default | The total default cost (from the configured product unit cost) of this package | number | 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 |
cost_per_unit_actual | The cost per unit of this output | number | false |
cost_per_unit_default | The default cost per unit (from the configured product unit cost) of this output | 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 |
total_cost_actual | The total actual cost of this output | number | false |
total_cost_default | The total default cost (from the configured product unit cost) of this output | 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 |
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 |
cost_per_unit_actual | The cost per unit of this input | number | false |
cost_per_unit_default | The default cost per unit (from the configured product unit cost) of this input | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzQzYTRhMmYtZDMzNi00M2JlLThiNjgtNTJmZWMzNzYwZDJhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA1NiIsInR5cCI6ImFjY2VzcyJ9.sT6SUDbII2IvL5KGM3vDYW7W9P7yiUlCLhBSbIhx5SE
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 72052ef58ae748000000000000000001-eb0fa166d33dc6ef-0
{
"data": [
{
"completion_datetime": "2025-09-17T15:12:40.345063Z",
"compliance_type": "NONE",
"creation_source": "MANUALLY_CREATED",
"custom_data": [
{
"id": 39,
"name": "Custom Field 8",
"value": "Custom Field Value"
}
],
"description": null,
"estimated_work_hours": 1,
"estimated_work_minutes": 5,
"fulfilled": true,
"id": "a732d6f4-4542-4cd7-821a-ccc596f2f40b",
"is_metrc_processing_job": false,
"license": null,
"outputs": [
{
"additional_costs": [
{
"cost_per_unit": "-1",
"description": null,
"name": "CostType 0",
"quantity": "1",
"total_cost_actual": "-1",
"total_cost_default": "0",
"unit_type": {
"id": "00000000-0000-0000-0000-00000000b34e",
"name": "Unit Type 3"
}
}
],
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000899",
"name": "B1020"
},
"compliance_label": null,
"compliance_quantity": null,
"cost_per_unit": "0.6",
"cost_per_unit_default": "-1",
"expiration_datetime": null,
"ingredients": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000899",
"name": "B1020"
},
"compliance_quantity": null,
"cost_per_unit": "0.2",
"cost_per_unit_default": "1",
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000dbc",
"id": "00000000-0000-0000-0000-00000000048b",
"license_id": null,
"name": "Place 178"
},
"package": null,
"product": {
"id": "f6b53f29-8340-4ecc-8a12-f0ba5ad08273",
"name": "Product 1014",
"sku": "sku 1015",
"updated_datetime": "2025-09-17T15:12:40.305147Z"
},
"quantity": "2",
"total_cost_actual": "0.4",
"total_cost_default": "2"
}
],
"is_production_batch": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000dbc",
"id": "00000000-0000-0000-0000-00000000048b",
"license_id": null,
"name": "Place 178"
},
"package": null,
"package_datetime": null,
"package_unit_type": null,
"product": {
"id": "f6b53f29-8340-4ecc-8a12-f0ba5ad08273",
"name": "Product 1014",
"sku": "sku 1015",
"updated_datetime": "2025-09-17T15:12:40.305147Z"
},
"quantity": "1",
"total_cost_actual": "-0.6",
"total_cost_default": "1"
}
],
"owner_id": "00000000-0000-0000-0000-000000000fd8",
"status": "COMPLETED"
}
],
"next_page": null
}
GET /public/v1/assemblies returns proper data for pending metrc assembly
GET /public/v1/assemblies?creation_source=MANUALLY_CREATED&license_number=CDPH-00000047&page[number]=1
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiM2Q3YjMwODYtMDcyZi00OGE3LTg5MzUtNjg3NDI2MGY3OTJiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzk1MCIsInR5cCI6ImFjY2VzcyJ9.7nYdsZOoYy2w_bC3FOkFF86zpOzZkYjgI9eJn3W_JVc
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 1c5406774750a7000000000000000001-201f9b22300f1fb8-0
{
"data": [
{
"completion_datetime": null,
"compliance_type": "METRC",
"creation_source": "MANUALLY_CREATED",
"custom_data": [
{
"id": 37,
"name": "Custom Field 6",
"value": null
}
],
"description": null,
"estimated_work_hours": null,
"estimated_work_minutes": null,
"fulfilled": true,
"id": "af45fe1a-7a4c-4fd6-8618-f564df24ee9a",
"is_metrc_processing_job": false,
"license": {
"id": "00000000-0000-0000-0000-000000000188",
"license_number": "CDPH-00000047"
},
"outputs": [
{
"additional_costs": [],
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000841",
"name": "B744"
},
"compliance_label": "1A4010200001234000000002",
"compliance_quantity": "2",
"cost_per_unit": null,
"cost_per_unit_default": null,
"expiration_datetime": null,
"ingredients": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000841",
"name": "B744"
},
"compliance_quantity": "0.0353",
"cost_per_unit": null,
"cost_per_unit_default": null,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000d4c",
"id": "00000000-0000-0000-0000-000000000467",
"license_id": "00000000-0000-0000-0000-000000000188",
"name": "Place 142"
},
"package": {
"batch_number": "1234567890",
"compliance_label": "ABCDEF012345670000000096",
"id": "00000000-0000-0000-0000-0000000000e6",
"metrc_label": "ABCDEF012345670000000096",
"status": "active"
},
"product": {
"id": "c91e441a-4f15-441e-99c4-957cf2d08884",
"name": "Product 739",
"sku": "sku 740",
"updated_datetime": "2025-09-17T15:12:39.913057Z"
},
"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-000000000d4c",
"id": "00000000-0000-0000-0000-000000000467",
"license_id": "00000000-0000-0000-0000-000000000188",
"name": "Place 142"
},
"package": null,
"package_datetime": "2025-09-17",
"package_unit_type": {
"id": "00000000-0000-0000-0000-00000000acf0",
"name": "Gram"
},
"product": {
"id": "c91e441a-4f15-441e-99c4-957cf2d08884",
"name": "Product 739",
"sku": "sku 740",
"updated_datetime": "2025-09-17T15:12:39.913057Z"
},
"quantity": "2",
"total_cost_actual": null,
"total_cost_default": null
}
],
"owner_id": "00000000-0000-0000-0000-000000000f6e",
"status": "PENDING"
}
],
"next_page": null
}
GET /public/v1/assemblies returns proper data for completed metrc assembly
GET /public/v1/assemblies?completion_datetime=2025-09-17+14%3A12%3A39.582676Z%2C2025-09-17+16%3A12%3A39.582676Z&creation_source=MANUALLY_CREATED&license_number=CDPH-00000037&page[number]=1
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMWM2YjgzYjMtZDQ4Mi00MTUyLWI1YzgtMWY5YTlmOWVmZjE5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzg0NSIsInR5cCI6ImFjY2VzcyJ9.NqZ5y77zX6-5Ymu8Fdt2bFAScPvyMYaNnnCiBspbca8
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 9b0106959e3e10000000000000000001-dd0e3986e4a2e56a-0
{
"data": [
{
"completion_datetime": "2025-09-17T15:12:39.582676Z",
"compliance_type": "METRC",
"creation_source": "MANUALLY_CREATED",
"custom_data": [],
"description": null,
"estimated_work_hours": null,
"estimated_work_minutes": null,
"fulfilled": true,
"id": "0a0401c5-a6a5-427f-b745-1f34974b8f61",
"is_metrc_processing_job": false,
"license": {
"id": "00000000-0000-0000-0000-00000000017e",
"license_number": "CDPH-00000037"
},
"outputs": [
{
"additional_costs": [],
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000080c",
"name": "B590"
},
"compliance_label": "1A4010200001234000000001",
"compliance_quantity": "2",
"cost_per_unit": null,
"cost_per_unit_default": null,
"expiration_datetime": null,
"ingredients": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000080c",
"name": "B590"
},
"compliance_quantity": "0.0353",
"cost_per_unit": null,
"cost_per_unit_default": null,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000cfe",
"id": "00000000-0000-0000-0000-000000000451",
"license_id": "00000000-0000-0000-0000-00000000017e",
"name": "Place 120"
},
"package": {
"batch_number": "1234567890",
"compliance_label": "ABCDEF012345670000000074",
"id": "00000000-0000-0000-0000-0000000000d9",
"metrc_label": "ABCDEF012345670000000074",
"status": "active"
},
"product": {
"id": "b4876cb3-4266-483e-aaae-0a60ff42d046",
"name": "Product 585",
"sku": "sku 586",
"updated_datetime": "2025-09-17T15:12:39.162853Z"
},
"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-000000000cfe",
"id": "00000000-0000-0000-0000-000000000451",
"license_id": "00000000-0000-0000-0000-00000000017e",
"name": "Place 120"
},
"package": {
"batch_number": null,
"compliance_label": "1A4010200001234000000001",
"id": "00000000-0000-0000-0000-0000000000dc",
"metrc_label": "1A4010200001234000000001",
"status": "active"
},
"package_datetime": "2025-09-17",
"package_unit_type": {
"id": "00000000-0000-0000-0000-00000000a8cd",
"name": "Gram"
},
"product": {
"id": "b4876cb3-4266-483e-aaae-0a60ff42d046",
"name": "Product 585",
"sku": "sku 586",
"updated_datetime": "2025-09-17T15:12:39.162853Z"
},
"quantity": "2",
"total_cost_actual": null,
"total_cost_default": null
}
],
"owner_id": "00000000-0000-0000-0000-000000000f05",
"status": "COMPLETED"
}
],
"next_page": null
}
GET /public/v1/assemblies returns proper data for biotrack assembly
GET /public/v1/assemblies?completion_datetime=2025-09-17+14%3A12%3A40.642182Z%2C2025-09-17+16%3A12%3A40.642182Z&creation_source=MANUALLY_CREATED&license_number=CDPH-00000070&page[number]=1
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjEzY2FhYTMtOTY3Yi00Njc4LWI4ZWYtOTExNjc2ZjY4MjUzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA5NyIsInR5cCI6ImFjY2VzcyJ9.UFlsp2devqmGWmfc7nNTvv-e1rSMSt9PrWCGAVkDTtE
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 954264df175bc0000000000000000001-3d40d5eb50ce3771-0
{
"data": [
{
"completion_datetime": "2025-09-17T15:12:40.642182Z",
"compliance_type": "BIOTRACK",
"creation_source": "MANUALLY_CREATED",
"custom_data": [],
"description": null,
"estimated_work_hours": null,
"estimated_work_minutes": null,
"fulfilled": true,
"id": "f60d7076-b093-4e21-bcb8-4ee3186889c1",
"is_metrc_processing_job": false,
"license": {
"id": "00000000-0000-0000-0000-00000000019f",
"license_number": "CDPH-00000070"
},
"outputs": [
{
"additional_costs": [],
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008ae",
"name": "B1065"
},
"compliance_label": null,
"compliance_quantity": "1",
"cost_per_unit": null,
"cost_per_unit_default": null,
"expiration_datetime": null,
"ingredients": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008ae",
"name": "B1065"
},
"compliance_quantity": "1",
"cost_per_unit": null,
"cost_per_unit_default": null,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000dd5",
"id": "00000000-0000-0000-0000-000000000497",
"license_id": "00000000-0000-0000-0000-00000000019f",
"name": "Place 190"
},
"package": {
"batch_number": null,
"compliance_label": "4",
"id": "00000000-0000-0000-0000-0000000000f5",
"metrc_label": "4",
"status": "active"
},
"product": {
"id": "3c223d73-e03c-4e89-9176-4fd23f151919",
"name": "Product 1060",
"sku": "sku 1061",
"updated_datetime": "2025-09-17T15:12:40.533728Z"
},
"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-000000000dd5",
"id": "00000000-0000-0000-0000-000000000497",
"license_id": "00000000-0000-0000-0000-00000000019f",
"name": "Place 190"
},
"package": {
"batch_number": null,
"compliance_label": null,
"id": "00000000-0000-0000-0000-0000000000ff",
"metrc_label": null,
"status": "active"
},
"package_datetime": null,
"package_unit_type": {
"id": "00000000-0000-0000-0000-00000000b41e",
"name": "Gram"
},
"product": {
"id": "3c223d73-e03c-4e89-9176-4fd23f151919",
"name": "Product 1060",
"sku": "sku 1061",
"updated_datetime": "2025-09-17T15:12:40.533728Z"
},
"quantity": "1",
"total_cost_actual": null,
"total_cost_default": null
}
],
"owner_id": "00000000-0000-0000-0000-000000001001",
"status": "COMPLETED"
}
],
"next_page": null
}
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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiODAwZDA5ZTEtY2E2Yi00ZmY2LWE5OTgtODY4ZTM4MmU1ODZiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzUwMCIsInR5cCI6ImFjY2VzcyJ9.MSlBYqaO_MBvxfqwTFJqfPlBsT3PGoegzkfm0o9gVxw
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 78eab4eae604f0000000000000000001-d87c387d9c154e52-0
{
"data": [
{
"batch_number": null,
"custom_data": [
{
"id": 34,
"name": "Custom Field 3",
"value": "Custom Data 1"
}
],
"description": null,
"expiration_date": "2024-01-01T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-00000000075b",
"name": "B99",
"owner_id": "00000000-0000-0000-0000-000000000daf",
"primary_test_result": null,
"product_id": "76af77f1-4c65-46c7-8710-f0cbb590609c"
},
{
"batch_number": null,
"custom_data": [
{
"id": 34,
"name": "Custom Field 3",
"value": null
}
],
"description": null,
"expiration_date": null,
"id": "00000000-0000-0000-0000-00000000075c",
"name": "B102",
"owner_id": "00000000-0000-0000-0000-000000000db3",
"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": "e049dbda-cf75-4e2d-9931-bbd09dab56b9"
}
],
"next_page": null
}
GET /public/v1/batches returns cost data when include_costs is true
GET /public/v1/batches?include_costs=true
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTJhY2ZjNGMtOWM2Mi00Y2JiLWI0ZTItNmJkZjA3OTNmMzcxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzYwOSIsInR5cCI6ImFjY2VzcyJ9.Yu6qBPUKwdmg_HroATcFz9wcaOj0LtN9Q6oaVNJeXl0
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: a6c0b19912cde0000000000000000001-1df2b90c0eba1af0-0
{
"data": [
{
"batch_number": null,
"cost_per_unit_actual": "2.11",
"cost_per_unit_default": "5",
"custom_data": [],
"description": null,
"expiration_date": null,
"id": "00000000-0000-0000-0000-000000000776",
"name": "B211",
"owner_id": "00000000-0000-0000-0000-000000000e21",
"primary_test_result": null,
"product_id": "95ee0d8d-19f7-4de5-9f51-2cb3ab35940c",
"total_cost_actual": "21.1",
"total_cost_default": "50"
}
],
"next_page": null
}
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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjY0ZTExMDQtYTdiYi00YzQ0LTg0NzAtZjUyZTljMTY5ZTJmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY0MSIsInR5cCI6ImFjY2VzcyJ9._Uv777RxFvlzkUu4G7dEhSIuFBZ3Xn0mm47jEU3A4hI
{
"owner_id": "3f07fe22-4f85-4fb7-aa5e-fac0a00559aa",
"product_id": "4bd3d137-802a-4766-8ae3-40e38d3fc7b9"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: af2cda2cb312c8000000000000000001-4bf7b97cae52e3c7-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzVhNjlmNjEtMjRkZS00NDJjLWJlYjYtYjZmNmU0NWEyZDM3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzQxMSIsInR5cCI6ImFjY2VzcyJ9.w34HgFAcybDLGLTPO1H-7O4MJ5Y1taUFPt1E_qjbBYw
{
"product_id": "aa0a29c0-439d-4918-ae1b-91ed6470f49c"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: b0f0c4484a4020000000000000000001-42931fd896f60e94-0
{
"data": {
"batch_number": null,
"custom_data": [],
"description": null,
"expiration_date": null,
"id": "00000000-0000-0000-0000-000000000755",
"name": "B1",
"owner_id": null,
"product_id": "aa0a29c0-439d-4918-ae1b-91ed6470f49c"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTQ3MWYyOWItYTg5ZS00ZjJkLThiOWQtZDhhMzdjNzQ4YTc1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY0NiIsInR5cCI6ImFjY2VzcyJ9.X-6DHnAuhuznd13L9Px3UoScDzuH9d0qD96XGydaPZs
{
"batch_number": "B1",
"description": "Test batch",
"expiration_date": "2025-01-01T00:00:00.000000Z",
"owner_id": "00000000-0000-0000-0000-000000000e4a",
"product_id": "eb0da908-5a9d-4083-bee2-eacb85c74d56"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: cfc797caac9690000000000000000001-efea3ceb886f552a-0
{
"data": {
"batch_number": "B1",
"custom_data": [],
"description": "Test batch",
"expiration_date": "2025-01-01T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-00000000077d",
"name": "B1",
"owner_id": "00000000-0000-0000-0000-000000000e4a",
"product_id": "eb0da908-5a9d-4083-bee2-eacb85c74d56"
}
}
Create a single batch.
Request
POST /public/v1/batches
Parameters
Parameter | Description | In | Type | Required | Default | Example |
---|---|---|---|---|---|---|
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDJmMWExMDgtODQ0Yi00ZjA5LTgyZDMtYjVmZWMzNjBlY2Y3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzQwNyIsInR5cCI6ImFjY2VzcyJ9.ge9aTs1E88RwMlSLURy28fy33qD1PRRk9qL3Ov9nwM4
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: e07894ed5d27a0000000000000000001-7f296cbeed3393d0-0
{
"data": [
{
"category": "Retailer",
"custom_data": [
{
"id": 33,
"name": "Custom Field 2",
"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-000000000003",
"name": "Comp Rel Group 0"
},
"id": "00000000-0000-0000-0000-0000000008ff",
"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-000000000baf",
"id": "00000000-0000-0000-0000-0000000003fb",
"license_id": null,
"name": "Place 34"
}
],
"name": "Company 80",
"order_shipment_email": "order shipment email",
"outstanding_balance_threshold": 1000,
"owner_id": "00000000-0000-0000-0000-000000000d59",
"phone_number": "1234567890",
"purchase_order_email": "purchase email",
"relationship_type": {
"id": "00000000-0000-0000-0000-000000000003",
"name": "Supplier"
},
"sales_order_email": "order email",
"updated_datetime": "2023-11-03T00:00:00.000000Z",
"website": "https://www.example.com"
},
{
"category": "Distributor",
"custom_data": [
{
"id": 33,
"name": "Custom Field 2",
"value": null
}
],
"default_email": "company-206@example.com",
"default_purchase_order_notes": null,
"default_sales_order_notes": null,
"group": null,
"id": "00000000-0000-0000-0000-000000000900",
"invoice_email": null,
"legal_business_name": "Company Legal Name 82",
"licenses": [
{
"id": "00000000-0000-0000-0000-00000000016a",
"license_number": "CDPH-00000017"
}
],
"locations": [],
"name": "Company 82",
"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
}
],
"next_page": 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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiOWFmOTg4MDYtYmQ5NC00MWUzLTgyMTEtNTQ5MTZjMTQzZjViIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzM3NCIsInR5cCI6ImFjY2VzcyJ9.vaTMqmuGPGqox34H8RKhwiTjfnDBPO58SCDew8StdKY
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: ce54b5082d4fc8000000000000000001-bb6140b265b0a80f-0
{
"data": [
{
"company": {
"id": "00000000-0000-0000-0000-0000000008f0"
},
"custom_data": [
{
"id": 32,
"name": "Custom Field 1",
"value": "Custom Data 1"
}
],
"email": "email1",
"full_name": "FirstName180 LastName181",
"id": "00000000-0000-0000-0000-000000000037",
"owner": {
"id": "00000000-0000-0000-0000-000000000d34"
},
"phone_number": "1234567890",
"title": null
},
{
"company": {
"id": "00000000-0000-0000-0000-0000000008f4"
},
"custom_data": [
{
"id": 32,
"name": "Custom Field 1",
"value": null
}
],
"email": "email2",
"full_name": "FirstName182 LastName185",
"id": "00000000-0000-0000-0000-000000000038",
"owner": {
"id": "00000000-0000-0000-0000-000000000d38"
},
"phone_number": "1234567890",
"title": null
}
],
"next_page": 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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOGVhNjFhY2MtZDZjMi00MzIwLWE3OTAtOTg4YTA1Zjk4YTBiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU0NiIsInR5cCI6ImFjY2VzcyJ9.ZH_mcO8Dae9tLQey2e4IAFjR7pIjPEF5DltJwBdjasI
{
"file": {
"content_type": "image/png",
"filename": "test-image.png"
},
"name": "My Test Image",
"product_id": "bc9b320d-c8c2-4e02-af57-50df4bd88c30"
}
Response
201
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 2a87f9fb89307e000000000000000001-95eea755c82fbbf5-0
{
"data": {
"assembly_id": null,
"batch_id": null,
"company_relationship_id": null,
"contact_id": null,
"id": "00000000-0000-0000-0000-00000000003f",
"invoice_id": null,
"license_id": null,
"mime_type": "image/png",
"name": "My Test Image",
"order_id": null,
"order_shipment_id": null,
"product_id": "bc9b320d-c8c2-4e02-af57-50df4bd88c30",
"purchase_id": null,
"request_id": null,
"return_id": null,
"size_in_bytes": 355974,
"stock_transfer_id": null,
"task_id": null,
"upload_datetime": "2025-09-17T15:12:38.048283Z",
"uploader": {
"id": "00000000-0000-0000-0000-000000000dda",
"name": "FirstName560 LastName561"
},
"url": "/var/folders/1_/9xjqcx314hl9sqvhtzs__tx80000gn/T/e1dd1639-d4b7-4563-a04c-48505f37fd5c/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 | Default | 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[]=5d50af30-f21b-487b-9486-4900742ed076
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTJiZDFkNjItOWZhZi00Y2JmLTg0YmQtYzg5ODE5ZjU1MjEwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzcxNyIsInR5cCI6ImFjY2VzcyJ9.ZN1cXQImGu8d94aHJYQWzGZoB8CPBeNR_xvEDEMeYfk
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 9b9ce2da036878000000000000000001-2dce06732acc4eb4-0
{
"data": [
{
"active": "10.000000000",
"available": "10.000000000",
"product_id": "5d50af30-f21b-487b-9486-4900742ed076",
"updated_datetime": "2025-09-17T15:12:38.663656Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZmE5YTkxNmEtNWQ3NS00ZDY4LWE2ZWYtMDc5ZDNkMzkxODM1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzQ0NCIsInR5cCI6ImFjY2VzcyJ9.wk82QWMNgW1jzXgC_5zy0Miir-_wsAeM0-Gf3C43Ggw
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 04e17c0e1042c9000000000000000001-80c58645f24992f4-0
{
"data": [
{
"active": "50.000000000",
"available": "50.000000000",
"product_id": "64c6325f-214d-4fd9-b517-b9bc39120924",
"updated_datetime": "2023-11-05T00:00:00.000000Z"
},
{
"active": "100.000000000",
"available": "90.000000000",
"product_id": "7c362861-3911-44b3-b0f1-080007361b8e",
"updated_datetime": "2023-12-03T00:00:00.000000Z"
},
{
"active": "95.000000000",
"available": "80.000000000",
"product_id": "c45ef6de-5ca7-4c95-9802-cec488185ce6",
"updated_datetime": "2023-11-06T00:00:00.000000Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGMzNGM0OWYtYzdhMC00OWVkLThlYmMtMGZiMGUyOTg5Yjk2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzg3NCIsInR5cCI6ImFjY2VzcyJ9.lJ_u_SrokODByTVDRPeRdFrzwNhEyMcb7A2QVeW0hD0
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: c2d989382a3110000000000000000001-486744ae2c7913fc-0
{
"data": [
{
"active": "100.000000000",
"available": "90.000000000",
"location_id": "00000000-0000-0000-0000-000000000453",
"product_id": "8154e9ae-1e23-49ad-a7f3-39270eeda5e7",
"updated_datetime": "2030-10-01T00:00:00.000000Z"
},
{
"active": "0.000000000",
"available": "-1.000000000",
"location_id": "00000000-0000-0000-0000-000000000455",
"product_id": "8154e9ae-1e23-49ad-a7f3-39270eeda5e7",
"updated_datetime": "2030-10-02T00:00:00.000000Z"
},
{
"active": "100.000000000",
"available": "85.000000000",
"location_id": "00000000-0000-0000-0000-000000000453",
"product_id": "a39de981-bdc8-469d-b75c-8910445b0ff2",
"updated_datetime": "2030-10-03T00:00:00.000000Z"
},
{
"active": "90.000000000",
"available": "82.000000000",
"location_id": "00000000-0000-0000-0000-000000000455",
"product_id": "a39de981-bdc8-469d-b75c-8910445b0ff2",
"updated_datetime": "2030-10-04T00:00:00.000000Z"
},
{
"active": "150.000000000",
"available": "129.000000000",
"location_id": "00000000-0000-0000-0000-000000000456",
"product_id": "a39de981-bdc8-469d-b75c-8910445b0ff2",
"updated_datetime": "2030-10-05T00:00:00.000000Z"
},
{
"active": "0.000000000",
"available": "-1.000000000",
"location_id": null,
"product_id": "a39de981-bdc8-469d-b75c-8910445b0ff2",
"updated_datetime": "2030-10-08T00:00:00.000000Z"
},
{
"active": "100.000000000",
"available": "100.000000000",
"location_id": "00000000-0000-0000-0000-000000000455",
"product_id": "fe963bd2-da4b-471a-a832-20fded3257b1",
"updated_datetime": "2030-09-01T00:00:00.000000Z"
},
{
"active": "30.000000000",
"available": "26.000000000",
"location_id": null,
"product_id": "fe963bd2-da4b-471a-a832-20fded3257b1",
"updated_datetime": "2030-10-07T00:00:00.000000Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTYsImlhdCI6MTc1ODEyMTk1NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOWZjYjMzYTEtN2FmMC00MDI4LWI2ZTgtNjEyNmE1YTNiNzg5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzMwNSIsInR5cCI6ImFjY2VzcyJ9.iuqEUtFvQDlyWV_DISDcqKVCduIg34fHhHgzYTSr8Sg
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 17b969b9426e8c000000000000000001-0191625a49211069-0
{
"data": [
{
"active": "8.000000000",
"available": "8.000000000",
"batch_number": "TEST-1",
"product_id": "10486866-c77c-4eb0-a867-8556c1a825b5",
"updated_datetime": "2030-09-01T00:00:00.000000Z"
},
{
"active": "43.000000000",
"available": "43.000000000",
"batch_number": null,
"product_id": "2207b7c6-870e-4089-b325-4f68a5aa1226",
"updated_datetime": "2030-11-02T00:00:00.000000Z"
},
{
"active": "47.000000000",
"available": "47.000000000",
"batch_number": "1",
"product_id": "2207b7c6-870e-4089-b325-4f68a5aa1226",
"updated_datetime": "2030-11-04T00:00:00.000000Z"
},
{
"active": "25.000000000",
"available": "25.000000000",
"batch_number": "2",
"product_id": "2207b7c6-870e-4089-b325-4f68a5aa1226",
"updated_datetime": "2030-11-05T00:00:00.000000Z"
},
{
"active": "19.000000000",
"available": "19.000000000",
"batch_number": null,
"product_id": "a2b59fdf-0b42-48bc-8375-76ae96700556",
"updated_datetime": "2030-10-02T00:00:00.000000Z"
},
{
"active": "13.000000000",
"available": "13.000000000",
"batch_number": "TEST-1",
"product_id": "a2b59fdf-0b42-48bc-8375-76ae96700556",
"updated_datetime": "2030-10-04T00:00:00.000000Z"
},
{
"active": "26.000000000",
"available": "26.000000000",
"batch_number": null,
"product_id": "d76d4ab9-7616-40f8-aa9d-c50671211b5a",
"updated_datetime": "2030-12-01T00:00:00.000000Z"
},
{
"active": "27.000000000",
"available": "27.000000000",
"batch_number": "1",
"product_id": "d76d4ab9-7616-40f8-aa9d-c50671211b5a",
"updated_datetime": "2030-12-02T00:00:00.000000Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTlmZGRkMTktMmZhMy00Mzc2LTk5ZGYtYWZlMDI1YTAwMDgwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA3OCIsInR5cCI6ImFjY2VzcyJ9.sHafZEc7P7eBCASPjOnUxQJMkSc0JKiYDUMcHoqSDMc
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 73dfa33691e318000000000000000001-04c820e8e6fb7244-0
{
"data": [
{
"active": "41.000000000",
"available": "41.000000000",
"batch_number": null,
"location_id": "00000000-0000-0000-0000-000000000492",
"product_id": "45513ae7-4bc4-4a4e-b142-f37f86da8e30",
"updated_datetime": "2031-01-02T00:00:00.000000Z"
},
{
"active": "49.000000000",
"available": "49.000000000",
"batch_number": "TEST-1",
"location_id": "00000000-0000-0000-0000-000000000492",
"product_id": "45513ae7-4bc4-4a4e-b142-f37f86da8e30",
"updated_datetime": "2031-02-02T00:00:00.000000Z"
},
{
"active": "45.000000000",
"available": "45.000000000",
"batch_number": null,
"location_id": "00000000-0000-0000-0000-000000000494",
"product_id": "45513ae7-4bc4-4a4e-b142-f37f86da8e30",
"updated_datetime": "2031-01-04T00:00:00.000000Z"
},
{
"active": "53.000000000",
"available": "53.000000000",
"batch_number": "TEST-1",
"location_id": "00000000-0000-0000-0000-000000000494",
"product_id": "45513ae7-4bc4-4a4e-b142-f37f86da8e30",
"updated_datetime": "2031-02-04T00:00:00.000000Z"
},
{
"active": "21.000000000",
"available": "21.000000000",
"batch_number": null,
"location_id": "00000000-0000-0000-0000-000000000492",
"product_id": "bcfe3da5-e779-4dbb-9e8e-e11249b7e38d",
"updated_datetime": "2030-11-02T00:00:00.000000Z"
},
{
"active": "29.000000000",
"available": "29.000000000",
"batch_number": "TEST-1",
"location_id": "00000000-0000-0000-0000-000000000492",
"product_id": "bcfe3da5-e779-4dbb-9e8e-e11249b7e38d",
"updated_datetime": "2030-12-02T00:00:00.000000Z"
},
{
"active": "25.000000000",
"available": "25.000000000",
"batch_number": null,
"location_id": "00000000-0000-0000-0000-000000000494",
"product_id": "bcfe3da5-e779-4dbb-9e8e-e11249b7e38d",
"updated_datetime": "2030-11-04T00:00:00.000000Z"
},
{
"active": "33.000000000",
"available": "33.000000000",
"batch_number": "TEST-1",
"location_id": "00000000-0000-0000-0000-000000000494",
"product_id": "bcfe3da5-e779-4dbb-9e8e-e11249b7e38d",
"updated_datetime": "2030-12-04T00:00:00.000000Z"
}
],
"next_page": null
}
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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjIsImlhdCI6MTc1ODEyMTk2MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODMyZjRjMzgtMzQyNy00NWI5LTk3YTUtNDMyNDQyMmU1YmU5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDQwOCIsInR5cCI6ImFjY2VzcyJ9.6OgGUEorH-fyYdvpIsMroQS26_bd9lrMqgU1X2DNwmM
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 06c7b38e3c24c6400000000000000001-61af0c24b9690eb5-0
{
"data": [
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000b70",
"name": "Company 932",
"updated_datetime": "2025-09-17T15:12:42.463832Z"
},
"creator": {
"banned": false,
"email": "owner-1113@example.com",
"full_name": "FirstName2280 LastName2281",
"id": "00000000-0000-0000-0000-000000001146",
"role": {
"id": "00000000-0000-0000-0000-0000000010b7",
"name": "Admin 1092"
}
},
"custom_data": [
{
"id": 43,
"name": "Custom Field 12",
"value": null
}
],
"due_datetime": "2025-09-17T15:12:42.590263Z",
"id": "00000000-0000-0000-0000-000000000099",
"inserted_datetime": "2025-09-17T15:12:42.591116Z",
"invoice_datetime": "2025-09-17T15:12:42.590262Z",
"invoice_number": "Invoice #19",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000096b",
"name": "B1632"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000ef",
"order_item_id": "d46b6551-6044-4eb0-a7f4-6b68d389de0a",
"package": null,
"price": "10.000000000",
"product": {
"id": "d31cea70-e81c-4008-aab7-a8a8c817a7bd",
"name": "Product 1630",
"sku": "sku 1631",
"updated_datetime": "2025-09-17T15:12:42.473153Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000096c",
"name": "B1635"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000f0",
"order_item_id": "b07075a6-e071-43af-b7f2-b9934c00ca0b",
"package": null,
"price": "10.000000000",
"product": {
"id": "971b7e53-46cd-443a-9802-48cbf698c24a",
"name": "Product 1633",
"sku": "sku 1634",
"updated_datetime": "2025-09-17T15:12:42.484016Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
}
],
"order": {
"id": "23dffe67-038b-47d7-a1d4-f6f1d88c6fa1",
"order_number": "SO-41",
"status": "Pending",
"total": "320.00"
},
"owner": {
"banned": false,
"email": "owner-1113@example.com",
"full_name": "FirstName2280 LastName2281",
"id": "00000000-0000-0000-0000-000000001146",
"role": {
"id": "00000000-0000-0000-0000-0000000010b7",
"name": "Admin 1092"
}
},
"paid_amount": "0.0",
"status": "NOT_PAID",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:42.591116Z"
},
{
"charges": [
{
"id": "f9587bc8-899a-4997-95e3-752162e4c19b",
"name": "C1",
"percent": "10.0000",
"price": "1.00",
"type": "CHARGE",
"unit_type": "PERCENT"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000b6a",
"name": "Company 923",
"updated_datetime": "2025-09-17T15:12:42.369749Z"
},
"creator": {
"banned": false,
"email": "user1@a.com",
"full_name": "John Foo",
"id": "00000000-0000-0000-0000-000000001133",
"role": {
"id": "00000000-0000-0000-0000-0000000010a5",
"name": "Admin 1074"
}
},
"custom_data": [
{
"id": 43,
"name": "Custom Field 12",
"value": "Custom Field Value 1"
}
],
"due_datetime": "2020-01-01T00:00:01.000000Z",
"id": "00000000-0000-0000-0000-000000000098",
"inserted_datetime": "2025-09-17T15:12:42.390434Z",
"invoice_datetime": "2020-01-01T00:00:02.000000Z",
"invoice_number": "INV-123",
"items": [
{
"batch": {
"batch_number": "UID1",
"id": "00000000-0000-0000-0000-000000000963",
"name": "B1"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000ee",
"order_item_id": "affc53d5-c6f2-4a03-b449-143e22c5c6bb",
"package": {
"batch_number": "B1",
"compliance_label": "ABCDEF012345670000000161",
"id": "00000000-0000-0000-0000-000000000109",
"metrc_label": "ABCDEF012345670000000161",
"status": "active"
},
"price": "10.000000000",
"product": {
"id": "7d4fbc08-3376-4dff-b436-84537d4161b5",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:42.347307Z"
},
"quantity": "1.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
}
],
"order": {
"id": "020b24a1-ac41-4cc0-9938-e5ed52c15644",
"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-000000001136",
"role": {
"id": "00000000-0000-0000-0000-0000000010a8",
"name": "Admin 1077"
}
},
"paid_amount": "5.00",
"status": "PARTIALLY_PAID",
"total": "8.00",
"updated_datetime": "2025-09-17T15:12:42.415625Z"
}
],
"next_page": null
}
GET /invoices/ returns cost/returned_quantity data for invoice items
GET /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjQsImlhdCI6MTc1ODEyMTk2NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYmUwYWUwZTgtN2M5MS00NDI5LTkxYzctNmZkOTZiOTFkNmVkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDY2NCIsInR5cCI6ImFjY2VzcyJ9.wUH0GTsXXKNAqRepo6bYiK7vFvQfEFwDELq001UbEkc
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: f8116042d27650000000000000000001-d48b67553925fdec-0
{
"data": [
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000c32",
"name": "Company 1157",
"updated_datetime": "2025-09-17T15:12:44.400782Z"
},
"creator": {
"banned": false,
"email": "owner-1360@example.com",
"full_name": "FirstName2774 LastName2775",
"id": "00000000-0000-0000-0000-000000001246",
"role": {
"id": "00000000-0000-0000-0000-0000000011ae",
"name": "Admin 1339"
}
},
"custom_data": [],
"due_datetime": "2025-09-17T15:12:44.523625Z",
"id": "00000000-0000-0000-0000-0000000000b0",
"inserted_datetime": "2025-09-17T15:12:44.524070Z",
"invoice_datetime": "2025-09-17T15:12:44.523624Z",
"invoice_number": "Invoice #42",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009f9",
"name": "B2062"
},
"cost_per_unit": "10.026",
"cost_per_unit_default": "5",
"id": "00000000-0000-0000-0000-000000000109",
"order_item_id": "30704ae7-05d8-4eef-8a65-7fb9c3258c6f",
"package": null,
"price": "172619.000000000",
"product": {
"id": "da007962-fad5-4253-9243-a0f33e83c93b",
"name": "Product 2060",
"sku": "sku 2061",
"updated_datetime": "2025-09-17T15:12:44.339142Z"
},
"quantity": "2.000000000",
"returned_quantity": "2",
"total_cost_actual": "20.052",
"total_cost_default": "10"
}
],
"order": {
"id": "2b277951-51a1-4d08-bfa3-800f97bf8d7e",
"order_number": "SO-0000001",
"status": "Processing",
"total": "345238.00"
},
"owner": {
"banned": false,
"email": "owner-1360@example.com",
"full_name": "FirstName2774 LastName2775",
"id": "00000000-0000-0000-0000-000000001246",
"role": {
"id": "00000000-0000-0000-0000-0000000011ae",
"name": "Admin 1339"
}
},
"paid_amount": "0.0",
"status": "NOT_PAID",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:44.524070Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTdiNGM1MmItZDg5OS00NTllLWFkYjEtYjFkYzg3ZDE2YTY5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc3MiIsInR5cCI6ImFjY2VzcyJ9.hIL4Um2uSQ5szTNf-dr9-eHw3f0iylWP6ehqe2t6RhA
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: c5bac6f2184070000000000000000001-84185183c3ee863f-0
{
"data": [
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-0000000009f8",
"name": "Company 467",
"updated_datetime": "2025-09-17T15:12:39.632587Z"
},
"creator": {
"banned": false,
"email": "owner-618@example.com",
"full_name": "FirstName1288 LastName1289",
"id": "00000000-0000-0000-0000-000000000f49",
"role": {
"id": "00000000-0000-0000-0000-000000000eda",
"name": "Admin 615"
}
},
"custom_data": [],
"due_datetime": "2025-09-17T15:12:39.816472Z",
"id": "00000000-0000-0000-0000-000000000088",
"inserted_datetime": "2025-09-17T15:12:39.817734Z",
"invoice_datetime": "2020-01-01T12:30:00.000000Z",
"invoice_number": "Invoice #4",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000823",
"name": "B659"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000d0",
"order_item_id": "c6687c39-5321-4ae0-a732-97c1cdcb559b",
"package": null,
"price": "10.000000000",
"product": {
"id": "17ad5689-39cb-42a0-ab04-685960111324",
"name": "Product 656",
"sku": "sku 657",
"updated_datetime": "2025-09-17T15:12:39.660492Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000829",
"name": "B670"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000d1",
"order_item_id": "67317026-c543-4fdf-b3ec-75f209e21a95",
"package": null,
"price": "10.000000000",
"product": {
"id": "ad924da7-94be-49f1-a802-e4bd2821f87e",
"name": "Product 668",
"sku": "sku 669",
"updated_datetime": "2025-09-17T15:12:39.682022Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
}
],
"order": {
"id": "bff0ac24-f283-476a-bde7-2ab273d3322c",
"order_number": "SO-10",
"status": "Pending",
"total": "320.00"
},
"owner": {
"banned": false,
"email": "owner-618@example.com",
"full_name": "FirstName1288 LastName1289",
"id": "00000000-0000-0000-0000-000000000f49",
"role": {
"id": "00000000-0000-0000-0000-000000000eda",
"name": "Admin 615"
}
},
"paid_amount": "0.0",
"status": "NOT_PAID",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:39.817734Z"
},
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-0000000009e4",
"name": "Company 437",
"updated_datetime": "2025-09-17T15:12:39.344627Z"
},
"creator": {
"banned": false,
"email": "owner-570@example.com",
"full_name": "FirstName1192 LastName1193",
"id": "00000000-0000-0000-0000-000000000f18",
"role": {
"id": "00000000-0000-0000-0000-000000000eab",
"name": "Admin 568"
}
},
"custom_data": [],
"due_datetime": "2025-09-17T15:12:39.571639Z",
"id": "00000000-0000-0000-0000-000000000087",
"inserted_datetime": "2025-09-17T15:12:39.574307Z",
"invoice_datetime": "2020-01-01T12:20:00.000000Z",
"invoice_number": "Invoice #3",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000080f",
"name": "B605"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000ce",
"order_item_id": "7d07efe7-87ac-409b-bc3d-294d9bf69109",
"package": null,
"price": "10.000000000",
"product": {
"id": "bac15eaa-1189-4f42-a20a-213a40e6d498",
"name": "Product 603",
"sku": "sku 604",
"updated_datetime": "2025-09-17T15:12:39.376248Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000811",
"name": "B609"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000cf",
"order_item_id": "1f3772c2-bb2e-4c18-8666-16ef9cb991f8",
"package": null,
"price": "10.000000000",
"product": {
"id": "c10e9a65-7494-4fce-90e4-0c10dab80f27",
"name": "Product 607",
"sku": "sku 608",
"updated_datetime": "2025-09-17T15:12:39.427263Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
}
],
"order": {
"id": "e1b6d118-2e1e-497a-98eb-9594db8da126",
"order_number": "SO-8",
"status": "Pending",
"total": "320.00"
},
"owner": {
"banned": false,
"email": "owner-570@example.com",
"full_name": "FirstName1192 LastName1193",
"id": "00000000-0000-0000-0000-000000000f18",
"role": {
"id": "00000000-0000-0000-0000-000000000eab",
"name": "Admin 568"
}
},
"paid_amount": "0.0",
"status": "FULLY_PAID",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:39.574307Z"
},
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-0000000009bd",
"name": "Company 381",
"updated_datetime": "2025-09-17T15:12:38.890624Z"
},
"creator": {
"banned": false,
"email": "owner-482@example.com",
"full_name": "FirstName1014 LastName1015",
"id": "00000000-0000-0000-0000-000000000ebe",
"role": {
"id": "00000000-0000-0000-0000-000000000e50",
"name": "Admin 477"
}
},
"custom_data": [],
"due_datetime": "2025-09-17T15:12:38.986369Z",
"id": "00000000-0000-0000-0000-000000000085",
"inserted_datetime": "2025-09-17T15:12:38.987778Z",
"invoice_datetime": "2020-01-01T12:00:00.000000Z",
"invoice_number": "Invoice #1",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000007ec",
"name": "B488"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000ca",
"order_item_id": "25e28ea1-8841-415a-ac7d-f3f17f202398",
"package": null,
"price": "10.000000000",
"product": {
"id": "e142ff71-086d-4d35-8f67-db59599104b4",
"name": "Product 486",
"sku": "sku 487",
"updated_datetime": "2025-09-17T15:12:38.904648Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000007ee",
"name": "B492"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000cb",
"order_item_id": "afba7e83-a959-4655-a99b-42534345e50e",
"package": null,
"price": "10.000000000",
"product": {
"id": "2dc0cc4b-f8dd-4592-a0f5-c0e7915af769",
"name": "Product 490",
"sku": "sku 491",
"updated_datetime": "2025-09-17T15:12:38.920192Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
}
],
"order": {
"id": "ee31e632-d9e1-4c5d-ba8b-bebc3ae05ad3",
"order_number": "SO-5",
"status": "Pending",
"total": "320.00"
},
"owner": {
"banned": false,
"email": "owner-482@example.com",
"full_name": "FirstName1014 LastName1015",
"id": "00000000-0000-0000-0000-000000000ebe",
"role": {
"id": "00000000-0000-0000-0000-000000000e50",
"name": "Admin 477"
}
},
"paid_amount": "0.0",
"status": "FULLY_PAID",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:38.987778Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjEsImlhdCI6MTc1ODEyMTk2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGE2MzEzNWItZWU5Ni00YzgxLTg4YTgtMTRiZGFjMGUyNjBlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDI3MiIsInR5cCI6ImFjY2VzcyJ9.NdVK8hTE8avxbaBhsMxlBa1xrcjGJFYxh7_-_jt4sPk
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 38f0c03f5daf40000000000000000001-0855a74f4e31597e-0
{
"data": [
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000aee",
"name": "Company 784",
"updated_datetime": "2025-09-17T15:12:41.566678Z"
},
"creator": {
"banned": false,
"email": "owner-990@example.com",
"full_name": "FirstName2034 LastName2035",
"id": "00000000-0000-0000-0000-0000000010c6",
"role": {
"id": "00000000-0000-0000-0000-000000001046",
"name": "Admin 979"
}
},
"custom_data": [],
"due_datetime": "2025-09-17T15:12:41.665752Z",
"id": "00000000-0000-0000-0000-000000000091",
"inserted_datetime": "2025-09-17T15:12:41.666236Z",
"invoice_datetime": "2025-09-17T15:12:41.665751Z",
"invoice_number": "Invoice #12",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000906",
"name": "B1331"
},
"cost_per_unit": "10.026",
"cost_per_unit_default": "5",
"id": "00000000-0000-0000-0000-0000000000e3",
"order_item_id": "487d62e1-09c8-452f-a5eb-e6757c16b2fa",
"package": null,
"price": "308745.000000000",
"product": {
"id": "fb919bf5-0a65-483c-9d76-34c423f6c002",
"name": "Product 1329",
"sku": "sku 1330",
"updated_datetime": "2025-09-17T15:12:41.519304Z"
},
"quantity": "1.000000000",
"returned_quantity": "1",
"total_cost_actual": "10.026",
"total_cost_default": "5"
}
],
"order": {
"id": "34ad9ba6-7fe2-4262-adbf-ca76af98fd82",
"order_number": "SO-0000001",
"status": "Processing",
"total": "617490.00"
},
"owner": {
"banned": false,
"email": "owner-990@example.com",
"full_name": "FirstName2034 LastName2035",
"id": "00000000-0000-0000-0000-0000000010c6",
"role": {
"id": "00000000-0000-0000-0000-000000001046",
"name": "Admin 979"
}
},
"paid_amount": "0.0",
"status": "NOT_PAID",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:41.666236Z"
}
],
"next_page": null
}
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 | Default | 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-00000000009b/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjIsImlhdCI6MTc1ODEyMTk2MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGNkN2I2MzEtOGViZC00NzJkLWJkZjUtMzkyYjYwNTJmNTY1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDQzOSIsInR5cCI6ImFjY2VzcyJ9.qUlvbHoxl4cpg_jyCanj4vHue8bb5qATcxJYKB2sb-U
{
"amount": 100.01,
"description": "Payment for invoice",
"payment_datetime": "2020-01-01T00:00:00.000000Z",
"payment_method_id": "00000000-0000-0000-0000-000000000021",
"quickbooks_deposit_account_id": "QBD-123"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 17838493c74f1e000000000000000001-15b9cc17de4a8549-0
{
"data": {
"amount": "100.01",
"description": "Payment for invoice",
"id": "00000000-0000-0000-0000-00000000000b",
"inserted_datetime": "2025-09-17T15:12:42.694678Z",
"invoice_id": "00000000-0000-0000-0000-00000000009b",
"payment_date": "2020-01-01T00:00:00.000000Z",
"payment_method": {
"id": "00000000-0000-0000-0000-000000000021",
"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-00000000009b/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjIsImlhdCI6MTc1ODEyMTk2MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGNkN2I2MzEtOGViZC00NzJkLWJkZjUtMzkyYjYwNTJmNTY1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDQzOSIsInR5cCI6ImFjY2VzcyJ9.qUlvbHoxl4cpg_jyCanj4vHue8bb5qATcxJYKB2sb-U
{
"amount": 100.01,
"description": "Payment for invoice",
"payment_datetime": "2020-01-01T00:00:00.000000Z",
"payment_method_id": "00000000-0000-0000-0000-000000000021",
"quickbooks_deposit_account_name": "QBD-NAME"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 17838493c74f1e000000000000000001-48bc12006a467475-0
{
"data": {
"amount": "100.01",
"description": "Payment for invoice",
"id": "00000000-0000-0000-0000-00000000000c",
"inserted_datetime": "2025-09-17T15:12:42.745817Z",
"invoice_id": "00000000-0000-0000-0000-00000000009b",
"payment_date": "2020-01-01T00:00:00.000000Z",
"payment_method": {
"id": "00000000-0000-0000-0000-000000000021",
"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 | Default | Example |
---|---|---|---|---|---|---|
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-00000000008a
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiN2E3MjM5NDgtNDE0MS00ODhiLTg2NTEtYTA1ZDNiNmI5M2RkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDAwMyIsInR5cCI6ImFjY2VzcyJ9.T0Rxa1UgxmOVen_BBBSn0aQgHs4IXCVGi_5IdGBlW8s
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: da3731bad7e090000000000000000001-7b8c70e26f170d12-0
{
"data": {
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000a43",
"name": "Company 564",
"updated_datetime": "2025-09-17T15:12:40.106825Z"
},
"creator": {
"banned": false,
"email": "owner-710@example.com",
"full_name": "FirstName1474 LastName1475",
"id": "00000000-0000-0000-0000-000000000fa5",
"role": {
"id": "00000000-0000-0000-0000-000000000f34",
"name": "Admin 705"
}
},
"custom_data": [
{
"id": 38,
"name": "Custom Field 7",
"value": "Custom Field Value 1"
}
],
"due_datetime": "2025-09-17T15:12:40.213617Z",
"id": "00000000-0000-0000-0000-00000000008a",
"inserted_datetime": "2025-09-17T15:12:40.214656Z",
"invoice_datetime": "2025-09-17T15:12:40.213615Z",
"invoice_number": "Invoice #6",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000862",
"name": "B853"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000d4",
"order_item_id": "42fcb2b8-d874-41ac-b6aa-e0580ed7b927",
"package": null,
"price": "10.000000000",
"product": {
"id": "0effe5ac-4cf9-4de0-b224-93c97f536759",
"name": "Product 849",
"sku": "sku 850",
"updated_datetime": "2025-09-17T15:12:40.119723Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000867",
"name": "B872"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000d5",
"order_item_id": "bc237b15-bc45-41df-a8e3-9ff695db171b",
"package": null,
"price": "10.000000000",
"product": {
"id": "ca51fffe-58a2-4915-8eeb-080877546ec3",
"name": "Product 867",
"sku": "sku 868",
"updated_datetime": "2025-09-17T15:12:40.136829Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
}
],
"order": {
"id": "0bef2595-7a7b-4303-8bd3-798372c9415e",
"order_number": "SO-15",
"status": "Pending",
"total": "320.00"
},
"owner": {
"banned": false,
"email": "owner-710@example.com",
"full_name": "FirstName1474 LastName1475",
"id": "00000000-0000-0000-0000-000000000fa5",
"role": {
"id": "00000000-0000-0000-0000-000000000f34",
"name": "Admin 705"
}
},
"paid_amount": "0.0",
"status": "NOT_PAID",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:40.214656Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjQsImlhdCI6MTc1ODEyMTk2NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNWY5MmM3NWEtZDQ4Mi00NWE3LWIwZGUtYzY5YWQ0ZTk1ODczIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDcxOCIsInR5cCI6ImFjY2VzcyJ9.xbSWqwTZYukBsjTNGEt6ot-5E3QyfywHkyfl54OXF24
{
"billing_location_id": "00000000-0000-0000-0000-000000000588",
"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": "941847a2-4acb-4abc-b611-db14103eaf5a",
"quantity": "1.000000000"
},
{
"order_item_id": "d96b244a-c68c-44c3-b960-17ec0e9c9c39",
"quantity": "10.000000000"
}
],
"order_id": "841ed52f-7593-48d1-b7c2-3f78680b237f"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: df7ca4c62de6a8000000000000000001-a368ca45a92a1319-0
{
"data": {
"charges": [
{
"id": "ef300e60-5c24-4b82-969d-4094653a0fc2",
"name": "C1",
"percent": "10.0000",
"price": "5.30",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "1def3c04-a02b-405b-8eb5-5e0621146920",
"name": "C2",
"percent": null,
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000c59",
"name": "Company 1201",
"updated_datetime": "2025-09-17T15:12:44.929146Z"
},
"creator": {
"banned": false,
"email": "user1@a.com",
"full_name": "John Foo",
"id": "00000000-0000-0000-0000-00000000126e",
"role": {
"id": "00000000-0000-0000-0000-0000000011d6",
"name": "Admin 1379"
}
},
"custom_data": [],
"due_datetime": "2020-01-30T00:00:01.000000Z",
"id": "00000000-0000-0000-0000-0000000000b5",
"inserted_datetime": "2025-09-17T15:12:44.999633Z",
"invoice_datetime": "2020-01-01T00:00:00.000000Z",
"invoice_number": "INV-0000001",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000a14",
"name": "B1"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-000000000112",
"order_item_id": "941847a2-4acb-4abc-b611-db14103eaf5a",
"package": null,
"price": "3.000000000",
"product": {
"id": "84233245-f4bd-4275-a6d6-72d217e8cf41",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:44.942727Z"
},
"quantity": "1.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000a15",
"name": "B2"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-000000000113",
"order_item_id": "d96b244a-c68c-44c3-b960-17ec0e9c9c39",
"package": null,
"price": "5.000000000",
"product": {
"id": "7d807d6f-2dca-4ac1-912b-006ebb4260bf",
"name": "P2",
"sku": "SKU2",
"updated_datetime": "2025-09-17T15:12:44.954010Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
}
],
"order": {
"id": "841ed52f-7593-48d1-b7c2-3f78680b237f",
"order_number": "SO-86",
"status": "Processing",
"total": "0.00"
},
"owner": null,
"paid_amount": "0.0",
"status": "NOT_PAID",
"total": "53.30",
"updated_datetime": "2025-09-17T15:12:45.004571Z"
}
}
POST /invoices updates an invoice
POST /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjEsImlhdCI6MTc1ODEyMTk2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNmQ0YzI3MWEtMzM1Yi00NmUxLTkyM2MtMzBiYzc0YzAyOTI2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDIyOSIsInR5cCI6ImFjY2VzcyJ9.QO8jTUuGys4n6HjU_JRXoG2ztRMcLTUeG9iNwYgmp0g
{
"billing_location_id": "00000000-0000-0000-0000-0000000004cd",
"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": "8879407c-aaf5-435b-a89d-69f8dee74e15",
"quantity": "1.000000000"
},
{
"order_item_id": "8bea0405-d250-4ac5-9cde-f0758a2dcb06",
"quantity": "10.000000000"
}
],
"order_id": "4bce6613-dedf-431f-862f-3e4ba445c1e0"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 01cdf2d2a95bad600000000000000001-ee0c49d3884731df-0
{
"data": {
"charges": [
{
"id": "19e955e1-7262-4f38-9e8d-bf28d640d2d1",
"name": "C1",
"percent": "10.0000",
"price": "5.30",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "925ad5f5-f161-4b62-91ef-2f842f66182f",
"name": "C2",
"percent": null,
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000ac3",
"name": "Company 734",
"updated_datetime": "2025-09-17T15:12:41.202165Z"
},
"creator": {
"banned": false,
"email": "user1@a.com",
"full_name": "John Foo",
"id": "00000000-0000-0000-0000-000000001085",
"role": {
"id": "00000000-0000-0000-0000-00000000100c",
"name": "Admin 921"
}
},
"custom_data": [],
"due_datetime": "2020-01-30T00:00:01.000000Z",
"id": "00000000-0000-0000-0000-000000000090",
"inserted_datetime": "2025-09-17T15:12:41.255982Z",
"invoice_datetime": "2020-01-01T00:00:00.000000Z",
"invoice_number": "INV-0000001",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008ea",
"name": "B1"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000e0",
"order_item_id": "8879407c-aaf5-435b-a89d-69f8dee74e15",
"package": null,
"price": "3.000000000",
"product": {
"id": "1eaae632-ac02-4067-8af3-ec189f2395c5",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:41.217624Z"
},
"quantity": "1.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008eb",
"name": "B2"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000e1",
"order_item_id": "8bea0405-d250-4ac5-9cde-f0758a2dcb06",
"package": null,
"price": "5.000000000",
"product": {
"id": "d97d3871-eb44-4bb8-9558-067756d2a18c",
"name": "P2",
"sku": "SKU2",
"updated_datetime": "2025-09-17T15:12:41.227191Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
}
],
"order": {
"id": "4bce6613-dedf-431f-862f-3e4ba445c1e0",
"order_number": "SO-24",
"status": "Processing",
"total": "0.00"
},
"owner": null,
"paid_amount": "0.0",
"status": "NOT_PAID",
"total": "53.30",
"updated_datetime": "2025-09-17T15:12:41.261949Z"
}
}
POST /invoices updates an invoice
POST /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjEsImlhdCI6MTc1ODEyMTk2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNmQ0YzI3MWEtMzM1Yi00NmUxLTkyM2MtMzBiYzc0YzAyOTI2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDIyOSIsInR5cCI6ImFjY2VzcyJ9.QO8jTUuGys4n6HjU_JRXoG2ztRMcLTUeG9iNwYgmp0g
{
"billing_location_id": "00000000-0000-0000-0000-0000000004ce",
"charges": [
{
"id": "19e955e1-7262-4f38-9e8d-bf28d640d2d1",
"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-000000000090",
"invoice_datetime": "2020-01-02T00:00:00.000000Z",
"items": [
{
"id": "00000000-0000-0000-0000-0000000000e0",
"order_item_id": "8879407c-aaf5-435b-a89d-69f8dee74e15",
"quantity": "1.000000000"
},
{
"order_item_id": "8bea0405-d250-4ac5-9cde-f0758a2dcb06",
"quantity": "8.000000000"
}
],
"order_id": "4bce6613-dedf-431f-862f-3e4ba445c1e0"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 01cdf2d2a95bad600000000000000001-e0d0ceb73b6f7dc4-0
{
"data": {
"charges": [
{
"id": "19e955e1-7262-4f38-9e8d-bf28d640d2d1",
"name": "C1",
"percent": "10.0000",
"price": "4.30",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "5a81a747-a5ed-4079-a42f-431bdcc875c0",
"name": "C3",
"percent": null,
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000ac3",
"name": "Company 734",
"updated_datetime": "2025-09-17T15:12:41.202165Z"
},
"creator": {
"banned": false,
"email": "user1@a.com",
"full_name": "John Foo",
"id": "00000000-0000-0000-0000-000000001085",
"role": {
"id": "00000000-0000-0000-0000-00000000100c",
"name": "Admin 921"
}
},
"custom_data": [],
"due_datetime": "2020-01-28T00:00:01.000000Z",
"id": "00000000-0000-0000-0000-000000000090",
"inserted_datetime": "2025-09-17T15:12:41.255982Z",
"invoice_datetime": "2020-01-02T00:00:00.000000Z",
"invoice_number": "INV-0000001",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008ea",
"name": "B1"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000e0",
"order_item_id": "8879407c-aaf5-435b-a89d-69f8dee74e15",
"package": null,
"price": "3.000000000",
"product": {
"id": "1eaae632-ac02-4067-8af3-ec189f2395c5",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:41.217624Z"
},
"quantity": "1.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008eb",
"name": "B2"
},
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "00000000-0000-0000-0000-0000000000e2",
"order_item_id": "8bea0405-d250-4ac5-9cde-f0758a2dcb06",
"package": null,
"price": "5.000000000",
"product": {
"id": "d97d3871-eb44-4bb8-9558-067756d2a18c",
"name": "P2",
"sku": "SKU2",
"updated_datetime": "2025-09-17T15:12:41.227191Z"
},
"quantity": "8.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
}
],
"order": {
"id": "4bce6613-dedf-431f-862f-3e4ba445c1e0",
"order_number": "SO-24",
"status": "Processing",
"total": "0.00"
},
"owner": null,
"paid_amount": "0.0",
"status": "NOT_PAID",
"total": "42.30",
"updated_datetime": "2025-09-17T15:12:41.303254Z"
}
}
POST /invoices reports various errors correctly on update
POST /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjIsImlhdCI6MTc1ODEyMTk2MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjIwNWFiNTAtNmM1YS00MzViLTk2OWYtOGJiZjM3ZWE0MTIzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDM4MCIsInR5cCI6ImFjY2VzcyJ9.n_Y26NjyQQokIT6XhjiKYtH8hdT5a736xoqbvX3aAHE
{
"billing_location_id": "00000000-0000-0000-0000-00000000050f",
"charges": [
{
"name": "C1",
"percent": "-1000.0000",
"type": "CHARGE",
"unit_type": "PERCENT"
}
],
"due_datetime": "2020-01-30T00:00:01.000000Z",
"id": "00000000-0000-0000-0000-000000000097",
"invoice_datetime": "2020-01-01T00:00:00.000000Z",
"items": [
{
"order_item_id": "00000000-0000-0000-0000-000000000000",
"quantity": "15.000"
},
{
"order_item_id": "3cdfe506-b652-4308-9e5b-4af92a84107e",
"quantity": "19.000"
}
],
"order_id": "7b60e8a2-f2c4-46cf-a4ab-c2739deafa3f"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: cc5e04c7931b88000000000000000001-5f9b2b1096fcb5ff-0
{
"errors": [
{
"context": {
"id": "14251031-4a06-4afe-945a-e1956400887d"
},
"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 | Default | Example |
---|---|---|---|---|---|---|
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDBjZGEyMzMtMGQxZC00MTE0LWJhZWMtYTVlMGRlM2I3ZWRkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzM4OCIsInR5cCI6ImFjY2VzcyJ9.owv2KOMXBT4D1Rtje9-VCcQRW9SfcGDgxkhM1d-KbV4
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 61ba133d8b528c000000000000000001-4b3ef17f9460de94-0
{
"data": [
{
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000b96",
"id": "00000000-0000-0000-0000-0000000003f6",
"license": null,
"license_id": null,
"name": "Place 29"
},
{
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000b96",
"id": "00000000-0000-0000-0000-0000000003f7",
"license": {
"id": "00000000-0000-0000-0000-000000000168",
"license_number": "CDPH-00000015"
},
"license_id": "00000000-0000-0000-0000-000000000168",
"name": "Place 30"
}
],
"next_page": null
}
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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjQsImlhdCI6MTc1ODEyMTk2NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMWIyODg5NjMtMzdlNC00M2VjLWFkZGMtZTM1NWI3ODMwZDkzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYzLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYzOCIsInR5cCI6ImFjY2VzcyJ9.vrJpqxtL4klND03_0QOgOj3B5DlGGMfJcSiXY2FrRO4
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: a3c0be85b3ac20000000000000000001-eeb3665764ce18bd-0
{
"data": [
{
"billing_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000fca",
"id": "00000000-0000-0000-0000-000000000568",
"license_id": null,
"name": "Place 398"
},
"biotrack_id": null,
"charges": [
{
"id": "4fd3acd7-bd28-4f7f-b20c-072edc5688ba",
"name": "C1",
"percent": "10.0000",
"price": "1.00",
"type": "CHARGE",
"unit_type": "PERCENT"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000c25",
"name": "Company 1137",
"updated_datetime": "2030-11-01T00:00:00.000000Z"
},
"creator": {
"banned": false,
"email": "user1@a.com",
"full_name": "John Foo",
"id": "00000000-0000-0000-0000-00000000121b",
"role": {
"id": "00000000-0000-0000-0000-000000001184",
"name": "Admin 1297"
}
},
"custom_data": [
{
"id": 44,
"name": "Custom Field 13",
"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": "6cdd4175-aaa1-4746-b29a-08118e1e84b3",
"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-0000000009f2",
"name": "B1"
},
"compliance_quantity": "10.0000",
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "9556c6b3-e1c9-46ed-a514-f3a566074aff",
"is_sample": true,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000fca",
"id": "00000000-0000-0000-0000-000000000568",
"license_id": null,
"name": "Place 398"
},
"package": {
"batch_number": "B1",
"compliance_label": "ABCDEF012345670000000165",
"id": "00000000-0000-0000-0000-00000000010b",
"metrc_label": "ABCDEF012345670000000165",
"status": "active"
},
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "56635b99-42d4-48d4-9d7a-747f6d96ef32",
"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": "37457d67-a30c-4161-a155-505e3c892326",
"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-00000000121c",
"role": {
"id": "00000000-0000-0000-0000-000000001186",
"name": "Admin 1299"
}
},
"shipping_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000fca",
"id": "00000000-0000-0000-0000-000000000568",
"license_id": null,
"name": "Place 398"
},
"status": "COMPLETED",
"total": "11.00",
"updated_datetime": "2020-01-01T00:00:04.000000Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjYsImlhdCI6MTc1ODEyMTk2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzM4NjY3YzctMjMyMi00NjNkLWJkZTItYjdkZDJjNTVkNmU1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDg0NyIsInR5cCI6ImFjY2VzcyJ9.IcmxP0oEbdPOXb8a3kAfpsbHfc4COz5RtxdCj_VIVVg
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 19088afc9a8ba3000000000000000001-24ebd32d62b31b75-0
{
"data": [
{
"billing_location": null,
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000cec",
"name": "Company 1359",
"updated_datetime": "2025-09-17T15:12:46.233766Z"
},
"creator": {
"banned": false,
"email": "owner-1532@example.com",
"full_name": "FirstName3118 LastName3119",
"id": "00000000-0000-0000-0000-0000000012f4",
"role": {
"id": "00000000-0000-0000-0000-00000000125c",
"name": "Admin 1513"
}
},
"custom_data": [],
"delivery_datetime": null,
"due_datetime": "2025-09-17T15:12:46.234474Z",
"external_notes": null,
"id": "f679ed3d-2123-4478-8120-a584e58777fc",
"inserted_datetime": "2025-09-17T15:12:46.248389Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000a8c",
"name": "B2505"
},
"compliance_quantity": null,
"cost_per_unit": "10.026",
"cost_per_unit_default": "5",
"id": "d894dbf7-30e2-4399-9cee-54b3f1dda4dd",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-0000000010ac",
"id": "00000000-0000-0000-0000-0000000005b0",
"license_id": null,
"name": "Place 470"
},
"package": null,
"price": "174380.000000000",
"price_base": "174380",
"product": {
"id": "a21b4297-1d8f-48ae-973d-3aac6ab94179",
"name": "Product 2503",
"sku": "sku 2504",
"updated_datetime": "2025-09-17T15:12:46.193999Z"
},
"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-09-17T15:12:46.234475Z",
"order_number": "SO-0000001",
"owner": null,
"shipping_location": null,
"status": "PROCESSING",
"total": "348760.00",
"updated_datetime": "2025-09-17T15:12:46.248389Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjEsImlhdCI6MTc1ODEyMTk2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiY2E4NjA0MjktNmFmNi00NjQyLWE4YzctZDY5M2I5NTM0ZGIwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDI4NSIsInR5cCI6ImFjY2VzcyJ9.-PmBRgU5m-4WbjyNeMXwuYuP0MrOMFF7by4wjbaba7g
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 42bef9f8087bf8000000000000000001-7cdf012cd1a6f8ec-0
{
"data": [
{
"billing_location": null,
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000b20",
"name": "Company 839",
"updated_datetime": "2025-09-17T15:12:41.839876Z"
},
"creator": {
"banned": false,
"email": "owner-1022@example.com",
"full_name": "FirstName2098 LastName2099",
"id": "00000000-0000-0000-0000-0000000010e6",
"role": {
"id": "00000000-0000-0000-0000-000000001063",
"name": "Admin 1008"
}
},
"custom_data": [],
"delivery_datetime": null,
"due_datetime": "2025-09-17T15:12:41.854973Z",
"external_notes": null,
"id": "da218337-5355-4dd3-882e-620e8934ced4",
"inserted_datetime": "2025-09-17T15:12:41.855530Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000934",
"name": "B1469"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "afc66919-cffb-4b61-8832-8f8f55eceb27",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "cc035754-74f2-46c2-8b77-fd8b130e4eed",
"name": "Product 1467",
"sku": "sku 1468",
"updated_datetime": "2025-09-17T15:12:41.863962Z"
},
"quantity": "15.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000935",
"name": "B1472"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "7b0bcde1-46bb-432c-82ba-f6f0214fc0c2",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "c6a35910-4b0e-469c-91af-fd1c1c5b3e18",
"name": "Product 1470",
"sku": "sku 1471",
"updated_datetime": "2025-09-17T15:12:41.874910Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000936",
"name": "B1477"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "e5a1a623-5fd5-4ca1-b3db-7791b4b88a50",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "5b1bf308-8081-4b00-946d-572a6ba216e0",
"name": "Product 1475",
"sku": "sku 1476",
"updated_datetime": "2025-09-17T15:12:41.883621Z"
},
"quantity": "5.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000938",
"name": "B1481"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "6728d1f0-e857-40a4-a3f9-8110ea943606",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "f15bfac8-29ce-4baa-bd1c-36d3df416989",
"name": "Product 1479",
"sku": "sku 1480",
"updated_datetime": "2025-09-17T15:12:41.892440Z"
},
"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-33",
"owner": {
"banned": false,
"email": "owner-1022@example.com",
"full_name": "FirstName2098 LastName2099",
"id": "00000000-0000-0000-0000-0000000010e6",
"role": {
"id": "00000000-0000-0000-0000-000000001063",
"name": "Admin 1008"
}
},
"shipping_location": null,
"status": "CANCELED",
"total": "320.00",
"updated_datetime": "2025-09-17T15:12:41.909434Z"
},
{
"billing_location": null,
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000b0d",
"name": "Company 819",
"updated_datetime": "2025-09-17T15:12:41.764823Z"
},
"creator": {
"banned": false,
"email": "owner-1009@example.com",
"full_name": "FirstName2072 LastName2073",
"id": "00000000-0000-0000-0000-0000000010d9",
"role": {
"id": "00000000-0000-0000-0000-000000001057",
"name": "Admin 996"
}
},
"custom_data": [],
"delivery_datetime": null,
"due_datetime": "2025-09-17T15:12:41.779279Z",
"external_notes": null,
"id": "b4c03a99-b9f2-44e6-8e74-8cfe7a80a1ca",
"inserted_datetime": "2025-09-17T15:12:41.779893Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000925",
"name": "B1426"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "12255b44-15a1-452c-9812-454c852fc917",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "751a6968-1236-43c8-a0be-40e348d6ec11",
"name": "Product 1424",
"sku": "sku 1425",
"updated_datetime": "2025-09-17T15:12:41.787924Z"
},
"quantity": "15.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000928",
"name": "B1433"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "983cc046-7483-43ae-bff5-b4ba71384c03",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "900d812b-9a85-4e4f-b98e-a7634a605efc",
"name": "Product 1431",
"sku": "sku 1432",
"updated_datetime": "2025-09-17T15:12:41.796879Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000929",
"name": "B1438"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "df174db5-bb80-445b-96cd-57a7e812bdb6",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "bf63d489-fcf3-4662-b297-425cebc03af0",
"name": "Product 1434",
"sku": "sku 1435",
"updated_datetime": "2025-09-17T15:12:41.805607Z"
},
"quantity": "5.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000092b",
"name": "B1446"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "25a14636-8956-4cf3-8d4f-6a5481166507",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "77f837cf-6dc8-4b4b-b589-907752a87a95",
"name": "Product 1444",
"sku": "sku 1445",
"updated_datetime": "2025-09-17T15:12:41.814403Z"
},
"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-31",
"owner": {
"banned": false,
"email": "owner-1009@example.com",
"full_name": "FirstName2072 LastName2073",
"id": "00000000-0000-0000-0000-0000000010d9",
"role": {
"id": "00000000-0000-0000-0000-000000001057",
"name": "Admin 996"
}
},
"shipping_location": null,
"status": "COMPLETED",
"total": "320.00",
"updated_datetime": "2025-09-17T15:12:41.832083Z"
},
{
"billing_location": null,
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000af1",
"name": "Company 789",
"updated_datetime": "2025-09-17T15:12:41.613013Z"
},
"creator": {
"banned": false,
"email": "owner-983@example.com",
"full_name": "FirstName2020 LastName2021",
"id": "00000000-0000-0000-0000-0000000010bf",
"role": {
"id": "00000000-0000-0000-0000-000000001041",
"name": "Admin 974"
}
},
"custom_data": [],
"delivery_datetime": null,
"due_datetime": "2025-09-17T15:12:41.628190Z",
"external_notes": null,
"id": "9c6bbce7-02ca-44e5-994a-3c18ed706c5d",
"inserted_datetime": "2025-09-17T15:12:41.628751Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000090d",
"name": "B1354"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "d64cb574-ce5c-4d73-8171-31c0888aafd3",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "ad5872f0-9036-41bf-b5db-2308549e05f5",
"name": "Product 1352",
"sku": "sku 1353",
"updated_datetime": "2025-09-17T15:12:41.636857Z"
},
"quantity": "15.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000090e",
"name": "B1361"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "747262b5-78ec-4f9a-93ad-2cfb07e76c8a",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "16e3b17d-3eb7-4940-ae8d-4a7b716d95d4",
"name": "Product 1359",
"sku": "sku 1360",
"updated_datetime": "2025-09-17T15:12:41.646439Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000913",
"name": "B1370"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "b447e9bc-cc79-4162-ba98-8e8b774daf9a",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "e2f04261-02bf-4f13-b8bf-f0e14ed69826",
"name": "Product 1368",
"sku": "sku 1369",
"updated_datetime": "2025-09-17T15:12:41.655674Z"
},
"quantity": "5.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000914",
"name": "B1373"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "ba121e80-78f5-4d80-b616-715327c57fdb",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "fa106922-7740-4d7f-856a-de567263c9d4",
"name": "Product 1371",
"sku": "sku 1372",
"updated_datetime": "2025-09-17T15:12:41.665014Z"
},
"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-28",
"owner": {
"banned": false,
"email": "owner-983@example.com",
"full_name": "FirstName2020 LastName2021",
"id": "00000000-0000-0000-0000-0000000010bf",
"role": {
"id": "00000000-0000-0000-0000-000000001041",
"name": "Admin 974"
}
},
"shipping_location": null,
"status": "COMPLETED",
"total": "320.00",
"updated_datetime": "2025-09-17T15:12:41.682064Z"
}
],
"next_page": null
}
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 | Default | 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/1c17696f-f0dd-4b86-9fcd-49724dc047ba
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjcsImlhdCI6MTc1ODEyMTk2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWMzODAxMzUtMzVmOS00MjgyLTk0OTctMGFhNzVmZDc4OGZhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDkyMiIsInR5cCI6ImFjY2VzcyJ9.3Ria6yrzKTqZoZpIeXc75jWZGUXH6Q3K_KsEMWSec10
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 8a48c21eea1b68000000000000000001-4497f3e3f3a5df99-0
{
"data": {
"billing_location": null,
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000d3b",
"name": "Company 1447",
"updated_datetime": "2025-09-17T15:12:47.467305Z"
},
"creator": {
"banned": false,
"email": "owner-1603@example.com",
"full_name": "FirstName3260 LastName3261",
"id": "00000000-0000-0000-0000-00000000133b",
"role": {
"id": "00000000-0000-0000-0000-0000000012a2",
"name": "Admin 1583"
}
},
"custom_data": [
{
"id": 45,
"name": "Custom Field 14",
"value": "Custom Field Value 1"
}
],
"delivery_datetime": null,
"due_datetime": "2025-09-17T15:12:47.501661Z",
"external_notes": null,
"id": "1c17696f-f0dd-4b86-9fcd-49724dc047ba",
"inserted_datetime": "2025-09-17T15:12:47.502340Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000acd",
"name": "B2700"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "ab83ad47-3c7c-4e8c-9047-6bb9f5794c58",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "98358d5b-5d56-4e95-bd4c-426db9ec4286",
"name": "Product 2698",
"sku": "sku 2699",
"updated_datetime": "2025-09-17T15:12:47.512743Z"
},
"quantity": "15.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000ace",
"name": "B2703"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "453e05ed-abca-4c8d-bcd9-91a9471cceed",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "69064158-1e0c-4ab0-a927-e09aeb2a8c9e",
"name": "Product 2701",
"sku": "sku 2702",
"updated_datetime": "2025-09-17T15:12:47.526083Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000acf",
"name": "B2706"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "28e41562-ee5e-4fe2-8a75-37a1016086ef",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "7e4273f4-daf3-44ab-9c58-a3c1278bdfa5",
"name": "Product 2704",
"sku": "sku 2705",
"updated_datetime": "2025-09-17T15:12:47.536259Z"
},
"quantity": "5.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000ad0",
"name": "B2709"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "be58a390-cbd7-409a-9e8e-c76a8ba5e3bb",
"is_sample": false,
"location": null,
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "2ae4da32-c78c-43cb-9e8b-396787432c11",
"name": "Product 2707",
"sku": "sku 2708",
"updated_datetime": "2025-09-17T15:12:47.545265Z"
},
"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-09-17T15:12:47.501661Z",
"order_number": "SO-123",
"owner": {
"banned": false,
"email": "owner-1603@example.com",
"full_name": "FirstName3260 LastName3261",
"id": "00000000-0000-0000-0000-00000000133b",
"role": {
"id": "00000000-0000-0000-0000-0000000012a2",
"name": "Admin 1583"
}
},
"shipping_location": null,
"status": "COMPLETED",
"total": "320.00",
"updated_datetime": "2025-09-17T15:12:47.560773Z"
}
}
GET /orders/:id returns cost data for order items
GET /public/v1/orders/1b238247-c004-4182-92f3-8612d086c3be
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjEsImlhdCI6MTc1ODEyMTk2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTUyNjQ1MDgtMDUyNS00ZjhlLWFlMjMtZWE1MDUxOGZlNWY3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDIwMyIsInR5cCI6ImFjY2VzcyJ9.fVYpE0Nc0h9jopmtbbvoJzdT6Nu3hY5HSpuTbaZ2x2I
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: ccd6af165128d0000000000000000001-64e71b8daf9691d1-0
{
"data": {
"billing_location": null,
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000ab9",
"name": "Company 722",
"updated_datetime": "2025-09-17T15:12:41.106852Z"
},
"creator": {
"banned": false,
"email": "owner-916@example.com",
"full_name": "FirstName1886 LastName1887",
"id": "00000000-0000-0000-0000-000000001076",
"role": {
"id": "00000000-0000-0000-0000-000000000fff",
"name": "Admin 908"
}
},
"custom_data": [],
"delivery_datetime": null,
"due_datetime": "2025-09-17T15:12:41.107733Z",
"external_notes": null,
"id": "1b238247-c004-4182-92f3-8612d086c3be",
"inserted_datetime": "2025-09-17T15:12:41.121667Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008e2",
"name": "B1223"
},
"compliance_quantity": null,
"cost_per_unit": "10.026",
"cost_per_unit_default": "5",
"id": "58518af7-7ca1-4c9a-8720-1e47b5b33f43",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e2a",
"id": "00000000-0000-0000-0000-0000000004c1",
"license_id": null,
"name": "Place 231"
},
"package": null,
"price": "591189.000000000",
"price_base": "591189",
"product": {
"id": "6b4dfec0-73be-4b74-b571-e9976f353ab3",
"name": "Product 1221",
"sku": "sku 1222",
"updated_datetime": "2025-09-17T15:12:41.051211Z"
},
"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-09-17T15:12:41.107734Z",
"order_number": "SO-0000001",
"owner": null,
"shipping_location": null,
"status": "PROCESSING",
"total": "1182378.00",
"updated_datetime": "2025-09-17T15:12:41.121667Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDhmZDUwNDAtMzE1OS00YzBhLWIyNWUtYTc5ZmNjMGMyZWEwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDE4OCIsInR5cCI6ImFjY2VzcyJ9.LcHvV818v_gO64CC91fk3DrfSM0zSw5k-fkhP2L__KQ
{
"billing_location_id": "00000000-0000-0000-0000-0000000004bc",
"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-000000000aac",
"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-0000000004bc",
"price_base": "10.000000000",
"product_id": "04c33e4a-e415-46c9-b7a0-4ca31a79c0dc",
"quantity": "1.000000000"
}
],
"order_datetime": "2020-01-01T00:00:02.000000Z",
"owner_id": "00000000-0000-0000-0000-00000000105c",
"shipping_location_id": "00000000-0000-0000-0000-0000000004bc",
"status": "PROCESSING"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 0f59b7fb333c03800000000000000001-b2a6a355208803dd-0
{
"data": {
"billing_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e1c",
"id": "00000000-0000-0000-0000-0000000004bc",
"license_id": "00000000-0000-0000-0000-0000000001b5",
"name": "Place 226"
},
"biotrack_id": null,
"charges": [
{
"id": "d7b63f19-4d71-48fc-8952-ab9931cdaa04",
"name": "C1",
"percent": "10.0000",
"price": "1.00",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "20488549-6172-4a89-8b60-4c2cac5ffa4b",
"name": "C2",
"percent": null,
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000aac",
"name": "Company 702",
"updated_datetime": "2025-09-17T15:12:40.917871Z"
},
"creator": {
"banned": false,
"email": "user1@a.com",
"full_name": "John Foo",
"id": "00000000-0000-0000-0000-00000000105c",
"role": {
"id": "00000000-0000-0000-0000-000000000fe5",
"name": "Admin 882"
}
},
"custom_data": [
{
"id": 40,
"name": "Custom Field 9",
"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": "8b0abf8c-ec6b-4eba-b28a-7e2172d8a405",
"inserted_datetime": "2025-09-17T15:12:40.963248Z",
"internal_notes": "Internal notes for this order",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008db",
"name": "B1"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "5d367bae-c4b6-45fc-ad2b-f731eda11f7c",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e1c",
"id": "00000000-0000-0000-0000-0000000004bc",
"license_id": "00000000-0000-0000-0000-0000000001b5",
"name": "Place 226"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "04c33e4a-e415-46c9-b7a0-4ca31a79c0dc",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:40.938954Z"
},
"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-00000000105c",
"role": {
"id": "00000000-0000-0000-0000-000000000fe5",
"name": "Admin 882"
}
},
"shipping_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e1c",
"id": "00000000-0000-0000-0000-0000000004bc",
"license_id": "00000000-0000-0000-0000-0000000001b5",
"name": "Place 226"
},
"status": "PROCESSING",
"total": "6.00",
"updated_datetime": "2025-09-17T15:12:40.991353Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjYsImlhdCI6MTc1ODEyMTk2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGJlZGNlN2EtYWIxOC00NWYzLWJhMmMtZDQzYmRiMjM2M2NhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDg4MCIsInR5cCI6ImFjY2VzcyJ9.ngfaYzMtF1Y78Sb7VW-TpJxHOlpdLHXdFbYOfbwH99E
{
"billing_location_id": "00000000-0000-0000-0000-0000000005b8",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000d08",
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-0000000005b8",
"price_base": "10.000000000",
"product_id": "c84ab24b-5a83-46f3-b5b7-2774bc64435f",
"quantity": "1.000000000"
}
],
"order_datetime": "2020-01-01T00:00:02.000000Z",
"shipping_location_id": "00000000-0000-0000-0000-0000000005b8",
"status": "PROCESSING"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 17adbe6dd2e7db000000000000000001-d8c0bd50ff93a89d-0
{
"errors": [
{
"context": {
"id": "27a6f1fc-303e-45d6-9c40-33ef03572371"
},
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjYsImlhdCI6MTc1ODEyMTk2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGJlZGNlN2EtYWIxOC00NWYzLWJhMmMtZDQzYmRiMjM2M2NhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDg4MCIsInR5cCI6ImFjY2VzcyJ9.ngfaYzMtF1Y78Sb7VW-TpJxHOlpdLHXdFbYOfbwH99E
{
"billing_location_id": "00000000-0000-0000-0000-0000000005b8",
"blaze_payment_type": "CASH",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000d08",
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-0000000005b8",
"price_base": "10.000000000",
"product_id": "c84ab24b-5a83-46f3-b5b7-2774bc64435f",
"quantity": "1.000000000"
}
],
"order_datetime": "2020-01-01T00:00:02.000000Z",
"shipping_location_id": "00000000-0000-0000-0000-0000000005b8",
"status": "PROCESSING"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 17adbe6dd2e7db000000000000000001-90aec8c532af3983-0
{
"data": {
"billing_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-0000000010cd",
"id": "00000000-0000-0000-0000-0000000005b8",
"license_id": "00000000-0000-0000-0000-000000000203",
"name": "Place 478"
},
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000d08",
"name": "Company 1391",
"updated_datetime": "2025-09-17T15:12:46.629937Z"
},
"creator": {
"banned": false,
"email": "owner-1560@example.com",
"full_name": "FirstName3174 LastName3175",
"id": "00000000-0000-0000-0000-000000001310",
"role": {
"id": "00000000-0000-0000-0000-000000001277",
"name": "Admin 1540"
}
},
"custom_data": [],
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": null,
"id": "c6db3ba8-9901-45f9-b073-46b1a72bd6d6",
"inserted_datetime": "2025-09-17T15:12:46.691530Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000aa2",
"name": "B1"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "5053c782-e589-4ecd-b250-1e56267edf31",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-0000000010cd",
"id": "00000000-0000-0000-0000-0000000005b8",
"license_id": "00000000-0000-0000-0000-000000000203",
"name": "Place 478"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "c84ab24b-5a83-46f3-b5b7-2774bc64435f",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:46.661499Z"
},
"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-0000000010cd",
"id": "00000000-0000-0000-0000-0000000005b8",
"license_id": "00000000-0000-0000-0000-000000000203",
"name": "Place 478"
},
"status": "PROCESSING",
"total": "10.00",
"updated_datetime": "2025-09-17T15:12:46.691530Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjIsImlhdCI6MTc1ODEyMTk2MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzExMWY0MTYtY2Q0MS00YjEzLTllZTAtMmQ3Njc0ZmQ1ZGNjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDQ0OCIsInR5cCI6ImFjY2VzcyJ9.DK5umbDLtWvVAbhg6Xjcg0enoyPplpf1YSSIbLWCd4E
{
"billing_location_id": "00000000-0000-0000-0000-000000000525",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000b7a",
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-000000000525",
"position": 1,
"price_base": "100.000000000",
"product_id": "1537d816-2de8-48a4-b488-18ca2260dbba",
"quantity": "80.000000000"
},
{
"location_id": "00000000-0000-0000-0000-000000000525",
"position": 2,
"price_base": "200.000000000",
"product_id": "1537d816-2de8-48a4-b488-18ca2260dbba",
"quantity": "10.000000000"
},
{
"location_id": "00000000-0000-0000-0000-000000000525",
"position": 3,
"price_base": "300.000000000",
"product_id": "88c27ade-9a55-457e-a9bb-39b5f084b05d",
"quantity": "20.000000000"
}
],
"order_datetime": "2020-01-01T00:00:02.000000Z",
"shipping_location_id": "00000000-0000-0000-0000-000000000525",
"status": "PROCESSING"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 10ad1914f154b2000000000000000001-9f9af96581c62ab2-0
{
"data": {
"billing_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f0f",
"id": "00000000-0000-0000-0000-000000000525",
"license_id": "00000000-0000-0000-0000-0000000001ce",
"name": "Place 331"
},
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000b7a",
"name": "Company 946",
"updated_datetime": "2025-09-17T15:12:42.764505Z"
},
"creator": {
"banned": false,
"email": "owner-1137@example.com",
"full_name": "FirstName2328 LastName2329",
"id": "00000000-0000-0000-0000-000000001160",
"role": {
"id": "00000000-0000-0000-0000-0000000010d1",
"name": "Admin 1118"
}
},
"custom_data": [],
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": null,
"id": "a48c601b-1ca5-4c56-b4ec-398d848cf0b7",
"inserted_datetime": "2025-09-17T15:12:42.850112Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000971",
"name": "B1"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "28f0fcb7-34a1-422f-bbc2-87883d63899e",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f0f",
"id": "00000000-0000-0000-0000-000000000525",
"license_id": "00000000-0000-0000-0000-0000000001ce",
"name": "Place 331"
},
"package": null,
"price": "80.000000000",
"price_base": "100.000000000",
"product": {
"id": "1537d816-2de8-48a4-b488-18ca2260dbba",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:42.785629Z"
},
"quantity": "80.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000971",
"name": "B1"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "c3fb5368-37c9-4b65-82e4-3838d2e691c1",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f0f",
"id": "00000000-0000-0000-0000-000000000525",
"license_id": "00000000-0000-0000-0000-0000000001ce",
"name": "Place 331"
},
"package": null,
"price": "180.000000000",
"price_base": "200.000000000",
"product": {
"id": "1537d816-2de8-48a4-b488-18ca2260dbba",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:42.785629Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000972",
"name": "B2"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "3ddcfc25-b371-4337-8877-2009cb4b9e45",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f0f",
"id": "00000000-0000-0000-0000-000000000525",
"license_id": "00000000-0000-0000-0000-0000000001ce",
"name": "Place 331"
},
"package": null,
"price": "270.000000000",
"price_base": "300.000000000",
"product": {
"id": "88c27ade-9a55-457e-a9bb-39b5f084b05d",
"name": "P2",
"sku": "SKU2",
"updated_datetime": "2025-09-17T15:12:42.802150Z"
},
"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-000000000f0f",
"id": "00000000-0000-0000-0000-000000000525",
"license_id": "00000000-0000-0000-0000-0000000001ce",
"name": "Place 331"
},
"status": "PROCESSING",
"total": "13600.00",
"updated_datetime": "2025-09-17T15:12:42.876102Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODExMWE3NTktZGMwOC00NzRjLWE3NmUtNzM0NzRlZTczYmY4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU3OCIsInR5cCI6ImFjY2VzcyJ9._VzuEOu15h-Ipga7VPFeH871pDqYpPIqzE6GGG7pXms
{
"due_datetime": "2020-01-01T00:00:01.000000Z",
"items": [
{
"batch_id": "00000000-0000-0000-0000-00000000079f",
"location_id": "00000000-0000-0000-0000-00000000041d",
"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: af4f7ec0192d00000000000000000001-ad8cfd50f5531a91-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-000000000dfa",
"role": {
"id": "00000000-0000-0000-0000-000000000d91",
"name": "Admin 286"
}
},
"custom_data": [],
"delivery_datetime": null,
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": null,
"id": "06dc6d58-a6eb-4503-8ecf-9f0983a201d1",
"inserted_datetime": "2025-09-17T15:12:38.730965Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000079f",
"name": "B1"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "7984d128-0e41-460a-9cd5-b391db9ec8ce",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000c2d",
"id": "00000000-0000-0000-0000-00000000041d",
"license_id": "00000000-0000-0000-0000-000000000171",
"name": "Place 68"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "84ebe0cb-585a-42bc-a64a-11208cbb323d",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:38.681368Z"
},
"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-09-17T15:12:38.730965Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjIsImlhdCI6MTc1ODEyMTk2MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWE5MTAyMzEtOWFhYi00M2I4LWJkMDgtYTg5MWIyZjBlOGM3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDQ5NCIsInR5cCI6ImFjY2VzcyJ9.N7FdzgiTlWOvKPrBZeyorMBDMKZlG-4teWzNtEx7Zec
{
"due_datetime": "2020-01-01T00:00:01.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-000000000536",
"price_base": "10.000000000",
"product_id": "daa91bc4-07cd-46ea-910a-d1aaea512930",
"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: 733d13afda0530000000000000000001-66631820d393a9d3-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-00000000118e",
"role": {
"id": "00000000-0000-0000-0000-0000000010fd",
"name": "Admin 1162"
}
},
"custom_data": [],
"delivery_datetime": null,
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": null,
"id": "300ce429-3887-4e68-b564-3cc018701657",
"inserted_datetime": "2025-09-17T15:12:42.991020Z",
"internal_notes": null,
"items": [
{
"batch": null,
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "d6c85c8e-bc2f-4c6c-a545-551b0ed73c03",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f26",
"id": "00000000-0000-0000-0000-000000000536",
"license_id": "00000000-0000-0000-0000-0000000001d6",
"name": "Place 348"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "daa91bc4-07cd-46ea-910a-d1aaea512930",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:42.971972Z"
},
"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-09-17T15:12:42.991020Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjMsImlhdCI6MTc1ODEyMTk2MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzhlZWZmMjAtYTAyZS00NDAyLTlhODktZGE5MTRkZTk4YmViIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYyNCIsInR5cCI6ImFjY2VzcyJ9.olYEp_t9y_WEZmoUDsAyhXGBxcHPxCcx1MAygUxGBxY
{
"due_datetime": "2020-01-01T00:00:01.000000Z",
"items": [
{
"compliance_quantity": "1.0000",
"is_sample": true,
"location_id": "00000000-0000-0000-0000-000000000564",
"package_id": "00000000-0000-0000-0000-00000000010a",
"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: 7554a61fef41ac000000000000000001-12d1aa88abeeeb7a-0
{
"data": {
"billing_location": null,
"biotrack_id": null,
"charges": [],
"company": null,
"creator": {
"banned": false,
"email": "owner-1310@example.com",
"full_name": "FirstName2674 LastName2675",
"id": "00000000-0000-0000-0000-000000001210",
"role": {
"id": "00000000-0000-0000-0000-000000001179",
"name": "Admin 1286"
}
},
"custom_data": [],
"delivery_datetime": null,
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": null,
"id": "d12a447a-cbdf-44c0-a65b-85bfed031468",
"inserted_datetime": "2025-09-17T15:12:44.011924Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009e9",
"name": "B1"
},
"compliance_quantity": "1.0000",
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "1ec0859d-33db-4509-90e7-c733e5ca664f",
"is_sample": true,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000fbd",
"id": "00000000-0000-0000-0000-000000000564",
"license_id": "00000000-0000-0000-0000-0000000001e5",
"name": "Place 394"
},
"package": {
"batch_number": "B1",
"compliance_label": "ABCDEF012345670000000162",
"id": "00000000-0000-0000-0000-00000000010a",
"metrc_label": "ABCDEF012345670000000162",
"status": "selling"
},
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "c3939d84-38d3-48cb-b6cb-9d3dba5b5cf8",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:43.949200Z"
},
"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-09-17T15:12:44.011924Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjIwMWQ2ZTMtMGFiMy00YjMwLWE5MzktYWIzNmI2ZTU0MjJjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc4MSIsInR5cCI6ImFjY2VzcyJ9.dgGVD_sTsapKqOfpuFHceEME0pu8QoYb2Gj3PwEkdRw
{
"due_datetime": "2020-01-01T00:00:01.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-000000000440",
"price_base": "10.000000000",
"product_id": "002ec283-b480-45f1-a5a3-4753056ee60a",
"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: 97acba920927e8000000000000000001-7d67229625e5465e-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-000000000ec5",
"role": {
"id": "00000000-0000-0000-0000-000000000e57",
"name": "Admin 484"
}
},
"custom_data": [],
"delivery_datetime": null,
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": null,
"id": "8272ad35-baab-4f01-af5b-e5e21b8d7ab4",
"inserted_datetime": "2025-09-17T15:12:38.924473Z",
"internal_notes": null,
"items": [
{
"batch": null,
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "36ef3519-6bfb-445e-9531-645adc030a89",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000cd7",
"id": "00000000-0000-0000-0000-000000000440",
"license_id": "00000000-0000-0000-0000-000000000179",
"name": "Place 103"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "002ec283-b480-45f1-a5a3-4753056ee60a",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:38.901021Z"
},
"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-09-17T15:12:38.924473Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjUsImlhdCI6MTc1ODEyMTk2NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzA5NGYyZjEtNzM4MS00MThhLWJlYjAtM2FiMjQyZDA1ZjU4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTY0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDgyOCIsInR5cCI6ImFjY2VzcyJ9.CHEf2E4Mr5SETfYky_T2qEYpFobKZlMT82i5m8mVegk
{
"billing_location_id": "00000000-0000-0000-0000-0000000005a9",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000cdf",
"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": "4fff8748-b68a-4910-8c1c-baff167eb390",
"location_id": "00000000-0000-0000-0000-0000000005a9",
"package_id": "00000000-0000-0000-0000-00000000010d",
"price_base": "10.000000000",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-0000000005a9",
"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-0000000012dc",
"shipping_location_id": "00000000-0000-0000-0000-0000000005a9",
"status": "PROCESSING"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 216d4612b6b0fa000000000000000001-a2e2eb444372f5ef-0
{
"data": {
"billing_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-00000000109a",
"id": "00000000-0000-0000-0000-0000000005a9",
"license_id": "00000000-0000-0000-0000-0000000001fd",
"name": "Place 463"
},
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000cdf",
"name": "Company 1342",
"updated_datetime": "2025-09-17T15:12:45.941815Z"
},
"creator": {
"banned": false,
"email": "user1@a.com",
"full_name": "John Foo",
"id": "00000000-0000-0000-0000-0000000012dc",
"role": {
"id": "00000000-0000-0000-0000-000000001244",
"name": "Admin 1489"
}
},
"custom_data": [],
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": null,
"id": "bab996cc-9272-4d80-883c-af407cc3f1b9",
"inserted_datetime": "2025-09-17T15:12:46.012860Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000a84",
"name": "B2"
},
"compliance_quantity": "1.0000",
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "4fff8748-b68a-4910-8c1c-baff167eb390",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-00000000109a",
"id": "00000000-0000-0000-0000-0000000005a9",
"license_id": "00000000-0000-0000-0000-0000000001fd",
"name": "Place 463"
},
"package": {
"batch_number": "B1",
"compliance_label": "ABCDEF012345670000000170",
"id": "00000000-0000-0000-0000-00000000010d",
"metrc_label": "ABCDEF012345670000000170",
"status": "selling"
},
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "f1e87280-c15f-44e4-aa68-95d8b809598b",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:45.954547Z"
},
"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-0000000012dc",
"role": {
"id": "00000000-0000-0000-0000-000000001244",
"name": "Admin 1489"
}
},
"shipping_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-00000000109a",
"id": "00000000-0000-0000-0000-0000000005a9",
"license_id": "00000000-0000-0000-0000-0000000001fd",
"name": "Place 463"
},
"status": "PROCESSING",
"total": "10.00",
"updated_datetime": "2025-09-17T15:12:46.054083Z"
}
}
POST /public/v1/orders updates an order
POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjEsImlhdCI6MTc1ODEyMTk2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzU3YjI5OTAtMWY0My00ZWJjLTk0NDQtZWQwNzVmNWU0ZjhhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDM0OSIsInR5cCI6ImFjY2VzcyJ9.5h95nvooTauHGpNe2hBb1jcRaj-DpMSOEay1W-6ujik
{
"billing_location_id": "00000000-0000-0000-0000-0000000004f8",
"charges": [
{
"id": "c3c51369-8fcb-46b2-b3fa-591aaa6d54fc",
"name": "C1",
"percent": "10.0000",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "30315d23-89ba-432a-afa2-9957a92bc847",
"name": "C2",
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company_id": "00000000-0000-0000-0000-000000000b2e",
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": "gonna make you sweat",
"id": "4c3654ec-3693-45c1-8123-3f7c2e58da32",
"items": [
{
"id": "7c143b5d-cb02-4464-89a7-d98fe2332d8d",
"is_sample": true,
"location_id": "00000000-0000-0000-0000-0000000004f8",
"price_base": "10.000000000",
"product_id": "08ec377b-d4c4-4240-a91c-b6a632cfa1d0",
"quantity": "2.000000000"
},
{
"id": "d4e218d8-d769-4e80-91a4-a48247a03c6a",
"location_id": "00000000-0000-0000-0000-0000000004f8",
"price_base": "100.000000000",
"product_id": "08ec377b-d4c4-4240-a91c-b6a632cfa1d0",
"quantity": "3.000000000"
},
{
"compliance_quantity": "1.0000",
"id": "62492f17-0895-43f2-8ef8-c4497a26ef4a",
"location_id": "00000000-0000-0000-0000-0000000004f8",
"package_id": "00000000-0000-0000-0000-000000000108",
"price_base": "10.000000000",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-0000000004f8",
"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-000000001110",
"shipping_location_id": "00000000-0000-0000-0000-0000000004f8",
"status": "PROCESSING"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 1abe5764eed886000000000000000001-9580791c2a414b5f-0
{
"data": {
"billing_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000eb5",
"id": "00000000-0000-0000-0000-0000000004f8",
"license_id": "00000000-0000-0000-0000-0000000001c2",
"name": "Place 286"
},
"biotrack_id": null,
"charges": [
{
"id": "c3c51369-8fcb-46b2-b3fa-591aaa6d54fc",
"name": "C1",
"percent": "10.0000",
"price": "33.00",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "30315d23-89ba-432a-afa2-9957a92bc847",
"name": "C2",
"percent": null,
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000b2e",
"name": "Company 856",
"updated_datetime": "2025-09-17T15:12:41.949180Z"
},
"creator": {
"banned": false,
"email": "user1@a.com",
"full_name": "John Foo",
"id": "00000000-0000-0000-0000-0000000010f8",
"role": {
"id": "00000000-0000-0000-0000-000000001075",
"name": "Admin 1026"
}
},
"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": "4c3654ec-3693-45c1-8123-3f7c2e58da32",
"inserted_datetime": "2025-09-17T15:12:42.002629Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000941",
"name": "B1"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "7c143b5d-cb02-4464-89a7-d98fe2332d8d",
"is_sample": true,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000eb5",
"id": "00000000-0000-0000-0000-0000000004f8",
"license_id": "00000000-0000-0000-0000-0000000001c2",
"name": "Place 286"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "08ec377b-d4c4-4240-a91c-b6a632cfa1d0",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:41.989070Z"
},
"quantity": "2.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000941",
"name": "B1"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "d4e218d8-d769-4e80-91a4-a48247a03c6a",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000eb5",
"id": "00000000-0000-0000-0000-0000000004f8",
"license_id": "00000000-0000-0000-0000-0000000001c2",
"name": "Place 286"
},
"package": null,
"price": "100.000000000",
"price_base": "100.000000000",
"product": {
"id": "08ec377b-d4c4-4240-a91c-b6a632cfa1d0",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:41.989070Z"
},
"quantity": "3.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000944",
"name": "B2"
},
"compliance_quantity": "1.0000",
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "62492f17-0895-43f2-8ef8-c4497a26ef4a",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000eb5",
"id": "00000000-0000-0000-0000-0000000004f8",
"license_id": "00000000-0000-0000-0000-0000000001c2",
"name": "Place 286"
},
"package": {
"batch_number": "B2",
"compliance_label": "ABCDEF012345670000000158",
"id": "00000000-0000-0000-0000-000000000108",
"metrc_label": "ABCDEF012345670000000158",
"status": "selling"
},
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "2b43dd1d-64cc-409b-86d7-a675a2a8a6f2",
"name": "P2",
"sku": "SKU2",
"updated_datetime": "2025-09-17T15:12:42.015153Z"
},
"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-36",
"owner": {
"banned": false,
"email": "owner-1062@example.com",
"full_name": "FirstName2178 LastName2179",
"id": "00000000-0000-0000-0000-000000001110",
"role": {
"id": "00000000-0000-0000-0000-000000001089",
"name": "Admin 1046"
}
},
"shipping_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000eb5",
"id": "00000000-0000-0000-0000-0000000004f8",
"license_id": "00000000-0000-0000-0000-0000000001c2",
"name": "Place 286"
},
"status": "PROCESSING",
"total": "358.00",
"updated_datetime": "2025-09-17T15:12:42.167077Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjMsImlhdCI6MTc1ODEyMTk2MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiY2FmMWI0YTEtNjAzMy00NGNhLTg2Y2MtNTkwNGZjNDU4YzVkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDYwMSIsInR5cCI6ImFjY2VzcyJ9.13BpyQOzay2xDnqh3pgowUmRhQG__6Uk0xTvKjah0bM
{
"billing_location_id": "00000000-0000-0000-0000-00000000055f",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000c05",
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-00000000055f",
"position": 1,
"price_base": "100.000000000",
"product_id": "087d2cf0-6f64-4282-96aa-6b52c99d3c22",
"quantity": "10.000000000"
},
{
"location_id": "00000000-0000-0000-0000-00000000055f",
"position": 2,
"price_base": "200.000000000",
"product_id": "dcea895a-173e-4c89-92c0-530fe5424d3b",
"quantity": "10.000000000"
},
{
"location_id": "00000000-0000-0000-0000-00000000055f",
"position": 3,
"price_base": "300.000000000",
"product_id": "fa3d7d34-6caa-4ace-8c1e-2cc00d1b6704",
"quantity": "10.000000000"
}
],
"order_datetime": "2020-01-01T00:00:02.000000Z",
"shipping_location_id": "00000000-0000-0000-0000-00000000055f",
"status": "PROCESSING"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: d6e3e6e580e898000000000000000001-fa97090aa2e722f8-0
{
"data": {
"billing_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000fa9",
"id": "00000000-0000-0000-0000-00000000055f",
"license_id": "00000000-0000-0000-0000-0000000001e2",
"name": "Place 389"
},
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000c05",
"name": "Company 1100",
"updated_datetime": "2025-09-17T15:12:43.690553Z"
},
"creator": {
"banned": false,
"email": "owner-1287@example.com",
"full_name": "FirstName2628 LastName2629",
"id": "00000000-0000-0000-0000-0000000011f9",
"role": {
"id": "00000000-0000-0000-0000-000000001162",
"name": "Admin 1263"
}
},
"custom_data": [],
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": null,
"id": "833cc817-f66b-444f-9740-6fefbf8aa734",
"inserted_datetime": "2025-09-17T15:12:43.793408Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009dd",
"name": "B1"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "0f94820b-d666-4ac9-9692-389b929c6d53",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000fa9",
"id": "00000000-0000-0000-0000-00000000055f",
"license_id": "00000000-0000-0000-0000-0000000001e2",
"name": "Place 389"
},
"package": null,
"price": "90.000000000",
"price_base": "100.000000000",
"product": {
"id": "087d2cf0-6f64-4282-96aa-6b52c99d3c22",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:43.711534Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009df",
"name": "B2"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "40a9abc2-a962-436c-9dbd-557fefbffbcb",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000fa9",
"id": "00000000-0000-0000-0000-00000000055f",
"license_id": "00000000-0000-0000-0000-0000000001e2",
"name": "Place 389"
},
"package": null,
"price": "200.000000000",
"price_base": "200.000000000",
"product": {
"id": "dcea895a-173e-4c89-92c0-530fe5424d3b",
"name": "P2",
"sku": "SKU2",
"updated_datetime": "2025-09-17T15:12:43.730355Z"
},
"quantity": "10.000000000",
"returned_quantity": "0",
"total_cost_actual": null,
"total_cost_default": null
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009e0",
"name": "B3"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "b8ebbe49-4be2-4f1b-9da9-18f630517c5e",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000fa9",
"id": "00000000-0000-0000-0000-00000000055f",
"license_id": "00000000-0000-0000-0000-0000000001e2",
"name": "Place 389"
},
"package": null,
"price": "290.000000000",
"price_base": "300.000000000",
"product": {
"id": "fa3d7d34-6caa-4ace-8c1e-2cc00d1b6704",
"name": "P3",
"sku": "SKU3",
"updated_datetime": "2025-09-17T15:12:43.744891Z"
},
"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-000000000fa9",
"id": "00000000-0000-0000-0000-00000000055f",
"license_id": "00000000-0000-0000-0000-0000000001e2",
"name": "Place 389"
},
"status": "PROCESSING",
"total": "5800.00",
"updated_datetime": "2025-09-17T15:12:43.825330Z"
}
}
POST /public/v1/orders deleting order items & charges
POST /public/v1/orders
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjEsImlhdCI6MTc1ODEyMTk2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjZmZGQ4MmMtOTlkYi00NGZiLWJhZGQtZGZhNzU4MGI1MjViIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDI2NiIsInR5cCI6ImFjY2VzcyJ9.Ysfn2UBhFQUuYzya-WYrcI504vxK-hE4k5nBtE9TLis
{
"billing_location_id": "00000000-0000-0000-0000-0000000004dc",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000ae0",
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"id": "c053dca7-0fd2-4437-8f28-465ad9199ea0",
"items": [
{
"id": "10dff5c8-3e54-47c7-b890-f49433da4828",
"location_id": "00000000-0000-0000-0000-0000000004dc",
"price_base": "10.000000000",
"product_id": "cb72fa9e-bbe8-48cc-a015-d3b5050a4d74",
"quantity": "1.000000000"
}
],
"order_datetime": "2020-01-01T00:00:02.000000Z",
"shipping_location_id": "00000000-0000-0000-0000-0000000004dc",
"status": "PROCESSING"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 82cdf78d0681c8000000000000000001-fb2a5025ab662995-0
{
"data": {
"billing_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e5c",
"id": "00000000-0000-0000-0000-0000000004dc",
"license_id": "00000000-0000-0000-0000-0000000001bd",
"name": "Place 258"
},
"biotrack_id": null,
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000ae0",
"name": "Company 767",
"updated_datetime": "2025-09-17T15:12:41.433727Z"
},
"creator": {
"banned": false,
"email": "user1@a.com",
"full_name": "John Foo",
"id": "00000000-0000-0000-0000-0000000010aa",
"role": {
"id": "00000000-0000-0000-0000-00000000102d",
"name": "Admin 954"
}
},
"custom_data": [],
"delivery_datetime": "2020-01-01T00:00:00.000000Z",
"due_datetime": "2020-01-01T00:00:01.000000Z",
"external_notes": null,
"id": "c053dca7-0fd2-4437-8f28-465ad9199ea0",
"inserted_datetime": "2025-09-17T15:12:41.502819Z",
"internal_notes": null,
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000904",
"name": "B1"
},
"compliance_quantity": null,
"cost_per_unit": null,
"cost_per_unit_default": null,
"id": "10dff5c8-3e54-47c7-b890-f49433da4828",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e5c",
"id": "00000000-0000-0000-0000-0000000004dc",
"license_id": "00000000-0000-0000-0000-0000000001bd",
"name": "Place 258"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "cb72fa9e-bbe8-48cc-a015-d3b5050a4d74",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:41.486128Z"
},
"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-27",
"owner": null,
"shipping_location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e5c",
"id": "00000000-0000-0000-0000-0000000004dc",
"license_id": "00000000-0000-0000-0000-0000000001bd",
"name": "Place 258"
},
"status": "PROCESSING",
"total": "10.00",
"updated_datetime": "2025-09-17T15:12:41.571385Z"
}
}
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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzNkZmFiOTYtNmU2MS00NWViLWI2NWItMDRjOTU5MmUzNTMyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzg5NCIsInR5cCI6ImFjY2VzcyJ9.ZRMmaDvuMb363j47Td7RIYAeaYzTr9zTidf0k_3u6VA
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: f1a1651d586a20000000000000000001-64df71038caf638c-0
{
"data": [
{
"batch_number": null,
"compliance_label": "ABCDEF012345670000000080",
"custom_data": [
{
"id": 36,
"name": "Custom Field 5",
"value": "Custom Field Value 1"
}
],
"expiration_date": "2024-01-01T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-0000000000df",
"is_trade_sample": true,
"license": {
"id": "00000000-0000-0000-0000-000000000182",
"license_number": "CDPH-00000041"
},
"location": {
"id": "00000000-0000-0000-0000-00000000045a",
"name": "Place 129"
},
"metrc_label": "ABCDEF012345670000000080",
"primary_test_result": null,
"product_id": "2301c2ae-d0f0-4e70-a1eb-4accd7ecb52b",
"product_unit_quantity": "7.500000000",
"product_unit_type": {
"id": "00000000-0000-0000-0000-00000000ab23",
"name": "3"
},
"quantity": "5.000000000",
"quantity_assembling": "0.000000000",
"quantity_available": "5.000000000",
"status": "active",
"unit_type": {
"id": "00000000-0000-0000-0000-00000000ab24",
"name": "2"
}
},
{
"batch_number": null,
"compliance_label": "ABCDEF012345670000000090",
"custom_data": [
{
"id": 36,
"name": "Custom Field 5",
"value": null
}
],
"expiration_date": null,
"id": "00000000-0000-0000-0000-0000000000e2",
"is_trade_sample": false,
"license": {
"id": "00000000-0000-0000-0000-000000000182",
"license_number": "CDPH-00000041"
},
"location": {
"id": "00000000-0000-0000-0000-00000000045f",
"name": "Place 134"
},
"metrc_label": "ABCDEF012345670000000090",
"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": "2301c2ae-d0f0-4e70-a1eb-4accd7ecb52b",
"product_unit_quantity": "15.000000000",
"product_unit_type": {
"id": "00000000-0000-0000-0000-00000000ab23",
"name": "3"
},
"quantity": "20.000000000",
"quantity_assembling": "0.000000000",
"quantity_available": "20.000000000",
"status": "active",
"unit_type": {
"id": "00000000-0000-0000-0000-00000000ab25",
"name": "4"
}
}
],
"next_page": null
}
GET /public/v1/packages returns cost data when include_costs is true
GET /public/v1/packages?include_costs=true
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTc0ZTg4NDAtYWQxMS00YTI5LTk2ZjMtYmNkYzE4YWQ2N2EwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA3MSIsInR5cCI6ImFjY2VzcyJ9.qomr3HyK7lstbQNhdI2Os9mnkpKitQrRKF1RVsf6B5Q
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 68867f76b6d974000000000000000001-194067dafe0bc218-0
{
"data": [
{
"batch_number": null,
"compliance_label": "ABCDEF012345670000000122",
"cost_per_unit_actual": "0.4",
"cost_per_unit_default": "0.2",
"custom_data": [],
"expiration_date": null,
"id": "00000000-0000-0000-0000-0000000000f3",
"is_trade_sample": false,
"license": {
"id": "00000000-0000-0000-0000-00000000019b",
"license_number": "CDPH-00000066"
},
"location": {
"id": "00000000-0000-0000-0000-000000000491",
"name": "Place 184"
},
"metrc_label": "ABCDEF012345670000000122",
"primary_test_result": null,
"product_id": "f9c852b3-82b6-411e-80b9-216173479a34",
"product_unit_quantity": "141.747462720",
"product_unit_type": {
"id": "00000000-0000-0000-0000-00000000b375",
"name": "Gram"
},
"quantity": "5.000000000",
"quantity_assembling": "0.000000000",
"quantity_available": "5.000000000",
"status": "active",
"total_cost_actual": "2",
"total_cost_default": "1",
"unit_type": {
"id": "00000000-0000-0000-0000-00000000b377",
"name": "Ounce"
}
}
],
"next_page": null
}
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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTYsImlhdCI6MTc1ODEyMTk1NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiM2M3MjUyNjQtNDlmNy00YjQwLWFjNTQtZGY3YWE3YzNkMTY0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzI5MyIsInR5cCI6ImFjY2VzcyJ9.skVlq9Ln81spZuUO9wMkna95AAiEmGqjNBdIlEErdBM
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 3a01639e443ff8000000000000000001-b539eb1161bb9e31-0
{
"data": [
{
"id": "00000000-0000-0000-0000-00000000001a",
"name": "Payment Method 0"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYThlNjkwNWItNGUxZC00MjM1LTg3ZDktMGIwNmZiNzUzMzgzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY4MiIsInR5cCI6ImFjY2VzcyJ9._6sUlIWbAFHm4_hIWqkc6JGtNxls8CcYG2gTmTNz2qw
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 0c45ab2ef9ee0f800000000000000001-d80b2a1013321b16-0
{
"data": [
{
"brand": {
"id": "00000000-0000-0000-0000-00000000098c",
"name": "Company 306",
"updated_datetime": "2030-11-01T00:00:00.000000Z"
},
"category": {
"id": "00000000-0000-0000-0000-00000000078c",
"name": "Some category 108",
"type": "OTHER"
},
"custom_data": [
{
"id": 35,
"name": "Custom Field 4",
"value": "Custom Field Value 1"
}
],
"description": "test",
"description_markdown": "# test",
"external_name": "External Name",
"id": "d8132adf-23fa-470a-b3b1-c6a1a58ec37e",
"images": [
{
"id": "00000000-0000-0000-0000-000000000005",
"name": "Image Name 0",
"rank": 0,
"url": "https://google.com/original-0.jpg"
},
{
"id": "00000000-0000-0000-0000-000000000006",
"name": "Image Name 1",
"rank": 1,
"url": "https://google.com/original-1.jpg"
}
],
"is_active": true,
"msrp": null,
"name": "Product 287",
"sku": "sku 288",
"strain": {
"id": "00000000-0000-0000-0000-000000000047",
"name": "Strain 20"
},
"subcategory": {
"id": "00000000-0000-0000-0000-000000000780",
"name": "Some subcategory 106"
},
"unit_price": "1",
"unit_type": {
"id": "00000000-0000-0000-0000-00000000a2a9",
"name": "Gram"
},
"units_per_case": null,
"updated_datetime": "2023-11-01T00:00:00.000000Z",
"vendor": {
"id": "00000000-0000-0000-0000-000000000990",
"name": "Company 311",
"updated_datetime": "2030-11-03T00:00:00.000000Z"
}
},
{
"brand": {
"id": "00000000-0000-0000-0000-00000000098d",
"name": "Company 308",
"updated_datetime": "2030-11-02T00:00:00.000000Z"
},
"category": {
"id": "00000000-0000-0000-0000-000000000791",
"name": "Some category 113",
"type": "OTHER"
},
"custom_data": [
{
"id": 35,
"name": "Custom Field 4",
"value": null
}
],
"description": null,
"description_markdown": null,
"external_name": null,
"id": "8d849576-8f03-4d56-9975-38f5d48e57a7",
"images": [],
"is_active": false,
"msrp": "100",
"name": "Product 302",
"sku": "sku 303",
"strain": null,
"subcategory": {
"id": "00000000-0000-0000-0000-000000000786",
"name": "Some subcategory 112"
},
"unit_price": "1",
"unit_type": {
"id": "00000000-0000-0000-0000-00000000a2a7",
"name": "Pound"
},
"units_per_case": null,
"updated_datetime": "2023-11-02T00:00:00.000000Z",
"vendor": {
"id": "00000000-0000-0000-0000-000000000992",
"name": "Company 313",
"updated_datetime": "2030-11-04T00:00:00.000000Z"
}
}
],
"next_page": null
}
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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTYsImlhdCI6MTc1ODEyMTk1NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZmIzMjAwNDktMWY1Mi00MTlhLWFiMzYtNmY0ZDc0YWY4ZWZiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzMwNCIsInR5cCI6ImFjY2VzcyJ9.45Ew5dmwoX2HDijcJgD21g54Hy2uTPscluGHB5gcsIg
{
"unit_net_weight_and_serving_size_unit_type_id": "00000000-0000-0000-0000-0000000093b9",
"id": "afd8a6ca-5f04-496c-87aa-c9b09fc708a1",
"is_featured": true,
"description_markdown": "# My Product Description Markdown",
"wholesale_unit_price": "90.50",
"msrp": "100.5",
"unit_type_id": "00000000-0000-0000-0000-0000000093c0",
"quantity_available_threshold_min": "5.5",
"total_thc": "10.4",
"brand_id": "00000000-0000-0000-0000-0000000008e2",
"sku": "12345",
"unit_price": "100",
"category_id": "00000000-0000-0000-0000-000000000725",
"unit_serving_size": "2.2",
"tags": [
"00000000-0000-0000-0000-00000000000b"
],
"total_cbd": "5.2",
"unit_cost": "50.4",
"group_id": "00000000-0000-0000-0000-0000000006ad",
"is_inactive": true,
"units_per_case": "0.2",
"menus": [
"00000000-0000-0000-0000-000000000011"
],
"vendor_id": "00000000-0000-0000-0000-0000000008dc",
"total_cannabinoid_unit": "PERCENT",
"menu_visibility": "INCLUDE_IN_ALL",
"inventory_tracking_method": "PACKAGE",
"description": "My Product Description",
"owner_id": "00000000-0000-0000-0000-000000000ce2",
"subcategory_id": "00000000-0000-0000-0000-000000000718",
"quantity_available_threshold_max": "10.5",
"upc": "036000291452",
"unit_net_weight": "3.1",
"strain_id": "00000000-0000-0000-0000-000000000033",
"name": "My Product"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: f912e9873d5c58000000000000000001-453c5e186bd02121-0
{
"data": {
"brand": {
"id": "00000000-0000-0000-0000-0000000008e2",
"name": "Company 30",
"updated_datetime": "2025-09-17T15:12:36.901914Z"
},
"category": {
"id": "00000000-0000-0000-0000-000000000725",
"name": "Some category 5",
"type": "OTHER"
},
"custom_data": [
{
"id": 31,
"name": "Custom Field 0",
"value": null
}
],
"description": "My Product Description",
"description_markdown": "# My Product Description Markdown",
"external_name": null,
"id": "afd8a6ca-5f04-496c-87aa-c9b09fc708a1",
"images": [],
"is_active": false,
"msrp": "100.5",
"name": "My Product",
"sku": "12345",
"strain": {
"id": "00000000-0000-0000-0000-000000000033",
"name": "Strain 0"
},
"subcategory": {
"id": "00000000-0000-0000-0000-000000000718",
"name": "Some subcategory 4"
},
"unit_price": "100",
"unit_type": {
"id": "00000000-0000-0000-0000-0000000093c0",
"name": "Unit"
},
"units_per_case": "0.2",
"updated_datetime": "2025-09-17T15:12:37.745682Z",
"vendor": {
"id": "00000000-0000-0000-0000-0000000008dc",
"name": "Company 22",
"updated_datetime": "2025-09-17T15:12:36.880852Z"
}
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMDE5MzA3OGEtNTgwNS00ZDY3LTgwYjYtZjQ4NmM1MmI5ZTY0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzg4MiIsInR5cCI6ImFjY2VzcyJ9.ZiLrFG9Ay21A6y8VwVqGoKAfi8DSAfydQJmPL7RcMi4
{
"category_id": "00000000-0000-0000-0000-0000000007ee",
"id": "ace2cf88-32dd-4d4f-b1eb-f8d94159f365",
"inventory_tracking_method": "PACKAGE",
"name": "My Product",
"sku": "12345",
"unit_price": "100",
"unit_type_id": "00000000-0000-0000-0000-00000000aa11",
"upc": "036000291452",
"vendor_id": "00000000-0000-0000-0000-0000000009ea"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 421a8294943fec000000000000000001-7f8c70d897692260-0
{
"data": {
"brand": null,
"category": {
"id": "00000000-0000-0000-0000-0000000007ee",
"name": "Some category 206",
"type": "OTHER"
},
"custom_data": [],
"description": null,
"description_markdown": null,
"external_name": null,
"id": "ace2cf88-32dd-4d4f-b1eb-f8d94159f365",
"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-00000000aa11",
"name": "Gram"
},
"units_per_case": null,
"updated_datetime": "2025-09-17T15:12:39.567654Z",
"vendor": {
"id": "00000000-0000-0000-0000-0000000009ea",
"name": "Company 450",
"updated_datetime": "2025-09-17T15:12:39.499710Z"
}
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMDE5MzA3OGEtNTgwNS00ZDY3LTgwYjYtZjQ4NmM1MmI5ZTY0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzg4MiIsInR5cCI6ImFjY2VzcyJ9.ZiLrFG9Ay21A6y8VwVqGoKAfi8DSAfydQJmPL7RcMi4
{
"unit_net_weight_and_serving_size_unit_type_id": "00000000-0000-0000-0000-00000000aa13",
"id": "ace2cf88-32dd-4d4f-b1eb-f8d94159f365",
"is_featured": true,
"wholesale_unit_price": "90.50",
"msrp": "100.5",
"unit_type_id": "00000000-0000-0000-0000-00000000aa1a",
"quantity_available_threshold_min": "5.5",
"total_thc": "10.4",
"brand_id": "00000000-0000-0000-0000-000000000a01",
"sku": "45678",
"unit_price": "200",
"category_id": "00000000-0000-0000-0000-0000000007fd",
"unit_serving_size": "2.2",
"tags": [
"00000000-0000-0000-0000-00000000000f"
],
"total_cbd": "5.2",
"unit_cost": "50.4",
"group_id": "00000000-0000-0000-0000-000000000771",
"is_inactive": true,
"units_per_case": "0.2",
"menus": [
"00000000-0000-0000-0000-000000000018"
],
"vendor_id": "00000000-0000-0000-0000-0000000009fb",
"total_cannabinoid_unit": "PERCENT",
"menu_visibility": "INCLUDE_IN_ALL",
"inventory_tracking_method": "PACKAGE",
"description": "My Product Description",
"owner_id": "00000000-0000-0000-0000-000000000f5e",
"subcategory_id": "00000000-0000-0000-0000-0000000007f1",
"external_name": "External Name",
"quantity_available_threshold_max": "10.5",
"upc": "036000291453",
"unit_net_weight": "3.1",
"strain_id": "00000000-0000-0000-0000-000000000049",
"name": "Updated Name"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 421a8294943fec000000000000000001-5b602958926966b1-0
{
"data": {
"brand": {
"id": "00000000-0000-0000-0000-000000000a01",
"name": "Company 477",
"updated_datetime": "2025-09-17T15:12:39.688751Z"
},
"category": {
"id": "00000000-0000-0000-0000-0000000007fd",
"name": "Some category 221",
"type": "OTHER"
},
"custom_data": [],
"description": "My Product Description",
"description_markdown": "My Product Description",
"external_name": "External Name",
"id": "ace2cf88-32dd-4d4f-b1eb-f8d94159f365",
"images": [],
"is_active": false,
"msrp": "100.5",
"name": "Updated Name",
"sku": "45678",
"strain": {
"id": "00000000-0000-0000-0000-000000000049",
"name": "Strain 22"
},
"subcategory": {
"id": "00000000-0000-0000-0000-0000000007f1",
"name": "Some subcategory 219"
},
"unit_price": "200",
"unit_type": {
"id": "00000000-0000-0000-0000-00000000aa1a",
"name": "Unit"
},
"units_per_case": "0.2",
"updated_datetime": "2025-09-17T15:12:39.787473Z",
"vendor": {
"id": "00000000-0000-0000-0000-0000000009fb",
"name": "Company 470",
"updated_datetime": "2025-09-17T15:12:39.650104Z"
}
}
}
POST /public/v1/orders Menus act as expected
POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTI5MGY4MzItMGRkYy00ZmZmLTllNDctODlhN2JjYmYzNDVkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU5MiIsInR5cCI6ImFjY2VzcyJ9.ZKbEDlQYn-7V9fymmLJKwi6nMHwJ3UUHLicUSZuD1Zc
{
"category_id": "00000000-0000-0000-0000-000000000768",
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"inventory_tracking_method": "PACKAGE",
"menu_visibility": "INCLUDE_IN_ALL",
"menus": [
"00000000-0000-0000-0000-000000000012"
],
"name": "My Product",
"sku": "12345",
"unit_price": "100",
"unit_type_id": "00000000-0000-0000-0000-000000009ed1",
"upc": "036000291452",
"vendor_id": "00000000-0000-0000-0000-000000000961"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 8f60bb3c0c8528000000000000000001-9bfe881755241e6a-0
{
"data": {
"brand": null,
"category": {
"id": "00000000-0000-0000-0000-000000000768",
"name": "Some category 72",
"type": "OTHER"
},
"custom_data": [],
"description": null,
"description_markdown": null,
"external_name": null,
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"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-000000009ed1",
"name": "Gram"
},
"units_per_case": null,
"updated_datetime": "2025-09-17T15:12:38.263259Z",
"vendor": {
"id": "00000000-0000-0000-0000-000000000961",
"name": "Company 231",
"updated_datetime": "2025-09-17T15:12:38.199247Z"
}
}
}
POST /public/v1/orders Menus act as expected
POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTI5MGY4MzItMGRkYy00ZmZmLTllNDctODlhN2JjYmYzNDVkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU5MiIsInR5cCI6ImFjY2VzcyJ9.ZKbEDlQYn-7V9fymmLJKwi6nMHwJ3UUHLicUSZuD1Zc
{
"category_id": "00000000-0000-0000-0000-000000000768",
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"inventory_tracking_method": "PACKAGE",
"menu_visibility": "DO_NOT_INCLUDE",
"menus": [
"00000000-0000-0000-0000-000000000012",
"00000000-0000-0000-0000-000000000013"
],
"name": "My Product",
"sku": "12345",
"tags": [],
"unit_price": "100",
"unit_type_id": "00000000-0000-0000-0000-000000009ed1",
"upc": "036000291452",
"vendor_id": "00000000-0000-0000-0000-000000000961"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 8f60bb3c0c8528000000000000000001-8193225c57566565-0
{
"data": {
"brand": null,
"category": {
"id": "00000000-0000-0000-0000-000000000768",
"name": "Some category 72",
"type": "OTHER"
},
"custom_data": [],
"description": null,
"description_markdown": null,
"external_name": null,
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"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-000000009ed1",
"name": "Gram"
},
"units_per_case": null,
"updated_datetime": "2025-09-17T15:12:38.329157Z",
"vendor": {
"id": "00000000-0000-0000-0000-000000000961",
"name": "Company 231",
"updated_datetime": "2025-09-17T15:12:38.199247Z"
}
}
}
POST /public/v1/orders Menus act as expected
POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTI5MGY4MzItMGRkYy00ZmZmLTllNDctODlhN2JjYmYzNDVkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU5MiIsInR5cCI6ImFjY2VzcyJ9.ZKbEDlQYn-7V9fymmLJKwi6nMHwJ3UUHLicUSZuD1Zc
{
"category_id": "00000000-0000-0000-0000-000000000768",
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"inventory_tracking_method": "PACKAGE",
"menu_visibility": "INCLUDE_IN_SELECT",
"menus": [
"00000000-0000-0000-0000-000000000012",
"00000000-0000-0000-0000-000000000013"
],
"name": "My Product",
"sku": "12345",
"tags": [],
"unit_price": "100",
"unit_type_id": "00000000-0000-0000-0000-000000009ed1",
"upc": "036000291452",
"vendor_id": "00000000-0000-0000-0000-000000000961"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 8f60bb3c0c8528000000000000000001-711aa8c0a3dd1bbf-0
{
"data": {
"brand": null,
"category": {
"id": "00000000-0000-0000-0000-000000000768",
"name": "Some category 72",
"type": "OTHER"
},
"custom_data": [],
"description": null,
"description_markdown": null,
"external_name": null,
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"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-000000009ed1",
"name": "Gram"
},
"units_per_case": null,
"updated_datetime": "2025-09-17T15:12:38.414506Z",
"vendor": {
"id": "00000000-0000-0000-0000-000000000961",
"name": "Company 231",
"updated_datetime": "2025-09-17T15:12:38.199247Z"
}
}
}
POST /public/v1/orders Menus act as expected
POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTI5MGY4MzItMGRkYy00ZmZmLTllNDctODlhN2JjYmYzNDVkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU5MiIsInR5cCI6ImFjY2VzcyJ9.ZKbEDlQYn-7V9fymmLJKwi6nMHwJ3UUHLicUSZuD1Zc
{
"category_id": "00000000-0000-0000-0000-000000000768",
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"inventory_tracking_method": "PACKAGE",
"menu_visibility": "INCLUDE_IN_SELECT",
"menus": [
"00000000-0000-0000-0000-000000000013"
],
"name": "My Product",
"sku": "12345",
"unit_price": "100",
"unit_type_id": "00000000-0000-0000-0000-000000009ed1",
"upc": "036000291452",
"vendor_id": "00000000-0000-0000-0000-000000000961"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 8f60bb3c0c8528000000000000000001-3f48304eeeb7ce1d-0
{
"data": {
"brand": null,
"category": {
"id": "00000000-0000-0000-0000-000000000768",
"name": "Some category 72",
"type": "OTHER"
},
"custom_data": [],
"description": null,
"description_markdown": null,
"external_name": null,
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"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-000000009ed1",
"name": "Gram"
},
"units_per_case": null,
"updated_datetime": "2025-09-17T15:12:38.459261Z",
"vendor": {
"id": "00000000-0000-0000-0000-000000000961",
"name": "Company 231",
"updated_datetime": "2025-09-17T15:12:38.199247Z"
}
}
}
POST /public/v1/orders Menus act as expected
POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTI5MGY4MzItMGRkYy00ZmZmLTllNDctODlhN2JjYmYzNDVkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU5MiIsInR5cCI6ImFjY2VzcyJ9.ZKbEDlQYn-7V9fymmLJKwi6nMHwJ3UUHLicUSZuD1Zc
{
"category_id": "00000000-0000-0000-0000-000000000768",
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"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-000000009ed1",
"upc": "036000291452",
"vendor_id": "00000000-0000-0000-0000-000000000961"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 8f60bb3c0c8528000000000000000001-c580f0839f8ebf59-0
{
"data": {
"brand": null,
"category": {
"id": "00000000-0000-0000-0000-000000000768",
"name": "Some category 72",
"type": "OTHER"
},
"custom_data": [],
"description": null,
"description_markdown": null,
"external_name": null,
"id": "449e3a8c-cf87-409c-a898-0e399b6b5085",
"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-000000009ed1",
"name": "Gram"
},
"units_per_case": null,
"updated_datetime": "2025-09-17T15:12:38.489438Z",
"vendor": {
"id": "00000000-0000-0000-0000-000000000961",
"name": "Company 231",
"updated_datetime": "2025-09-17T15:12:38.199247Z"
}
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZmIwYmM5MTUtNGYxMC00NWI4LTk4ZjgtZjdjZTZiM2ViYjEzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzk4NCIsInR5cCI6ImFjY2VzcyJ9.l43-sf66wxCHgtOh0wGJcn3Jnw3yXEITIqQimfoCLoM
{
"id": "90f4096a-8606-4e52-9a94-5319375de4b3",
"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: 82ba5be4450628000000000000000001-1fe5e179291724a5-0
{
"errors": [
{
"context": {
"id": "90f4096a-8606-4e52-9a94-5319375de4b3"
},
"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": "90f4096a-8606-4e52-9a94-5319375de4b3"
},
"message": "Unit Serving Size can't be greater than Unit Net Weight/Volume",
"pointer": [
"unit_serving_size"
],
"section": "body"
},
{
"context": {
"id": "90f4096a-8606-4e52-9a94-5319375de4b3"
},
"message": "Cannot be negative",
"pointer": [
"quantity_available_threshold_max"
],
"section": "body"
},
{
"context": {
"id": "90f4096a-8606-4e52-9a94-5319375de4b3"
},
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZTVhOWE2OWUtMDljNC00OGQ0LWIwMDgtZmM1MGQ3ZDJkNTkzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc3NiIsInR5cCI6ImFjY2VzcyJ9.t-MNC9E8NJV3wlP6u8uilgS1eXETiZY8PaQQcZ8lqnY
{
"id": "82894953-dd35-477a-893f-0135e4e81f43",
"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: b43a05f520fe18000000000000000001-fc8f28d75e337b97-0
{
"errors": [
{
"context": {
"id": "82894953-dd35-477a-893f-0135e4e81f43"
},
"message": "Must be greater than threshold min",
"pointer": [
"quantity_available_threshold_max"
],
"section": "body"
},
{
"context": {
"id": "82894953-dd35-477a-893f-0135e4e81f43"
},
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMjFjYmMzYTItZmQyMS00NjJlLWFmZDUtNDU1MDg4MDMxMGQ3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc5MyIsInR5cCI6ImFjY2VzcyJ9.ZhTzuBcxyPuA_vaUFjcr0Ggs0yc_Lq2i1-SLcplQj6o
{
"brand_id": "00000000-0000-0000-0000-0000000009ca",
"category_id": "00000000-0000-0000-0000-0000000007c5",
"cbd": "5.2",
"description": "My Product Description",
"description_markdown": "# My Product Description Markdown",
"group_id": "00000000-0000-0000-0000-000000000744",
"id": "47d12196-cb98-448b-b376-928fa9f09663",
"inventory_tracking_method": "PACKAGE",
"is_featured": true,
"is_inactive": true,
"menu_visibility": "INCLUDE_IN_ALL",
"menus": [
"00000000-0000-0000-0000-000000000015",
"00000000-0000-0000-0000-000000000016",
"00000000-0000-0000-0000-000000000017"
],
"msrp": "100.5",
"name": "My Product",
"owner_id": "00000000-0000-0000-0000-000000000ed6",
"quantity_available_threshold_max": "10.5",
"quantity_available_threshold_min": "5.5555",
"sku": "12345",
"strain_id": "00000000-0000-0000-0000-000000000048",
"subcategory_id": "00000000-0000-0000-0000-0000000007ba",
"tags": [
"00000000-0000-0000-0000-00000000000c",
"00000000-0000-0000-0000-00000000000d",
"00000000-0000-0000-0000-00000000000e"
],
"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-00000000a78b",
"unit_price": "100",
"unit_serving_size": "2.2",
"unit_type_id": "00000000-0000-0000-0000-00000000a792",
"units_per_case": "0.2",
"upc": "036000291452",
"vendor_id": "00000000-0000-0000-0000-0000000009c7",
"wholesale_unit_price": "90.50"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 100c35b6a2b52f000000000000000001-b260444ee5a03362-0
{
"errors": [
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"message": "Brand does not exist",
"pointer": [
"brand_id"
],
"section": "body"
},
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"message": "Category does not exist",
"pointer": [
"category_id"
],
"section": "body"
},
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"message": "Vendor does not exist",
"pointer": [
"vendor_id"
],
"section": "body"
},
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"message": "Group does not exist",
"pointer": [
"group_id"
],
"section": "body"
},
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"message": "Serving unit type does not exist",
"pointer": [
"unit_net_weight_and_serving_size_unit_type_id"
],
"section": "body"
},
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"message": "Owner does not exist",
"pointer": [
"owner_id"
],
"section": "body"
},
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"message": "Strain does not exist",
"pointer": [
"strain_id"
],
"section": "body"
},
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"message": "Subcategory does not belong to the product category",
"pointer": [
"subcategory_id"
],
"section": "body"
},
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"message": "One or more of the provided tags do not exist",
"pointer": [
"tags"
],
"section": "body"
},
{
"context": {
"id": "47d12196-cb98-448b-b376-928fa9f09663"
},
"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-000000000015"
],
"section": "body"
},
{
"context": {},
"message": "Menu does not exist",
"pointer": [
"menus",
1,
"00000000-0000-0000-0000-000000000016"
],
"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 | Default | 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/25
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNWExYjExYWMtZWNiZi00ZGIxLTkxNWItYTdmNWRhYTRmNjhjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU4OCIsInR5cCI6ImFjY2VzcyJ9.MIGA_1k6pPRriy4a5sRLSC-jqjTukRaLCrraaHHKp8c
Response
204
cache-control: max-age=0, private, must-revalidate
b3: 6b49dd5385d914000000000000000001-22bf342e7ff8a26d-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjI0NzZiMjktY2M0YS00Mzk5LTllMDAtMjVhOWY5NjEwMmI5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzQ2NCIsInR5cCI6ImFjY2VzcyJ9.Wp4_EFGXOGC1WCJb1uQ8uoTZkNV45UsIa3AWTxTgimw
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 8b75d2ca6fca38000000000000000001-9ed2b942b0151d98-0
{
"data": [
{
"blaze_asset_id": null,
"blaze_product_id": "blaze_123",
"blaze_retailer_id": "69e4884c-4b65-47e9-be66-d1de65912ad9",
"id": 20,
"inserted_at": "2025-09-17T15:12:37.809458Z",
"pos_type": "BLAZE",
"product_id": "3c102ef2-5cb7-452f-a294-d4f566368de3",
"updated_at": "2025-09-17T15:12:37.809458Z"
},
{
"dutchie_product_id": 456,
"dutchie_retailer_id": "5ff25757-02bb-46e7-bb98-6c56b0ad0d88",
"id": 21,
"inserted_at": "2025-09-17T15:12:37.878295Z",
"pos_type": "DUTCHIE",
"product_id": "6501f220-c8c9-4c34-bffe-30a10dcd36d4",
"updated_at": "2025-09-17T15:12:37.878295Z"
}
],
"next_page": "https://www.example.com/public/v1/product-pos-mappings?page[number]=2"
}
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 | Default | Example |
---|---|---|---|---|---|---|
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiM2Q3YmJmYzgtOWUzMC00MzkyLTkyZjYtN2E2MzY4NDU4N2ZmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU1NiIsInR5cCI6ImFjY2VzcyJ9.fTpWmgOzzWjvCIdtlMizHauKt4YMgtxXRtQFa8f_qv0
{
"blaze_product_id": "blaze_123",
"blaze_retailer_id": "7be357ec-fa75-41bc-b55d-aa4e25347221",
"product_id": "68acc7c4-8f0c-41cd-96e4-4c1c5cf9731b"
}
Response
201
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: aaaadb36174070000000000000000001-955e39bf44b95883-0
{
"data": {
"blaze_asset_id": null,
"blaze_product_id": "blaze_123",
"blaze_retailer_id": "7be357ec-fa75-41bc-b55d-aa4e25347221",
"id": 24,
"inserted_at": "2025-09-17T15:12:38.101471Z",
"pos_type": "BLAZE",
"product_id": "68acc7c4-8f0c-41cd-96e4-4c1c5cf9731b",
"updated_at": "2025-09-17T15:12:38.101471Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMDdiN2I2MTYtY2Y3NS00N2ZmLTliN2ItNzU0NTgzNGUwYmZjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzU0MiIsInR5cCI6ImFjY2VzcyJ9.IWJrzrg8_qvAeRt3YNpVWu0qyzoHIpqN7iuCc9uCeJE
{
"blaze_product_id": "blaze_456",
"blaze_retailer_id": "07a52fcb-323a-4979-b4eb-13b25ab18854",
"product_id": "2605f6f3-7d3f-4f41-905f-0ef435ef9515"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 26c39133c0b51c000000000000000001-fb1823cf4c8f99a6-0
{
"data": {
"blaze_asset_id": null,
"blaze_product_id": "blaze_456",
"blaze_retailer_id": "07a52fcb-323a-4979-b4eb-13b25ab18854",
"id": 23,
"inserted_at": "2025-09-17T15:12:38.048382Z",
"pos_type": "BLAZE",
"product_id": "2605f6f3-7d3f-4f41-905f-0ef435ef9515",
"updated_at": "2025-09-17T15:12:38.056566Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjEsImlhdCI6MTc1ODEyMTk2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjhjOTlmYTEtMjlkZC00MjZjLTlkYmItZWJmYzIxYjRkNGViIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDIwMiIsInR5cCI6ImFjY2VzcyJ9.AT6s1aNCqsYXb89xJatR5citHpSaMAxvUsejgvFQubk
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: c19bdc1f199a58000000000000000001-c0b7c6c43c1b7c8b-0
{
"data": [
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000aba",
"name": "Company 723",
"updated_datetime": "2025-09-17T15:12:41.121401Z"
},
"custom_data": [
{
"id": 41,
"name": "Custom Field 10",
"value": null
}
],
"due_datetime": "2025-09-17T15:12:41.142793Z",
"id": "00000000-0000-0000-0000-000000000081",
"inserted_datetime": "2025-09-17T15:12:41.143513Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008e6",
"name": "B1241"
},
"compliance_quantity": null,
"id": "3aa62b68-6324-49e6-8c73-0b4005de504f",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e28",
"id": "00000000-0000-0000-0000-0000000004c7",
"license_id": null,
"name": "Place 237"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "f21347e6-903b-4275-9425-6e580e49a177",
"name": "Product 1232",
"sku": "sku 1233",
"updated_datetime": "2025-09-17T15:12:41.148822Z"
},
"quantity": "15.000000000",
"received_quantity": "0.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008e7",
"name": "B1242"
},
"compliance_quantity": null,
"id": "f977d31c-49ac-4bdd-a73c-112155da9a53",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e28",
"id": "00000000-0000-0000-0000-0000000004c7",
"license_id": null,
"name": "Place 237"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "88f5441a-9755-4e12-9cab-2fa9e81f9d55",
"name": "Product 1235",
"sku": "sku 1236",
"updated_datetime": "2025-09-17T15:12:41.155017Z"
},
"quantity": "10.000000000",
"received_quantity": "0.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008e8",
"name": "B1243"
},
"compliance_quantity": null,
"id": "197ea15c-fe27-4729-bd03-64dd31e44fc2",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e28",
"id": "00000000-0000-0000-0000-0000000004c7",
"license_id": null,
"name": "Place 237"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "3fd676f9-cfa3-47eb-81ce-d24e1d8c7d9f",
"name": "Product 1237",
"sku": "sku 1238",
"updated_datetime": "2025-09-17T15:12:41.161069Z"
},
"quantity": "5.000000000",
"received_quantity": "0.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008e9",
"name": "B1244"
},
"compliance_quantity": null,
"id": "27d6f2b8-fe2c-494d-8b9f-e9b7a1a61ea4",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e28",
"id": "00000000-0000-0000-0000-0000000004c7",
"license_id": null,
"name": "Place 237"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "f3d4fd18-41a4-4998-bb8a-1fe6e7f81019",
"name": "Product 1239",
"sku": "sku 1240",
"updated_datetime": "2025-09-17T15:12:41.166577Z"
},
"quantity": "2.000000000",
"received_quantity": "0.000000000"
}
],
"order_datetime": "2025-09-17T15:12:41.142792Z",
"purchase_number": "Purchase #18",
"status": "PENDING",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:41.143513Z"
},
{
"charges": [
{
"id": "b695836c-7664-4fca-92c5-c0ac711c1eb3",
"name": "C1",
"percent": "10.0000",
"price": "1.00",
"type": "CHARGE",
"unit_type": "PERCENT"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000ab8",
"name": "Company 721",
"updated_datetime": "2030-11-01T00:00:00.000000Z"
},
"custom_data": [
{
"id": 41,
"name": "Custom Field 10",
"value": "Custom Field Value 1"
}
],
"due_datetime": "2020-01-01T00:00:01.000000Z",
"id": "00000000-0000-0000-0000-000000000080",
"inserted_datetime": "2020-01-01T00:00:03.000000Z",
"items": [
{
"batch": {
"batch_number": "UID1",
"id": "00000000-0000-0000-0000-0000000008e3",
"name": "B1"
},
"compliance_quantity": "1.0000",
"id": "153cdb09-b37a-44fb-8583-29c5c769dd7c",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000e28",
"id": "00000000-0000-0000-0000-0000000004c0",
"license_id": "00000000-0000-0000-0000-0000000001b8",
"name": "Place 230"
},
"package": {
"batch_number": "B1",
"compliance_label": "ABCDEF012345670000000157",
"id": "00000000-0000-0000-0000-000000000107",
"metrc_label": "ABCDEF012345670000000157",
"status": "active"
},
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "1e624a52-15b0-4638-b886-b20a30b40fc7",
"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"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjMsImlhdCI6MTc1ODEyMTk2MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZTk2OTNmMGUtYzdlYy00ZDhjLWE2ZmUtNTFjNjgyYmQ2NmZlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDUxNyIsInR5cCI6ImFjY2VzcyJ9.cCoYeyE4nz4lXPeKddaIqySYhXpIaxzxKfnBrspKoOg
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: a876b9aa036458000000000000000001-7e8b33b06e41b3df-0
{
"data": [
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000bd0",
"name": "Company 1044",
"updated_datetime": "2025-09-17T15:12:43.322672Z"
},
"custom_data": [],
"due_datetime": "2025-09-17T15:12:43.340215Z",
"id": "00000000-0000-0000-0000-0000000000a1",
"inserted_datetime": "2025-09-17T15:12:43.340896Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009b2",
"name": "B1853"
},
"compliance_quantity": null,
"id": "7167444f-dc42-402d-91aa-2678c131a50a",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-000000000550",
"license_id": null,
"name": "Place 374"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "1eb485a9-ec9f-4cd2-938a-b204b82e21b7",
"name": "Product 1842",
"sku": "sku 1843",
"updated_datetime": "2025-09-17T15:12:43.346459Z"
},
"quantity": "15.000000000",
"received_quantity": "0.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009b3",
"name": "B1854"
},
"compliance_quantity": null,
"id": "8eaf7c9c-37ec-43a4-8708-8c01ba227068",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-000000000550",
"license_id": null,
"name": "Place 374"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "8e671b2a-f01b-4db5-b6e9-ad0a4e8fab9f",
"name": "Product 1844",
"sku": "sku 1845",
"updated_datetime": "2025-09-17T15:12:43.351710Z"
},
"quantity": "10.000000000",
"received_quantity": "0.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009b4",
"name": "B1855"
},
"compliance_quantity": null,
"id": "9730851a-67dd-4bf7-bc38-fe514d753476",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-000000000550",
"license_id": null,
"name": "Place 374"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "9c4a085d-4cb4-4bc3-9119-c9e556a4107b",
"name": "Product 1848",
"sku": "sku 1849",
"updated_datetime": "2025-09-17T15:12:43.356851Z"
},
"quantity": "5.000000000",
"received_quantity": "0.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009b5",
"name": "B1856"
},
"compliance_quantity": null,
"id": "32e6f522-4ad1-4da0-9a21-e0c344553bb9",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-000000000550",
"license_id": null,
"name": "Place 374"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "d307ded2-6a6b-462d-8f14-70d25fab1b36",
"name": "Product 1851",
"sku": "sku 1852",
"updated_datetime": "2025-09-17T15:12:43.362800Z"
},
"quantity": "2.000000000",
"received_quantity": "0.000000000"
}
],
"order_datetime": "2020-01-01T12:30:00.000000Z",
"purchase_number": "Purchase #48",
"status": "PENDING",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:43.340896Z"
},
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000bc5",
"name": "Company 1033",
"updated_datetime": "2025-09-17T15:12:43.264421Z"
},
"custom_data": [],
"due_datetime": "2025-09-17T15:12:43.283060Z",
"id": "00000000-0000-0000-0000-0000000000a0",
"inserted_datetime": "2025-09-17T15:12:43.283712Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009a9",
"name": "B1826"
},
"compliance_quantity": null,
"id": "bad26596-94ce-4393-9e47-af26432f8247",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-00000000054d",
"license_id": null,
"name": "Place 371"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "fbe44073-da2e-4ede-81f6-3363931d0497",
"name": "Product 1815",
"sku": "sku 1816",
"updated_datetime": "2025-09-17T15:12:43.288848Z"
},
"quantity": "15.000000000",
"received_quantity": "15.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009aa",
"name": "B1827"
},
"compliance_quantity": null,
"id": "f0caa466-fa00-4e79-8534-86cc00bd1b7b",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-00000000054d",
"license_id": null,
"name": "Place 371"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "7e96f819-3417-498e-918b-88771b940453",
"name": "Product 1817",
"sku": "sku 1818",
"updated_datetime": "2025-09-17T15:12:43.294664Z"
},
"quantity": "10.000000000",
"received_quantity": "10.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009ab",
"name": "B1828"
},
"compliance_quantity": null,
"id": "bacb18da-9b8f-4970-9578-c1c0d890f298",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-00000000054d",
"license_id": null,
"name": "Place 371"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "9bf0f3f5-2a53-4cf8-8e95-cbbb12197576",
"name": "Product 1821",
"sku": "sku 1822",
"updated_datetime": "2025-09-17T15:12:43.300493Z"
},
"quantity": "5.000000000",
"received_quantity": "5.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009ac",
"name": "B1829"
},
"compliance_quantity": null,
"id": "dc79308b-c4e4-43ef-9df7-0f393a1f60b1",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-00000000054d",
"license_id": null,
"name": "Place 371"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "e5763ff6-9739-4ec9-afe5-60df8a39e759",
"name": "Product 1824",
"sku": "sku 1825",
"updated_datetime": "2025-09-17T15:12:43.306182Z"
},
"quantity": "2.000000000",
"received_quantity": "2.000000000"
}
],
"order_datetime": "2020-01-01T12:20:00.000000Z",
"purchase_number": "Purchase #47",
"status": "COMPLETED",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:43.283712Z"
},
{
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000ba7",
"name": "Company 1002",
"updated_datetime": "2025-09-17T15:12:43.117027Z"
},
"custom_data": [],
"due_datetime": "2025-09-17T15:12:43.157313Z",
"id": "00000000-0000-0000-0000-00000000009e",
"inserted_datetime": "2025-09-17T15:12:43.157988Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000997",
"name": "B1772"
},
"compliance_quantity": null,
"id": "be78b3f4-05c1-42b2-9304-766f7ffecc1d",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-000000000544",
"license_id": null,
"name": "Place 362"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "fd96bd88-d96e-4364-87d4-5a86f0e553c0",
"name": "Product 1764",
"sku": "sku 1765",
"updated_datetime": "2025-09-17T15:12:43.164338Z"
},
"quantity": "15.000000000",
"received_quantity": "15.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000998",
"name": "B1773"
},
"compliance_quantity": null,
"id": "411ca6ef-9b9f-4d97-aae5-2c114fa23ed8",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-000000000544",
"license_id": null,
"name": "Place 362"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "a716138d-5658-48ee-bf31-beb108c01358",
"name": "Product 1766",
"sku": "sku 1767",
"updated_datetime": "2025-09-17T15:12:43.170634Z"
},
"quantity": "10.000000000",
"received_quantity": "10.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000999",
"name": "B1774"
},
"compliance_quantity": null,
"id": "754b0fc4-5f31-42de-90c5-4cd4f2dd1425",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-000000000544",
"license_id": null,
"name": "Place 362"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "17abc37a-3dd6-4395-a281-e9c28abd4461",
"name": "Product 1768",
"sku": "sku 1769",
"updated_datetime": "2025-09-17T15:12:43.177105Z"
},
"quantity": "5.000000000",
"received_quantity": "5.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000099a",
"name": "B1775"
},
"compliance_quantity": null,
"id": "721fdf3a-81db-4edd-9e69-f36dc1fdf403",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f44",
"id": "00000000-0000-0000-0000-000000000544",
"license_id": null,
"name": "Place 362"
},
"package": null,
"price": "10.000000000",
"price_base": "10",
"product": {
"id": "ca5e6ef0-86d4-48a5-8394-1720587e10e6",
"name": "Product 1770",
"sku": "sku 1771",
"updated_datetime": "2025-09-17T15:12:43.183332Z"
},
"quantity": "2.000000000",
"received_quantity": "2.000000000"
}
],
"order_datetime": "2020-01-01T12:00:00.000000Z",
"purchase_number": "Purchase #45",
"status": "COMPLETED",
"total": "32.00",
"updated_datetime": "2025-09-17T15:12:43.157988Z"
}
],
"next_page": null
}
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 | Default | 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-00000000006e/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNmUxOTU4NmYtZDMwYi00ZTVmLWFhMGEtZDk3ZDU2NDllZWQzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzUzMCIsInR5cCI6ImFjY2VzcyJ9.1pff2PHUiAFg__aiZwJz-Uz5Ih-la4oSk2ybLD988I0
{
"amount": 100.01,
"description": "Payment for purchase",
"payment_datetime": "2020-01-01T00:00:00.000000Z",
"payment_method_id": "00000000-0000-0000-0000-00000000001d",
"quickbooks_deposit_account_id": "QBD-123"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 6a91584360a3ac000000000000000001-2429acee202b27ef-0
{
"data": {
"amount": "100.01",
"description": "Payment for purchase",
"id": "00000000-0000-0000-0000-000000000005",
"inserted_datetime": "2025-09-17T15:12:38.188243Z",
"payment_date": "2020-01-01T00:00:00.000000Z",
"payment_method": {
"id": "00000000-0000-0000-0000-00000000001d",
"name": "Payment Method 0"
},
"payment_number": "PYT-0000001",
"purchase_id": "00000000-0000-0000-0000-00000000006e",
"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-00000000006e/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNmUxOTU4NmYtZDMwYi00ZTVmLWFhMGEtZDk3ZDU2NDllZWQzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzUzMCIsInR5cCI6ImFjY2VzcyJ9.1pff2PHUiAFg__aiZwJz-Uz5Ih-la4oSk2ybLD988I0
{
"amount": 100.01,
"description": "Payment for purchase",
"payment_datetime": "2020-01-01T00:00:00.000000Z",
"payment_method_id": "00000000-0000-0000-0000-00000000001d",
"quickbooks_deposit_account_name": "QBD-NAME"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 6a91584360a3ac000000000000000001-f1f05e14bacd504a-0
{
"data": {
"amount": "100.01",
"description": "Payment for purchase",
"id": "00000000-0000-0000-0000-000000000006",
"inserted_datetime": "2025-09-17T15:12:38.355105Z",
"payment_date": "2020-01-01T00:00:00.000000Z",
"payment_method": {
"id": "00000000-0000-0000-0000-00000000001d",
"name": "Payment Method 0"
},
"payment_number": "PYT-0000002",
"purchase_id": "00000000-0000-0000-0000-00000000006e",
"quickbooks_deposit_account_id": "QBD-123"
}
}
Request
POST /public/v1/purchases/{id}/payments
Parameters
Parameter | Description | In | Type | Required | Default | Example |
---|---|---|---|---|---|---|
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjEsImlhdCI6MTc1ODEyMTk2MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzdjMTc3ZGQtNmI3OC00MjkyLThjN2QtNmQ5YzBiNzU5MDViIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDMzOCIsInR5cCI6ImFjY2VzcyJ9.GktwupVo9fMBONzVmavizcVPpDr7E61SqA9z--wacvY
{
"billing_location_id": "00000000-0000-0000-0000-0000000004f6",
"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-000000000b28",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-0000000004f5",
"price": "10.000000000",
"product_id": "dffaf52c-0bfa-4a5f-905e-5997b89f5d51",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-0000000004f5",
"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: 7e0a703b843598000000000000000001-caa3d59daa810e92-0
{
"data": {
"charges": [
{
"id": "a01d569e-a8d0-4019-8fec-aec23028e660",
"name": "C1",
"percent": "10.0000",
"price": "1.00",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "f130b93b-36a3-4c91-9940-e54c5848f552",
"name": "C2",
"percent": null,
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000b28",
"name": "Company 849",
"updated_datetime": "2025-09-17T15:12:41.895411Z"
},
"custom_data": [
{
"id": 42,
"name": "Custom Field 11",
"value": null
}
],
"due_datetime": "2020-01-30T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-00000000008c",
"inserted_datetime": "2025-09-17T15:12:41.934041Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-00000000093c",
"name": "B1"
},
"compliance_quantity": null,
"id": "ba4c117d-da9e-4f7b-97a5-68e02c8893fa",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000eac",
"id": "00000000-0000-0000-0000-0000000004f5",
"license_id": "00000000-0000-0000-0000-0000000001c1",
"name": "Place 283"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "dffaf52c-0bfa-4a5f-905e-5997b89f5d51",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:41.919958Z"
},
"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-09-17T15:12:41.940432Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjIsImlhdCI6MTc1ODEyMTk2MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGVkM2U5MmItNWExZS00ZWI0LWIyN2MtYzkzNzg1ZTdmYzZkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDQzMSIsInR5cCI6ImFjY2VzcyJ9.CsfLBvJf5xgzAsmdhBRNlJbvmGL6rcgpugxyvuYWAYk
{
"billing_location_id": "00000000-0000-0000-0000-00000000051f",
"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-000000000b72",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"items": [
{
"batch_id": "00000000-0000-0000-0000-000000000970",
"location_id": "00000000-0000-0000-0000-00000000051f",
"price": "10.000000000",
"product_id": "7d6cb023-6dec-416c-9597-848db0300856",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-00000000051f",
"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: 736e15e6c0be98000000000000000001-8d72fc2a1fa8a446-0
{
"data": {
"charges": [
{
"id": "d65bf34e-7188-485d-87aa-a96a6273c8e2",
"name": "C1",
"percent": "10.0000",
"price": "1.00",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "f160ff8e-eb17-4eea-a552-495f51584172",
"name": "C2",
"percent": null,
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000b72",
"name": "Company 935",
"updated_datetime": "2025-09-17T15:12:42.477407Z"
},
"custom_data": [],
"due_datetime": "2020-01-30T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-000000000099",
"inserted_datetime": "2025-09-17T15:12:42.777452Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000970",
"name": "B1"
},
"compliance_quantity": null,
"id": "b6317c04-f27e-4a2d-9d75-a4bb10058bb4",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f04",
"id": "00000000-0000-0000-0000-00000000051f",
"license_id": "00000000-0000-0000-0000-0000000001ca",
"name": "Place 325"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "7d6cb023-6dec-416c-9597-848db0300856",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:42.759452Z"
},
"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-09-17T15:12:42.784695Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjMsImlhdCI6MTc1ODEyMTk2MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzM5ODVkMzAtMWY1Ny00MjA1LWI0NjMtYzU0MDZhYzAxOTZjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDU2OCIsInR5cCI6ImFjY2VzcyJ9.z8PkNrVXfyPoTi5zYgGszccXP1TWTndSaVJTSMyLZUA
{
"billing_location_id": "00000000-0000-0000-0000-000000000554",
"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-000000000bde",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-000000000554",
"price": "10.000000000",
"product_id": "5f9a7a2a-8c19-4872-8a55-ee3eaa8224b3",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-000000000554",
"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: 61637f37e45e64000000000000000001-02577bde571e0f25-0
{
"data": {
"charges": [
{
"id": "695937fa-5b04-40c8-ad34-6a38b2061b3f",
"name": "C1",
"percent": "10.0000",
"price": "1.00",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "b86da391-41df-4716-b8bf-4df8f585359a",
"name": "C2",
"percent": null,
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company": {
"id": "00000000-0000-0000-0000-000000000bde",
"name": "Company 1060",
"updated_datetime": "2025-09-17T15:12:43.404979Z"
},
"custom_data": [],
"due_datetime": "2020-01-30T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-0000000000a2",
"inserted_datetime": "2025-09-17T15:12:43.438855Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000009bb",
"name": "B1"
},
"compliance_quantity": null,
"id": "4963566d-a0bc-4299-8099-a7ebb7c65b9f",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000f80",
"id": "00000000-0000-0000-0000-000000000554",
"license_id": "00000000-0000-0000-0000-0000000001de",
"name": "Place 378"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "5f9a7a2a-8c19-4872-8a55-ee3eaa8224b3",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:43.425443Z"
},
"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-09-17T15:12:43.443592Z"
}
}
POST /public/v1/purchases updates a purchase
POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDM1ZDlkY2QtYzcyMy00OWU2LThlYjgtNDNmOTM2MzBmY2EyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzgxOSIsInR5cCI6ImFjY2VzcyJ9.2EfYUtgMj6CLDddupTy0bQBuwIXKEhpVePiG5AHI1Eo
{
"billing_location_id": "00000000-0000-0000-0000-000000000445",
"charges": [
{
"name": "C1",
"percent": "10.0000",
"type": "CHARGE",
"unit_type": "PERCENT"
}
],
"company_id": "00000000-0000-0000-0000-0000000009cb",
"due_datetime": "2020-01-20T00:00:00.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-000000000445",
"price": "10.000000000",
"product_id": "1ac7ed54-192a-4148-b2a8-8a392b27cee6",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-000000000445",
"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: 63e937158b3474000000000000000001-340e55fe08b5edaa-0
{
"data": {
"charges": [
{
"id": "13f0c360-ba9c-467b-b585-1553ebae9cd0",
"name": "C1",
"percent": "10.0000",
"price": "1.00",
"type": "CHARGE",
"unit_type": "PERCENT"
}
],
"company": {
"id": "00000000-0000-0000-0000-0000000009cb",
"name": "Company 402",
"updated_datetime": "2025-09-17T15:12:38.984485Z"
},
"custom_data": [],
"due_datetime": "2020-01-20T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-000000000074",
"inserted_datetime": "2025-09-17T15:12:39.066507Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000007ff",
"name": "B1"
},
"compliance_quantity": null,
"id": "a18e3caf-dec2-402f-b6ef-2264b41710ba",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000ced",
"id": "00000000-0000-0000-0000-000000000445",
"license_id": "00000000-0000-0000-0000-00000000017c",
"name": "Place 108"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "1ac7ed54-192a-4148-b2a8-8a392b27cee6",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:39.025142Z"
},
"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-09-17T15:12:39.081312Z"
}
}
POST /public/v1/purchases updates a purchase
POST /public/v1/purchases
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDM1ZDlkY2QtYzcyMy00OWU2LThlYjgtNDNmOTM2MzBmY2EyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzgxOSIsInR5cCI6ImFjY2VzcyJ9.2EfYUtgMj6CLDddupTy0bQBuwIXKEhpVePiG5AHI1Eo
{
"billing_location_id": "00000000-0000-0000-0000-000000000445",
"charges": [
{
"id": "13f0c360-ba9c-467b-b585-1553ebae9cd0",
"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-0000000009cb",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-000000000074",
"items": [
{
"id": "a18e3caf-dec2-402f-b6ef-2264b41710ba",
"location_id": "00000000-0000-0000-0000-000000000445",
"price": "10.000000000",
"product_id": "1ac7ed54-192a-4148-b2a8-8a392b27cee6",
"quantity": "1.000000000"
},
{
"batch_id": "00000000-0000-0000-0000-000000000803",
"location_id": "00000000-0000-0000-0000-000000000445",
"price": "5.000000000",
"product_id": "b16ef6f9-fbd5-4bbb-a3d9-3f1e07d369b5",
"quantity": "2.000000000"
}
],
"location_id": "00000000-0000-0000-0000-000000000445",
"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: 63e937158b3474000000000000000001-d9b10dc8057ef434-0
{
"data": {
"charges": [
{
"id": "13f0c360-ba9c-467b-b585-1553ebae9cd0",
"name": "C1",
"percent": "10.0000",
"price": "2.00",
"type": "CHARGE",
"unit_type": "PERCENT"
},
{
"id": "8917b978-7ad7-48a5-b030-0a9765fbc1da",
"name": "C2",
"percent": null,
"price": "-5.00",
"type": "DISCOUNT",
"unit_type": "PRICE"
}
],
"company": {
"id": "00000000-0000-0000-0000-0000000009cb",
"name": "Company 402",
"updated_datetime": "2025-09-17T15:12:38.984485Z"
},
"custom_data": [],
"due_datetime": "2020-01-30T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-000000000074",
"inserted_datetime": "2025-09-17T15:12:39.066507Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000007ff",
"name": "B1"
},
"compliance_quantity": null,
"id": "a18e3caf-dec2-402f-b6ef-2264b41710ba",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000ced",
"id": "00000000-0000-0000-0000-000000000445",
"license_id": "00000000-0000-0000-0000-00000000017c",
"name": "Place 108"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "1ac7ed54-192a-4148-b2a8-8a392b27cee6",
"name": "P1",
"sku": "SKU1",
"updated_datetime": "2025-09-17T15:12:39.025142Z"
},
"quantity": "1.000000000",
"received_quantity": "0.000000000"
},
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-000000000803",
"name": "B2"
},
"compliance_quantity": null,
"id": "618f733d-67a2-47df-af2e-ef58aff7fad5",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000ced",
"id": "00000000-0000-0000-0000-000000000445",
"license_id": "00000000-0000-0000-0000-00000000017c",
"name": "Place 108"
},
"package": null,
"price": "5.000000000",
"price_base": "5.000000000",
"product": {
"id": "b16ef6f9-fbd5-4bbb-a3d9-3f1e07d369b5",
"name": "P2",
"sku": "SKU2",
"updated_datetime": "2025-09-17T15:12:39.043640Z"
},
"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-09-17T15:12:39.361980Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiN2YzMTQ5OTQtM2ViMS00MTc3LWE4NTQtNDVlZTAyMWJkMmZjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA5MCIsInR5cCI6ImFjY2VzcyJ9.i9OufF0dFJ2NuQiBpsrnRN-gl32uuNSuPcvA8OIUsC0
{
"billing_location_id": "00000000-0000-0000-0000-000000000495",
"company_id": "00000000-0000-0000-0000-000000000a70",
"due_datetime": "2020-01-20T00:00:00.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-000000000495",
"price": "10",
"product_id": "1f7d7c18-4084-4ad6-a471-6d42cf93d175",
"quantity": "1"
}
],
"location_id": "00000000-0000-0000-0000-000000000495",
"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: 18f27e7aa28807000000000000000001-54811447cad6d319-0
{
"data": {
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000a70",
"name": "Company 632",
"updated_datetime": "2025-09-17T15:12:40.474798Z"
},
"custom_data": [],
"due_datetime": "2020-01-20T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-00000000007b",
"inserted_datetime": "2025-09-17T15:12:40.517921Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008a9",
"name": "B1056"
},
"compliance_quantity": null,
"id": "eeefdf7b-9c90-4f28-ae01-ef43c68e028a",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000dd3",
"id": "00000000-0000-0000-0000-000000000495",
"license_id": "00000000-0000-0000-0000-00000000019e",
"name": "Place 188"
},
"package": null,
"price": "10.000000000",
"price_base": "10.000000000",
"product": {
"id": "1f7d7c18-4084-4ad6-a471-6d42cf93d175",
"name": "Product 1053",
"sku": "sku 1054",
"updated_datetime": "2025-09-17T15:12:40.501249Z"
},
"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-09-17T15:12:40.517921Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiN2YzMTQ5OTQtM2ViMS00MTc3LWE4NTQtNDVlZTAyMWJkMmZjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA5MCIsInR5cCI6ImFjY2VzcyJ9.i9OufF0dFJ2NuQiBpsrnRN-gl32uuNSuPcvA8OIUsC0
{
"company_id": "00000000-0000-0000-0000-000000000a70",
"id": "00000000-0000-0000-0000-00000000007b",
"items": [
{
"location_id": "00000000-0000-0000-0000-000000000495",
"price": "2",
"product_id": "1f7d7c18-4084-4ad6-a471-6d42cf93d175",
"quantity": "1"
}
]
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 18f27e7aa28807000000000000000001-404e666a167c8e7d-0
{
"data": {
"charges": [],
"company": {
"id": "00000000-0000-0000-0000-000000000a70",
"name": "Company 632",
"updated_datetime": "2025-09-17T15:12:40.474798Z"
},
"custom_data": [],
"due_datetime": "2020-01-20T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-00000000007b",
"inserted_datetime": "2025-09-17T15:12:40.517921Z",
"items": [
{
"batch": {
"batch_number": null,
"id": "00000000-0000-0000-0000-0000000008a9",
"name": "B1056"
},
"compliance_quantity": null,
"id": "d3f9581b-197f-42ef-954c-b168998b64df",
"is_sample": false,
"location": {
"address": "123 Fake Street, Beverly Hills, CA 88888, USA",
"company_id": "00000000-0000-0000-0000-000000000dd3",
"id": "00000000-0000-0000-0000-000000000495",
"license_id": "00000000-0000-0000-0000-00000000019e",
"name": "Place 188"
},
"package": null,
"price": "2.000000000",
"price_base": "2.000000000",
"product": {
"id": "1f7d7c18-4084-4ad6-a471-6d42cf93d175",
"name": "Product 1053",
"sku": "sku 1054",
"updated_datetime": "2025-09-17T15:12:40.501249Z"
},
"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-09-17T15:12:40.584795Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTkxZTQzZjktY2ZmMS00YjgwLWI5ZDktYjY4ODIwYWYxMDU2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDAxMiIsInR5cCI6ImFjY2VzcyJ9.lLFaheXDZN64o7x4gxOxEGO0IB5JEic88BWmS4xSdME
{
"billing_location_id": "00000000-0000-0000-0000-000000000475",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000a40",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"id": "00000000-0000-0000-0000-000000000079",
"items": [
{
"batch_id": "00000000-0000-0000-0000-000000000866",
"id": "89586fe9-0821-453d-b918-ea65dc71147a",
"location_id": "00000000-0000-0000-0000-000000000475",
"price": "10.000000000",
"product_id": "108a525f-1a40-4688-bc03-5ba755370a4e",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-000000000475",
"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: bac1aa46e50088000000000000000001-4b75f26bbf31ff5e-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMDM3MTA1YjQtNjMxZC00YzUyLThjNWItMWVlNzlkMzY0YTg2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc4NyIsInR5cCI6ImFjY2VzcyJ9.Zcd2BvGQPbUcOyDtddSicJqtAWBQtmagoXS5Gf3OIYc
{
"billing_location_id": "00000000-0000-0000-0000-000000000442",
"charges": [],
"company_id": "00000000-0000-0000-0000-0000000009bc",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-000000000442",
"price": "10.000000000",
"product_id": "a8df5254-f261-4542-8e1c-459926f977d4",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-000000000442",
"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: 1d8345b1a81466000000000000000001-afc60913252bcbf6-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjIsImlhdCI6MTc1ODEyMTk2MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODkzNjRhYzYtZmUyMS00ODc4LTk0OGMtMjU4YTA0MWU5ZjhjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTYxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDQyMCIsInR5cCI6ImFjY2VzcyJ9.eT0WaKCWfsWTz_OfGf_OGhy-8Eezh7SnZXEWEm6nUD8
{
"billing_location_id": "00000000-0000-0000-0000-00000000051c",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000b6c",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-00000000051c",
"price": "10.000000000",
"product_id": "d508598a-b981-457c-91e5-5d80b29f0682",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-00000000051c",
"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: 1234b17a447810000000000000000001-a9482d9001ba484b-0
{
"errors": [
{
"context": {
"id": "ccd905e6-e220-4b80-b0b7-4972e5505a6c"
},
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODdmMzRmODgtNzhjYi00ZjkxLWJhYTgtY2ZjOTMzMDY4ZTFhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA2MCIsInR5cCI6ImFjY2VzcyJ9.a7UDbPhOuSOd11rjpAVx_6GdwHdG_DehKSKkSdHCi8Q
{
"billing_location_id": "00000000-0000-0000-0000-000000000489",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000a5f",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"items": [
{
"batch_id": "00000000-0000-0000-0000-00000000089a",
"location_id": "00000000-0000-0000-0000-000000000489",
"price": "10.000000000",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-000000000489",
"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: 1d50d4e690e786000000000000000001-7f650304e26ccd47-0
{
"errors": [
{
"context": {
"id": "14075001-cf61-4a6a-83b5-d88fdd8755c9"
},
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGU4NzM3ZjctMjgwZi00NjAwLWJlMjQtZDhlZjFiMzEyNDBlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzM5NSIsInR5cCI6ImFjY2VzcyJ9.n6VLeP-F9q3OUxtANKpPEygiuS8nProiSWnMet58oiw
{
"billing_location_id": "00000000-0000-0000-0000-0000000003ef",
"charges": [],
"company_id": "00000000-0000-0000-0000-0000000008e8",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-0000000003f8",
"price": "10.000000000",
"product_id": "817b443e-d6e4-4855-bb7d-78be46d6f0cb",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-0000000003f8",
"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: e0cc3f3ee18dd8000000000000000001-def2ed1082e05def-0
{
"errors": [
{
"context": {
"id": "9962ce6c-6da0-4185-9790-26ada3cb5300"
},
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTQyNTU2ZTMtMGExZi00M2U0LTg3NmUtMTM0MjY2YTgxMmY2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA4MyIsInR5cCI6ImFjY2VzcyJ9.g30YiaHBNxbyVxpzVGi9xbZX5fAsCXLcyTH_w1BOJ-Y
{
"billing_location_id": "00000000-0000-0000-0000-000000000490",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000a6c",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-000000000490",
"price": "10.000000000",
"product_id": "83439ec3-444c-4a65-b510-bde861412917",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-000000000493",
"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: 9214b334fb53c8000000000000000001-0d143122e3792e82-0
{
"errors": [
{
"context": {
"id": "b3dff4c6-6c08-40bc-a9df-d3c6dc2a4d50"
},
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjhlMjQ0NmYtYzI3MS00ZDM4LTk3NGUtZmFjODMxZWE0MjU1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDE5OCIsInR5cCI6ImFjY2VzcyJ9.J_OZymaCb7cNNUEymOTIWK1Zccabz_zk8R28fjLeB-E
{
"billing_location_id": "00000000-0000-0000-0000-0000000004be",
"charges": [],
"company_id": "00000000-0000-0000-0000-000000000aaf",
"due_datetime": "2020-01-30T00:00:00.000000Z",
"items": [
{
"location_id": "00000000-0000-0000-0000-0000000004bd",
"price": "10.000000000",
"product_id": "e335a9eb-0311-4fef-998e-5ea67d038e75",
"quantity": "1.000000000"
}
],
"location_id": "00000000-0000-0000-0000-0000000004bd",
"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: 1f3e3823d4a0d8000000000000000001-d18c766faf01667b-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 | Default | Example |
---|---|---|---|---|---|---|
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzU1NjMyMjUtZDQyYy00NmNhLWE4YmQtMGVhZTNjMDMwYTk0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc0MSIsInR5cCI6ImFjY2VzcyJ9.864RG9yhMkrdZnzvoyhFnztqj65pjTv3By6aFsipRRg
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 73301a4d5267b0000000000000000001-a7abd34fc07920d5-0
{
"data": [
{
"batch_id": null,
"completion_datetime": "2025-09-17T15:12:38.763842Z",
"compliance_quantity": null,
"description": null,
"id": "00000000-0000-0000-0000-000000000039",
"license_id": null,
"location_id": null,
"owner_id": "00000000-0000-0000-0000-000000000e9d",
"package_id": null,
"product_id": "79cc7fcf-f574-4ffa-863f-c0d02375a75b",
"quantity": "10",
"reason": "revaluation",
"total_cost": "10000"
},
{
"batch_id": null,
"completion_datetime": "2025-09-17T15:12:38.877193Z",
"compliance_quantity": "1",
"description": "A default note describing this transaction",
"id": "00000000-0000-0000-0000-00000000003a",
"license_id": "00000000-0000-0000-0000-000000000178",
"location_id": "00000000-0000-0000-0000-00000000043f",
"owner_id": null,
"package_id": "00000000-0000-0000-0000-0000000000d5",
"product_id": "dd88f2f7-6de4-485b-ae39-cc1e3ee418f0",
"quantity": "1",
"reason": "Voluntary Surrender",
"total_cost": "900"
},
{
"batch_id": "00000000-0000-0000-0000-0000000007f0",
"completion_datetime": "2025-09-17T15:12:38.942343Z",
"compliance_quantity": null,
"description": null,
"id": "00000000-0000-0000-0000-00000000003b",
"license_id": null,
"location_id": "00000000-0000-0000-0000-00000000043c",
"owner_id": null,
"package_id": null,
"product_id": "076c22a5-440b-4bb7-a138-a87f1c3b55ed",
"quantity": "1",
"reason": "revaluation",
"total_cost": "-800"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZWQ5NWYxMzctNjQ2ZC00MzRkLWIzNTctNWU2YjhjMGY4MTk4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA1MSIsInR5cCI6ImFjY2VzcyJ9.D2yT8-aYPknA_FxAmTNITQAoib1TUaqciczZU0qrCEU
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"location_id": "00000000-0000-0000-0000-00000000048d",
"product_id": "2c864711-654e-4457-9a00-166e59f7fb60",
"quantity": 10,
"reason": "expired"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 47aa00fbee41e4000000000000000001-5ee05198964c3c77-0
{
"data": {
"batch_id": null,
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"compliance_quantity": null,
"description": "test",
"id": "00000000-0000-0000-0000-000000000047",
"license_id": null,
"location_id": "00000000-0000-0000-0000-00000000048d",
"owner_id": null,
"package_id": null,
"product_id": "2c864711-654e-4457-9a00-166e59f7fb60",
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjMyNDI2NzgtNmFiYy00NDczLWFjMjYtY2U2ZmE4Mjg3ZThlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY1MyIsInR5cCI6ImFjY2VzcyJ9.crED3saP2XIeSFpfjooOigy1oH8_a-8NPMdA69j4RLk
{
"batch_id": "00000000-0000-0000-0000-00000000077c",
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"location_id": "00000000-0000-0000-0000-00000000042e",
"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: d51d7fae70ebc0000000000000000001-81315657e385b3e9-0
{
"data": {
"batch_id": "00000000-0000-0000-0000-00000000077c",
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"compliance_quantity": null,
"description": "test",
"id": "00000000-0000-0000-0000-000000000038",
"license_id": null,
"location_id": "00000000-0000-0000-0000-00000000042e",
"owner_id": null,
"package_id": null,
"product_id": "c635fb0e-5801-4d5c-84fa-d12029414069",
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMWIzMGQxNTUtNDdjZi00MTJjLTgyNjItZWZjYTZkMzAxMjE3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzkxNyIsInR5cCI6ImFjY2VzcyJ9.Y2KLCLKA7CwP53ihnaQQgpdx56XQmJzQOjiqeGwudfM
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"compliance_quantity": 10,
"description": "test",
"package_id": "00000000-0000-0000-0000-0000000000e1",
"reason": "Damage (BCC)",
"unit_cost": 1000
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: c3ed9eda0e0190000000000000000001-3c5e721344735d9f-0
{
"data": {
"batch_id": null,
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"compliance_quantity": "10",
"description": "test",
"id": "00000000-0000-0000-0000-000000000041",
"license_id": "00000000-0000-0000-0000-000000000185",
"location_id": "00000000-0000-0000-0000-00000000045c",
"owner_id": null,
"package_id": "00000000-0000-0000-0000-0000000000e1",
"product_id": "1223403c-3022-4a9f-9aac-899f53b8a1fd",
"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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTYsImlhdCI6MTc1ODEyMTk1NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWFkOTAwZjMtYTZjMy00YzNjLWFiNGQtMTRjOTc4OWMwMGVjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzMwOCIsInR5cCI6ImFjY2VzcyJ9.sZghK9ra2WGhUz78I5IN8XaGw7ITbBYRjpfJVVv-PlM
{
"description": "test",
"package_id": "00000000-0000-0000-0000-0000000000c5",
"quantity": 10,
"reason": "Damage (BCC)"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: b5aabc38b29da0000000000000000001-390ba1f8a12b2541-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTIwZjcxMDUtOTkwZS00N2ExLTgwNDEtYTY1MjI2ODAzYTQ0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDAzMSIsInR5cCI6ImFjY2VzcyJ9.bUVniCHH8V0V6j_DU1XYb8xj_xmKcF2viWkyQp40o8k
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"location_id": "00000000-0000-0000-0000-00000000047f",
"product_id": "058d134d-cbfd-48e7-b9df-4f392aee7cc2",
"quantity": 10,
"reason": "expired"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: cb9d1ade4012f0000000000000000001-ff37ee95344752ca-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDg3Zjc5NDktMjM4ZS00ZjBiLTliOGItN2U0ZjYxNzgzMzJjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzcyMiIsInR5cCI6ImFjY2VzcyJ9.X1pejfGQ-C4PDk2tai_oNoPzjRUlu6qHpnETDhvKH_k
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"compliance_quantity": 10,
"description": "test",
"location_id": "00000000-0000-0000-0000-000000000438",
"product_id": "c35e990d-6ec1-4246-bc3b-650b8504df83",
"reason": "expired"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 60fc0e8d6df760000000000000000001-f3b047509cb5ce71-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTUxZDg0M2EtYzQ1My00MjI0LWI2YjgtMGRiZmNlYjc3MWU2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA0NiIsInR5cCI6ImFjY2VzcyJ9.UFYz2uUgOTGEeSIeA5996JKbLuaMBOPYz6G-tUkSTKY
{
"batch_id": "69091957-495c-429d-b8c1-aa9fffa53bd2",
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"location_id": "565f199d-e696-48a3-871b-11f15232bdcf",
"package_id": "10cde4dc-33c6-46b4-8386-846095b879da",
"product_id": "bde7226f-20bb-4d2b-a185-0895f50410f7",
"reason": "expired"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 5980289aeb4534000000000000000001-29ddc36fc0e77d66-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZmViZjcwY2ItOWZlOS00OWViLWI5ZjQtMmU1NmUyZGE5NjE2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzk2NyIsInR5cCI6ImFjY2VzcyJ9.ahr2c4DGa0asfcuUKdyyvvmUimjibx3PUmAGH0Q2twE
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"location_id": "8ec313f1-3882-4c8c-b4cf-f905ceae936b",
"reason": "expired"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 2dbc69ffa44694000000000000000001-be0e3cdce53e8bae-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZWEwZTE2NWUtMDllMS00OWM2LWJjNzYtNDY1Nzc3MDRiNzg1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzk3MyIsInR5cCI6ImFjY2VzcyJ9.LFK84nAkCzLUxb0E_ejzzB6a-s2IwDAVGgJHj9narOk
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"location_id": "8a948a5b-aee1-4ad7-8806-deb8c51e5f68",
"product_id": "2ce919ac-2be3-49a7-acee-0d1be2eadc32",
"quantity": 10,
"reason": "waste"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: b440e68f5150c0000000000000000001-4b79b6684d21eeeb-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTBjZWNlNjItNTMwYy00MjczLTk2OTMtZWQzNTk1ZWI2OWM3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA0MiIsInR5cCI6ImFjY2VzcyJ9.VV2WGzqyVs-It5MpaThwuYE4uXgwXR9W_SmLO1SwHLY
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"compliance_quantity": 10,
"description": "test",
"location_id": "35ebe731-2eda-4017-a7d0-c9815bf7a199",
"package_id": "293c45c1-8672-44b1-adb6-896f0543b7de",
"reason": "compliance"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: b947d60b3adbd8000000000000000001-8ce5de3b6b59e5ad-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NjAsImlhdCI6MTc1ODEyMTk2MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjU5NjliYmEtNmMyNi00OGUwLWFiZDctYjY2NThmYjQwNmRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NDA3MCIsInR5cCI6ImFjY2VzcyJ9.GxZoB6xvLg081eX1O16HFoAgtn4uBiyyqd4VSmM6VOw
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"product_id": "b64f9e09-8bee-42ee-9cd8-624744270283",
"quantity": 10,
"reason": "compliance"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 0f3214d084644b000000000000000001-7eb65476da24088b-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjc5MDg1YzEtNzY4Ni00YjY3LTgwMGQtZmNlNjA2NjNlNDYyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzYzNyIsInR5cCI6ImFjY2VzcyJ9.-XsRWD4Ch9RwWtBHbGf69RwWCsIruaIPJtTowo_pGrk
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"location_id": "6aadf346-5478-4dfb-b078-0886ef86c14e",
"product_id": "bba5de02-9018-4ae8-bf29-c1f2c51a0500",
"quantity": 10,
"reason": "compliance"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: d1d120a4d0fca8000000000000000001-bc3544ebc4f74105-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjA2MTQxODktZDJmNi00NzkzLTk2NDktOThiZGRlNmUwOTMyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzcwOCIsInR5cCI6ImFjY2VzcyJ9.c04ekzym4DnZ8fe_96OqxgduPvlrnTrK6PipK5CJt0E
{
"batch_id": "00000000-0000-0000-0000-000000000794",
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"location_id": "69d057f2-22c7-4753-a7bf-5f02fbd4397f",
"quantity": 10,
"reason": "compliance"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 4d47be4b83c498000000000000000001-d52d8be34b4c3cb5-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMGIxYWYyOTAtMmNiOC00MjZiLWI3YTktMTA2MDhlMGU3M2EzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY3NSIsInR5cCI6ImFjY2VzcyJ9.6mIXQeU68U62XlkOb9QmlJrJ-yGzKDN_1XgOCFsajSo
{
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"compliance_quantity": 10,
"description": "test",
"package_id": "00000000-0000-0000-0000-0000000000d0",
"reason": "compliance"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: 1af02112e7c379000000000000000001-1189fdfd5dff0f21-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGFlODc3ZjktZmM4OC00MDBkLTk1NzMtMWM4YjE1ZjQ4OGQ5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzYyNCIsInR5cCI6ImFjY2VzcyJ9.HiTUnlepA7QgLKZz8q5FdefmUgZCTXDEGVq-QEftQCw
{
"batch_id": "00000000-0000-0000-0000-000000000779",
"completion_datetime": "2020-01-03T12:20:00.000000Z",
"description": "test",
"location_id": "00000000-0000-0000-0000-00000000042a",
"quantity": 10,
"reason": "compliance"
}
Response
400
cache-control: max-age=0, private, must-revalidate
content-type: application/json; charset=utf-8
b3: b58199b5fba6e0000000000000000001-847c7084f60825ee-0
{
"errors": [
{
"context": {},
"message": "Location not found",
"pointer": [
"location_id"
],
"section": "body"
}
]
}
Request
POST /public/v1/adjustments
Parameters
Parameter | Description | In | Type | Required | Default | Example |
---|---|---|---|---|---|---|
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiOWFjOGI5NjYtN2U5Mi00NzdhLWJkODctNjIwNTU0MTE1MmM1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzQwMCIsInR5cCI6ImFjY2VzcyJ9.nOrOofGUuhhFIQ5lyWfJs2PWkiI3Vearfqs5-nBUlVY
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 200aba65172048000000000000000001-05ee8057e3c0076c-0
{
"data": [
{
"id": "00000000-0000-0000-0000-000000000034",
"name": "Strain 1"
},
{
"id": "00000000-0000-0000-0000-000000000035",
"name": "Strain 2"
}
],
"next_page": null
}
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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDgwYjZjMmEtNjdmMC00MDFkLWE5ZTUtODQ3NDJlZGE5MDJkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY4MSIsInR5cCI6ImFjY2VzcyJ9.8xNbVd2gF8LOWsXPmQoAFptw_jN7zh2PgOffxnPuY_g
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 0a8f5551d6c108800000000000000001-aea9486973ab118d-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-00000000002f",
"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-0000000000d1",
"release_date": "2025-09-17",
"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-09-17T15:12:38.644421Z"
},
{
"additional_test_results": {
"thca_percentage": "12"
},
"batch_id": "00000000-0000-0000-0000-000000000797",
"cbd_mg_per_unit": null,
"cbd_percentage": null,
"id": "00000000-0000-0000-0000-000000000030",
"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-09-17T15:12:38.659228Z"
},
{
"additional_test_results": {},
"batch_id": null,
"cbd_mg_per_unit": null,
"cbd_percentage": null,
"id": "00000000-0000-0000-0000-000000000031",
"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-0000000000d4",
"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-09-17T15:12:38.728270Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDRkMzllN2ItYWQxZi00YmRmLTk0MDYtMjdkODk0NzExNTk0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzg1MyIsInR5cCI6ImFjY2VzcyJ9.GFp-OjTsdMJ1kyqL81biWFi0X4xL5eY-IpfF0ryCO-Y
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: d98a2910645088000000000000000001-be176b5f7cd20605-0
{
"data": [
{
"additional_test_results": {
"spiroxamine_a_ug_per_g": "13",
"thiacloprid_ug_per_g": "14"
},
"batch_id": "00000000-0000-0000-0000-00000000080a",
"cbd_mg_per_unit": null,
"cbd_percentage": null,
"id": "00000000-0000-0000-0000-000000000038",
"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-09-17T15:12:39.165787Z"
}
],
"next_page": null
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjY3YzU2ZDAtMzlkNS00MDExLTg3OTItNWI0ZmRmMmQ2ZTA4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzc4OCIsInR5cCI6ImFjY2VzcyJ9.cqg9fUx22hopDpQwhZn2wbiGGUNr_aXCZIaE7JTIpYY
{
"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-0000000007f2",
"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: 2f285d38a6a406000000000000000001-27eac611e830804a-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-0000000007f2",
"cbd_mg_per_unit": "1.1",
"cbd_percentage": "2.2",
"id": "00000000-0000-0000-0000-000000000036",
"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-09-17T15:12:38.954598Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTYsImlhdCI6MTc1ODEyMTk1NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMmIxNmQ2NjEtY2NmMS00OWU2LThlMGMtNjNiMTJiM2I0ZjA0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzMwNyIsInR5cCI6ImFjY2VzcyJ9.SL9W6YhxW1kQ-NS8NOGfT80AgkSuMM0o_xbO-w3gXtU
{
"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-0000000000c7"
}
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 1bbc0a2e86e418000000000000000001-5b9fd35e63c3ceb0-0
{
"data": {
"additional_test_results": {},
"batch_id": null,
"cbd_mg_per_unit": null,
"cbd_percentage": null,
"id": "00000000-0000-0000-0000-00000000002e",
"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-0000000000c7",
"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-09-17T15:12:38.289409Z"
}
}
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGU5Y2ZlMDktY2I4My00MmE4LWFhM2ItZTU1ODliODdiODdhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Mzg3MiIsInR5cCI6ImFjY2VzcyJ9.O9TgAjVO05eWkaWgqHM6lDCVyn8HPjqiLqrABTNMYSo
{
"batch_id": "00000000-0000-0000-0000-00000000080e",
"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: 222dc4c8c01926000000000000000001-9f7f4779f33de37d-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTgsImlhdCI6MTc1ODEyMTk1OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjlmYmM5OTktMjQ5Ny00M2NjLThiOTMtYzVmYWY5M2JlNDhiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzY1OSIsInR5cCI6ImFjY2VzcyJ9.d2AD_7Fpzl_-TMJ0Y2S_ITrhG8KJW7Bd6u-irjOTr5c
{
"additional_test_results": {},
"batch_id": "00000000-0000-0000-0000-00000000077e",
"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: 1a325b42a4ad97000000000000000001-3e24bbc538a0bd1a-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTksImlhdCI6MTc1ODEyMTk1OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiN2Q3OWI0MDAtMjYwNi00ZWM5LTkwNWMtMDgzYmU5MzA2ZGVlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzgzMiIsInR5cCI6ImFjY2VzcyJ9.-SQhUqZwcJ-3oiKLA01aLbZ1hWd8bxZBIA00E1GB80s
{
"additional_test_results": {
"thca_percentage": "15"
},
"id": "00000000-0000-0000-0000-000000000037",
"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: 394af51aff42c6000000000000000001-b068fb3754d569a6-0
{
"data": {
"additional_test_results": {
"thca_percentage": "15"
},
"batch_id": "00000000-0000-0000-0000-000000000804",
"cbd_mg_per_unit": null,
"cbd_percentage": null,
"id": "00000000-0000-0000-0000-000000000037",
"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-09-17T15:12:39.071311Z"
}
}
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 | Default | 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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE3ODk1NzE1NTcsImlhdCI6MTc1ODEyMTk1NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjZmYzdmZmQtZTk0YS00NTg0LWI2YTgtYjk3NjJkZGU5ODJiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzU4MTIxOTU2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MzM3MyIsInR5cCI6ImFjY2VzcyJ9.yZymGaEnbYRsP21VrmBtFXFyUSQnKmgnQqkDOdd5VI4
Response
200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 325c679a9653c4000000000000000001-2ca9d48e1de871eb-0
{
"data": [
{
"banned": false,
"email": "owner-84@example.com",
"full_name": "FirstName175 LastName177",
"id": "00000000-0000-0000-0000-000000000d2d",
"role": {
"id": "00000000-0000-0000-0000-000000000cc8",
"name": "Admin 85"
}
},
{
"banned": false,
"email": "owner-86@example.com",
"full_name": "FirstName183 LastName184",
"id": "00000000-0000-0000-0000-000000000d30",
"role": {
"id": "00000000-0000-0000-0000-000000000cca",
"name": "Admin 87"
}
}
],
"next_page": null
}
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 | Default | 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
- GET
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
andreturned_quantity
to "items" in GET/public/v1/invoices
endpoint. - Added
total_cost_actual
,total_cost_default
andreturned_quantity
to "items" in GET/public/v1/invoices/:id
endpoint. - Added
total_cost_actual
,total_cost_default
andreturned_quantity
to "items" in GET/public/v1/orders
endpoint. - Added
total_cost_actual
,total_cost_default
andreturned_quantity
to "items" in GET/public/v1/orders/:id
endpoint.
2025-03-18
- Modified
unit_net_weight
andunit_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
- GET
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
andmetrc_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
andbiotrack_id
to GET/public/v1/orders
2025-06-12
- Changed
cost
on GET/public/v1/assemblies
tototal_cost_actual
iningredients
- Added
total_cost_default
to GET/public/v1/assemblies
iningredients
- Added
total_cost_actual
to GET/public/v1/assemblies
inadditional_costs
- Added
total_cost_default
to GET/public/v1/assemblies
inadditional_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
2025-09-10
Added
cost_per_unit_actual
andcost_per_unit_default
to the following endpoints:- GET
public/v1/assemblies
- GET
public/v1/orders
- GET
public/v1/orders/:id
- GET
public/v1/invoices
- GET
public/v1/invoices/:id
- GET
public/v1/batches
- GET
public/v1/packages
- GET
Added fields
total_cost_actual
,total_cost_default
and attributeinclude_costs
to the following endpoints:- GET
public/v1/batches
- GET
public/v1/packages
- GET