NAV Hide code

Need more from the API?

We're actively expanding the API and would love to build what your integration needs. Tell your Customer Support Representative which endpoints or functionality would help—we're eager to add them.

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.

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:

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

Using your API token

Example authenticated request

GET /public/v1/orders?page[number]=1
content-type: application/json
accept: application/json
authorization: Bearer YOUR_API_TOKEN

Every request must include your token in the Authorization header using the Bearer scheme, along with JSON content-type and accept headers:

Header Value
Authorization Bearer YOUR_API_TOKEN
Content-Type application/json
Accept application/json

Treat your token like a password: it carries the same permissions as the admin who created it. Keep it server-side and never expose it in client-side code.

Webhooks

Distru can push changes to your systems in real time via webhooks. A webhook fires whenever a record is created, edited, or deleted. We support webhooks for:

To set up webhooks, reach out to Customer Support to find out more.

Webhook payload shape

Every webhook is a JSON POST with three top-level fields:

Field Description
type The entity type, e.g. ORDER, PURCHASE, INVOICE, PRODUCT.
id The public id of the entity the webhook is about (the same value as object.id).
object The full entity, in the same structure the GET /public/v1/<type>/<id> endpoint returns.

object is the current version of the entity, fetched fresh when the webhook is sent — not a snapshot from when the change was committed. If other changes were committed in between, they are reflected. On a hard-delete event the entity no longer exists, so object is null; use type and id.

To keep integrations simple, object matches the corresponding GET endpoint exactly, so you can parse it with the same code you already use for that endpoint.

A sales order is created or edited (object is the full order, same as GET /public/v1/orders/:id)

{
  "type": "ORDER",
  "id": "8f3c9d2e-1a4b-4c7d-9e0f-2b6a1c3d4e5f",
  "object": {
    "id": "8f3c9d2e-1a4b-4c7d-9e0f-2b6a1c3d4e5f",
    "order_number": "SO-0001",
    "status": "PENDING",
    "total": "60.00",
    "order_datetime": "2025-05-04T04:40:21.817570Z",
    "company": {"id": "b7e2…", "name": "Acme Dispensary"},
    "items": [
      {
        "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
        "product_id": "0c9e7f11-2a33-4b55-8c77-9d0e1f2a3b4c",
        "quantity": 5.0,
        "price": 10.0
      }
    ],
    "charges": []
  }
}

A sales order is hard-deleted (object is null)

{
  "type": "ORDER",
  "id": "8f3c9d2e-1a4b-4c7d-9e0f-2b6a1c3d4e5f",
  "object": null
}

Objects above are trimmed for readability; a real object includes the full set of fields returned by the matching GET endpoint.

Webhook nested entities

A change to a nested record triggers a webhook at its parent level — never as its own webhook — and object is always the full parent entity. The nested records that trigger each parent are:

Parent Nested records
Sales Orders items, charges
Purchase Orders items, charges
Invoices items, charges, payments
Assemblies inputs, outputs, costs
Returns items
Companies the related company, its locations, its licenses, and its contacts (each with its profile)
Products bills of materials (and each bill of materials' inputs and costs)

For example, adding an order item to a sales order does not send an "order item" webhook — it sends a Sales Order webhook whose object is the full order, including the new item.

Note: inventory changes (adding or removing quantity) do not currently trigger Product webhooks.

Webhook signing & verification

The x-distru-signature header

x-distru-signature: sha256=<hex digest>

Node.js verification example

const crypto = require('crypto');

function isValid(rawBody, signatureHeader, secret) {
  const expected =
    'sha256=' +
    crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signatureHeader),
    Buffer.from(expected)
  );
}

When Customer Support sets up your webhook, they provide a signing secret. Distru signs every request so you can confirm it came from us and was not tampered with. Each request includes an x-distru-signature header.

The digest is an HMAC-SHA256 of the raw request body using your signing secret. To verify a request:

  1. Read the raw request body exactly as received — do not re-serialize the JSON, since key order must match.
  2. Compute HMAC-SHA256(raw_body, your_secret) and hex-encode it.
  3. Compare sha256=<your digest> to the x-distru-signature header using a constant-time comparison.

Webhook retries

If your endpoint is unreachable or returns a non-2xx status, Distru retries delivery with an increasing delay between attempts (up to ~10 attempts over roughly 4 hours) before giving up.

Pagination

Endpoint query with page number example

https://app.distru.com/public/v1/products?page[number]=1

cURL example

curl --location --globoff 'https://app.distru.com/public/v1/products?page[number]=1' \
--header 'Authorization: Bearer ********* API KEY HERE *********'

Next page URL in the response body (if a next page exists)

"next_page": "https://app.distru.com/public/v1/products?page[number]=2"

Use the page[number]= query parameter to request a specific page. When another page is available, the response body includes a next_page URL you can follow.

Page size limits for each endpoint are listed in the API documentation.

Filtering by datetime parameters

On or after May 4th, 2025

products?updated_datetime=2025-05-04T04:40:21.817570Z,

On or before May 4th, 2025

products?updated_datetime=,2025-05-04T04:40:21.817570Z

Between May 4th and Sept 18th, 2025 (inclusive)

products?updated_datetime=2025-05-04T04:40:21.817570Z,2025-09-18T16:27:44.946871Z

Datetimes use the format YYYY-MM-DDTHH:MM:SS.MSZ.

The comma position controls the direction of the filter. All bounds are inclusive: a record matching the exact datetime in the query is returned.

Endpoints

Assembly

Get an assembly

GET /public/v1/assemblies/:id returns a single assembly with outputs

GET /public/v1/assemblies/87e59413-891b-4354-b9e8-9b280d3ac295
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzMsImlhdCI6MTc4NzE0NTU3MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiODc0MTlmMDQtYmRmNi00YTVlLWJmYWQtZDFmZWYwZmQwZjU4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODgzMSIsInR5cCI6ImFjY2VzcyJ9.hZnEGuF0jdZThilTZo2BCNS1YWmN5Qd2Nn7NCtFU6gI

Response

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

{
  "data": {
    "assembly_number": "AS-0000001",
    "completion_datetime": "2026-08-19T13:19:33.563044Z",
    "compliance_type": "NONE",
    "creation_source": "MANUALLY_CREATED",
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-1926@example.com",
      "full_name": "FirstName3918 LastName3919",
      "id": "00000000-0000-0000-0000-00000000227f",
      "inserted_datetime": "2026-08-19T13:19:33.512289Z",
      "role": {
        "id": "00000000-0000-0000-0000-00000000235f",
        "name": "Admin 2014"
      }
    },
    "custom_data": [],
    "description": null,
    "estimated_start_date": null,
    "estimated_work_hours": null,
    "estimated_work_minutes": null,
    "fulfilled": true,
    "id": "87e59413-891b-4354-b9e8-9b280d3ac295",
    "inserted_datetime": "2026-08-19T13:19:33.563044Z",
    "is_metrc_processing_job": false,
    "license": null,
    "metrc_processing_job_id": null,
    "metrc_processing_job_name": null,
    "metrc_processing_job_notes": null,
    "outputs": [
      {
        "additional_costs": [],
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-0000000009d2",
          "name": "B1058"
        },
        "batch_number": null,
        "compliance_label": null,
        "compliance_quantity": null,
        "copy_custom_data_from_input": null,
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "costs": [],
        "expiration_date": null,
        "expiration_datetime": null,
        "ingredients": [
          {
            "batch": {
              "batch_number": null,
              "id": "00000000-0000-0000-0000-0000000009d2",
              "name": "B1058"
            },
            "compliance_quantity": null,
            "cost_per_unit": null,
            "cost_per_unit_default": null,
            "location": {
              "address": "123 Fake Street, Beverly Hills, CA 90210, US",
              "company_id": "00000000-0000-0000-0000-000000001990",
              "id": "00000000-0000-0000-0000-0000000007e5",
              "license_id": null,
              "name": "Place 354"
            },
            "package": null,
            "product": {
              "id": "3a9abde4-c6bb-4101-80cd-77f080e6eefd",
              "name": "Product 1054",
              "sku": "sku 1055",
              "updated_datetime": "2026-08-19T13:19:33.527590Z"
            },
            "quantity": "2",
            "total_cost_actual": null,
            "total_cost_default": null
          }
        ],
        "inputs": [
          {
            "batch": {
              "batch_number": null,
              "id": "00000000-0000-0000-0000-0000000009d2",
              "name": "B1058"
            },
            "compliance_quantity": null,
            "cost_per_unit": null,
            "cost_per_unit_default": null,
            "location": {
              "address": "123 Fake Street, Beverly Hills, CA 90210, US",
              "company_id": "00000000-0000-0000-0000-000000001990",
              "id": "00000000-0000-0000-0000-0000000007e5",
              "license_id": null,
              "name": "Place 354"
            },
            "package": null,
            "product": {
              "id": "3a9abde4-c6bb-4101-80cd-77f080e6eefd",
              "name": "Product 1054",
              "sku": "sku 1055",
              "updated_datetime": "2026-08-19T13:19:33.527590Z"
            },
            "quantity": "2",
            "total_cost_actual": null,
            "total_cost_default": null
          }
        ],
        "is_donation": false,
        "is_finished_good": false,
        "is_production_batch": false,
        "is_test_sample": false,
        "is_trade_sample": null,
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 90210, US",
          "company_id": "00000000-0000-0000-0000-000000001990",
          "id": "00000000-0000-0000-0000-0000000007e5",
          "license_id": null,
          "name": "Place 354"
        },
        "metrc_item_id": null,
        "metrc_location_id": null,
        "metrc_notes": null,
        "metrc_production_batch_number": null,
        "package": null,
        "package_date": null,
        "package_datetime": null,
        "package_unit_type": null,
        "product": {
          "id": "3a9abde4-c6bb-4101-80cd-77f080e6eefd",
          "name": "Product 1054",
          "sku": "sku 1055",
          "updated_datetime": "2026-08-19T13:19:33.527590Z"
        },
        "quantity": "2",
        "status": "COMPLETED",
        "total_cost_actual": null,
        "total_cost_default": null,
        "use_same_item": false
      }
    ],
    "owner_id": "00000000-0000-0000-0000-00000000227f",
    "status": "COMPLETED",
    "updated_datetime": "2026-08-19T13:19:33.563044Z",
    "waste_count_quantity": null,
    "waste_count_unit_name": null,
    "waste_volume_quantity": null,
    "waste_volume_unit_name": null,
    "waste_weight_quantity": null,
    "waste_weight_unit_name": null
  }
}

Get a single assembly given the ID.

Required permission: assemblies_permissions_view.

Request

GET /public/v1/assemblies/{id}

Parameters

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

Responses

Status Description Schema
200 A single assembly AssemblyResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzIsImlhdCI6MTc4NzE0NTU3MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDVmNDUzNDUtMDBiYS00NGEzLTg1ZjktNmY4NDYxODE1NTY0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODYyNiIsInR5cCI6ImFjY2VzcyJ9.KSdzHML6_a81AR0MXvAzXgnr5Lsr__tWyW5Al_hNBGI

Response

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

{
  "data": [
    {
      "assembly_number": "AS-0000001",
      "completion_datetime": "2026-08-19T13:19:32.807937Z",
      "compliance_type": "NONE",
      "creation_source": "MANUALLY_CREATED",
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-1721@example.com",
        "full_name": "FirstName3508 LastName3509",
        "id": "00000000-0000-0000-0000-0000000021b2",
        "inserted_datetime": "2026-08-19T13:19:32.744332Z",
        "role": {
          "id": "00000000-0000-0000-0000-00000000228e",
          "name": "Admin 1805"
        }
      },
      "custom_data": [
        {
          "id": 216,
          "name": "Custom Field 37",
          "value": "Custom Field Value"
        }
      ],
      "description": null,
      "estimated_start_date": "2024-01-02T03:04:05.000000Z",
      "estimated_work_hours": 1,
      "estimated_work_minutes": 5,
      "fulfilled": true,
      "id": "b6cb355c-b143-4677-aabf-017f85621d44",
      "inserted_datetime": "2026-08-19T13:19:32.807937Z",
      "is_metrc_processing_job": false,
      "license": null,
      "metrc_processing_job_id": null,
      "metrc_processing_job_name": null,
      "metrc_processing_job_notes": null,
      "outputs": [
        {
          "additional_costs": [
            {
              "cost_per_unit": "-1",
              "description": null,
              "name": "CostType 21",
              "quantity": "1",
              "total_cost_actual": "-1",
              "total_cost_default": "0",
              "unit_type": {
                "id": "00000000-0000-0000-0000-000000014155",
                "name": "Unit Type 26"
              }
            }
          ],
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000978",
            "name": "B866"
          },
          "batch_number": null,
          "compliance_label": null,
          "compliance_quantity": null,
          "copy_custom_data_from_input": null,
          "cost_per_unit": "-0.3",
          "cost_per_unit_default": "0.5",
          "costs": [
            {
              "cost_per_unit": "-1",
              "description": null,
              "name": "CostType 21",
              "quantity": "1",
              "total_cost_actual": "-1",
              "total_cost_default": "0",
              "unit_type": {
                "id": "00000000-0000-0000-0000-000000014155",
                "name": "Unit Type 26"
              }
            }
          ],
          "expiration_date": null,
          "expiration_datetime": null,
          "ingredients": [
            {
              "batch": {
                "batch_number": null,
                "id": "00000000-0000-0000-0000-000000000978",
                "name": "B866"
              },
              "compliance_quantity": null,
              "cost_per_unit": "0.2",
              "cost_per_unit_default": "1",
              "location": {
                "address": "123 Fake Street, Beverly Hills, CA 90210, US",
                "company_id": "00000000-0000-0000-0000-000000001936",
                "id": "00000000-0000-0000-0000-0000000007c6",
                "license_id": null,
                "name": "Place 322"
              },
              "package": null,
              "product": {
                "id": "c44a2559-509d-4d5d-b12a-ca2b2918d514",
                "name": "Product 864",
                "sku": "sku 865",
                "updated_datetime": "2026-08-19T13:19:32.759663Z"
              },
              "quantity": "2",
              "total_cost_actual": "0.4",
              "total_cost_default": "2"
            }
          ],
          "inputs": [
            {
              "batch": {
                "batch_number": null,
                "id": "00000000-0000-0000-0000-000000000978",
                "name": "B866"
              },
              "compliance_quantity": null,
              "cost_per_unit": "0.2",
              "cost_per_unit_default": "1",
              "location": {
                "address": "123 Fake Street, Beverly Hills, CA 90210, US",
                "company_id": "00000000-0000-0000-0000-000000001936",
                "id": "00000000-0000-0000-0000-0000000007c6",
                "license_id": null,
                "name": "Place 322"
              },
              "package": null,
              "product": {
                "id": "c44a2559-509d-4d5d-b12a-ca2b2918d514",
                "name": "Product 864",
                "sku": "sku 865",
                "updated_datetime": "2026-08-19T13:19:32.759663Z"
              },
              "quantity": "2",
              "total_cost_actual": "0.4",
              "total_cost_default": "2"
            }
          ],
          "is_donation": false,
          "is_finished_good": false,
          "is_production_batch": false,
          "is_test_sample": false,
          "is_trade_sample": null,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 90210, US",
            "company_id": "00000000-0000-0000-0000-000000001936",
            "id": "00000000-0000-0000-0000-0000000007c6",
            "license_id": null,
            "name": "Place 322"
          },
          "metrc_item_id": null,
          "metrc_location_id": null,
          "metrc_notes": null,
          "metrc_production_batch_number": null,
          "package": null,
          "package_date": null,
          "package_datetime": null,
          "package_unit_type": null,
          "product": {
            "id": "c44a2559-509d-4d5d-b12a-ca2b2918d514",
            "name": "Product 864",
            "sku": "sku 865",
            "updated_datetime": "2026-08-19T13:19:32.759663Z"
          },
          "quantity": "2",
          "status": "COMPLETED",
          "total_cost_actual": "-0.6",
          "total_cost_default": "1",
          "use_same_item": false
        }
      ],
      "owner_id": "00000000-0000-0000-0000-0000000021b2",
      "status": "COMPLETED",
      "updated_datetime": "2026-08-19T13:19:32.807937Z",
      "waste_count_quantity": null,
      "waste_count_unit_name": null,
      "waste_volume_quantity": null,
      "waste_volume_unit_name": null,
      "waste_weight_quantity": null,
      "waste_weight_unit_name": null
    }
  ],
  "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.

Required permission: assemblies_permissions_view. Results are filtered to only include assemblies the authenticated user can access under their team restrictions.

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,
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
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of assemblies Assemblies

Batch

Create or update a batch

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMGQ3Nzc5OTItZmYwNC00ZTdiLWJhMmQtYzg5ZTBlOTNhYzE4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzY2MiIsInR5cCI6ImFjY2VzcyJ9.ZGC7EV2VHYPQFyyzugzW1UQJIqDS2QanVHIR_kbqkI8

{
  "batch_number": "B1",
  "cbd": "0.3%",
  "custom_data": {
    "200": [
      "A",
      "B"
    ]
  },
  "description": "Test batch",
  "expiration_date": "2025-01-01T00:00:00.000000Z",
  "harvest_datetime": "2024-06-15T00:00:00.000000Z",
  "manufactured_datetime": "2025-01-02T03:04:05.000000Z",
  "name": "Custom Batch Name",
  "owner_id": "00000000-0000-0000-0000-000000001df5",
  "product_id": "2089421f-2967-48ba-a60f-5d1473981825",
  "thc": "18.5%"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 1731dc5f4433ed7c1c8c6ed83529e328-840476140cb5b7d3-0

{
  "data": {
    "batch_number": "B1",
    "cbd": "0.3%",
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-761@example.com",
      "full_name": "FirstName1516 LastName1517",
      "id": "00000000-0000-0000-0000-000000001dee",
      "inserted_datetime": "2026-08-19T13:19:29.118701Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001eb3",
        "name": "Admin 818"
      }
    },
    "custom_data": [
      {
        "id": 200,
        "name": "Custom Field 21",
        "value": "A,B"
      }
    ],
    "deleted_at": null,
    "description": "Test batch",
    "expiration_date": "2025-01-01T00:00:00.000000Z",
    "harvest_datetime": "2024-06-15T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-0000000008af",
    "inserted_datetime": "2026-08-19T13:19:29.139979Z",
    "manufactured_datetime": "2025-01-02T03:04:05.000000Z",
    "name": "Custom Batch Name",
    "owner_id": "00000000-0000-0000-0000-000000001df5",
    "product_id": "2089421f-2967-48ba-a60f-5d1473981825",
    "thc": "18.5%",
    "updated_datetime": "2026-08-19T13:19:29.139979Z"
  }
}

Create or update a single batch. Omit id to create a new batch; pass the id of an existing batch to update it.

Required permission: products_permissions_create to create, products_permissions_edit to update.

Request

POST /public/v1/batches

Parameters

Parameter Description In Type Required Default Example
batch_number The batch number of the batch. body string false
bin_ids The IDs of the bins this batch is stored in. Behaviour: omit bin_ids to leave the batch's bins unchanged; pass null or an empty array to clear all bins; pass a non-empty array to replace the batch's bins with exactly those. Ignored unless bin inventory tracking is enabled for your company.
body array false
cbd A free-form CBD label for the batch, as displayed in Distru (e.g. "0.3%"). This is a static value stored on the batch record; it does not set or derive from any lab result — the batch's primary test result tracks potency separately. body string false
custom_data A map of custom field IDs to their values. Use GET /public/v1/custom-fields?parent_object=batch to retrieve available custom fields, their IDs, and their types. The value format depends on the field's type: a text field takes a string, a date field takes a full ISO8601 datetime, and a checkbox field takes an array of its selected options. body object false {"101":"Some text value","102":"2026-08-18T00:00:00.000-07:00","103":["Option A","Option B"]}
description The description of the batch. body string false
expiration_date The expiration date of the batch. body string false
harvest_datetime The harvest datetime of the batch (ISO 8601 format). body string false
id The ID of the batch to update. Omit to create a new batch. body string false
manufactured_datetime The manufactured datetime of the batch (ISO 8601 format). body string false
name The name of the batch. If omitted, a name is generated from the batch number. Ignored on update. body string false
owner_id The ID of the user that is the designated owner of this batch. body string false
product_id The ID of the product that this batch belongs to. body string false
thc A free-form THC label for the batch, as displayed in Distru (e.g. "18.5%"). This is a static value stored on the batch record; it does not set or derive from any lab result — the batch's primary test result tracks potency separately. body string false

Responses

Status Description Schema
200 A single batch BatchFullResponse

Get a batch

GET /public/v1/batches/:id returns a single batch

GET /public/v1/batches/00000000-0000-0000-0000-0000000008a7
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMmMzODljMTQtZGFkMi00NTJmLTg1YzUtZmIzYjQzMDk3NDA2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzU1NyIsInR5cCI6ImFjY2VzcyJ9.QV0TMZ8-l0-C53fev6K49NmQ8GTwUSRCDj_SYAVCZXM

Response

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

{
  "data": {
    "batch_number": "B001",
    "cbd": null,
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-663@example.com",
      "full_name": "FirstName1320 LastName1321",
      "id": "00000000-0000-0000-0000-000000001d8d",
      "inserted_datetime": "2026-08-19T13:19:28.709638Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001e4d",
        "name": "Admin 716"
      }
    },
    "custom_data": [
      {
        "id": 197,
        "name": "Custom Field 18",
        "value": "Custom Data 1"
      }
    ],
    "deleted_at": null,
    "description": "Test batch",
    "expiration_date": null,
    "harvest_datetime": null,
    "id": "00000000-0000-0000-0000-0000000008a7",
    "inserted_datetime": "2026-08-19T13:19:28.716204Z",
    "manufactured_datetime": "2026-08-19T13:19:28.681576Z",
    "name": "B196",
    "owner_id": "00000000-0000-0000-0000-000000001d8e",
    "primary_test_result": null,
    "product_id": "5ad38585-1637-4147-97d8-a1cef51db640",
    "thc": null,
    "updated_datetime": "2026-08-19T13:19:28.716204Z"
  }
}

Get a single batch given the ID.

Required permission: products_permissions_view.

Request

GET /public/v1/batches/{id}

Parameters

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

Responses

Status Description Schema
200 A single batch BatchFullResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMDU4ZmUwZDUtNmI4ZC00ZWYwLTg1ODUtZDlkYWEwYmEzZDc4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzc5MyIsInR5cCI6ImFjY2VzcyJ9.x5D2xc6lwURkeXTWD0cXqM73zi54TN0UHfzstdtGv28

Response

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

{
  "data": [
    {
      "batch_number": null,
      "cbd": null,
      "creator": null,
      "custom_data": [
        {
          "id": 202,
          "name": "Custom Field 23",
          "value": "Custom Data 1"
        }
      ],
      "deleted_at": null,
      "description": null,
      "expiration_date": "2024-01-01T00:00:00.000000Z",
      "harvest_datetime": null,
      "id": "00000000-0000-0000-0000-0000000008c0",
      "inserted_datetime": "2026-08-19T13:19:29.592463Z",
      "manufactured_datetime": "2024-01-02T03:04:05.000000Z",
      "name": "B290",
      "owner_id": "00000000-0000-0000-0000-000000001e73",
      "primary_test_result": null,
      "product_id": "a8f1ece3-1bbe-482f-af89-3c8d533ec0b1",
      "thc": null,
      "updated_datetime": "2026-08-19T13:19:29.592463Z"
    },
    {
      "batch_number": null,
      "cbd": "0.5",
      "creator": null,
      "custom_data": [
        {
          "id": 202,
          "name": "Custom Field 23",
          "value": null
        }
      ],
      "deleted_at": null,
      "description": null,
      "expiration_date": null,
      "harvest_datetime": "2024-06-15T00:00:00.000000Z",
      "id": "00000000-0000-0000-0000-0000000008c1",
      "inserted_datetime": "2026-08-19T13:19:29.606738Z",
      "manufactured_datetime": "2024-01-02T03:04:05.000000Z",
      "name": "B295",
      "owner_id": "00000000-0000-0000-0000-000000001e7b",
      "primary_test_result": {
        "cbd_mg_per_unit": "1",
        "cbd_mg_per_unit_total": "2",
        "cbd_percentage": "3",
        "cbd_percentage_total": "4",
        "coa_url": null,
        "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": "223c93a4-f6d4-4570-a95f-467e21bc9917",
      "thc": "22.5",
      "updated_datetime": "2026-08-19T13:19:29.606738Z"
    }
  ],
  "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.

Required permission: products_permissions_view. Results are filtered to only include batches the authenticated user can access under their team restrictions.

Request

GET /public/v1/batches

Parameters

Parameter Description In Type Required Default Example
batch_ids Filter batches by batch IDs query array false ?batch_ids[]=00000000-0000-0000-0000-000000000001&batch_ids[]=00000000-0000-0000-0000-000000000002
batch_number Filter batches by batch number query string false
deleted Filter deleted batches. no returns non-deleted, only returns deleted, include returns both. query string false no
inserted_datetime Filter batches by their creation datetime query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1
product_id Filter batches by product ID query string 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

Bin

Delete a bin

DELETE /public/v1/bins/:id deletes a bin and its batch associations

DELETE /public/v1/bins/456f1b63-2f6a-4064-b184-e186fd24102a
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiM2FhMjQ5YTQtY2ZkNS00N2VmLWJiMDMtMjJjZjY1OGU5N2NiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NjkzMSIsInR5cCI6ImFjY2VzcyJ9.RN4LCpS6UQy8PKqJ8BBoPSnw_4Ug_ZmJmUadM5POtqo

Response

204
cache-control: max-age=0, private, must-revalidate
b3: 6392aef43bab9fafeb469fa360ff0aa5-5c8712be13a4192e-0

Permanently deletes the bin (hard delete — it is removed from the database, not soft-deleted) and removes it from any batches, packages, plants, plant groups and assembly outputs it is associated with.

Bins require bin inventory tracking to be enabled for your company; the request is rejected otherwise.

Required permission: settings_permissions_bins.

Request

DELETE /public/v1/bins/{id}

Parameters

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

Responses

Status Description Schema
204 No Content
404 Not Found

Get a bin

GET /public/v1/bins/:id returns a single bin

GET /public/v1/bins/a196ba27-ebc3-46ab-ac09-b98ff3635011
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTA0NGMxN2EtN2I4Ni00YTgwLTkxZWUtOWMyZmFjMjgxN2Q5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk1MCIsInR5cCI6ImFjY2VzcyJ9.7HKWMDBpG7XGr_bUSXuG6mYs7YEmLk2XfQ2axZcvlqo

Response

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

{
  "data": {
    "id": "a196ba27-ebc3-46ab-ac09-b98ff3635011",
    "inserted_datetime": "2026-08-19T13:19:26.238934Z",
    "name": "Cold Room",
    "updated_datetime": "2026-08-19T13:19:26.238934Z"
  }
}

Get a single bin given the ID.

Required permission: settings_permissions_bins.

Request

GET /public/v1/bins/{id}

Parameters

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

Responses

Status Description Schema
200 A single bin BinResponse
404 Not Found

Get bins

GET /public/v1/bins returns paginated bins sorted by name with next_page

GET /public/v1/bins
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTBlOWY4ZWYtZjAxYi00NTE0LWJlMzctYWJlYTIxNGVhNzUxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzAwOCIsInR5cCI6ImFjY2VzcyJ9.UCLhMLesOcamSP1dFLXksZxTQh_wRjeRdrNo1AOQIqE

Response

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

{
  "data": [
    {
      "id": "12c2d3ba-31ad-4e35-b0e5-d7c7715cb6a9",
      "inserted_datetime": "2026-08-19T13:19:26.503941Z",
      "name": "AAA",
      "updated_datetime": "2026-08-19T13:19:26.503941Z"
    },
    {
      "id": "6d579b66-1894-47b8-9974-a953de4cef5a",
      "inserted_datetime": "2026-08-19T13:19:26.504609Z",
      "name": "BBB",
      "updated_datetime": "2026-08-19T13:19:26.504609Z"
    },
    {
      "id": "45586fb9-399b-4b50-b289-21e1ba96e85c",
      "inserted_datetime": "2026-08-19T13:19:26.504947Z",
      "name": "CCC",
      "updated_datetime": "2026-08-19T13:19:26.504947Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/bins?page[number]=2"
}

List bins for the authenticated company, sorted alphabetically by name.

Required permission: settings_permissions_bins.

Request

GET /public/v1/bins

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1
search If present, only bins whose name matches are returned query string false

Responses

Status Description Schema
200 A list of bins Bins

Upsert a bin

POST /public/v1/bins creates a bin

POST /public/v1/bins
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDFmZTE4M2QtMGNjNy00Nzg0LTgwOWEtNDAyMGU3YTA0MDQwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk2MiIsInR5cCI6ImFjY2VzcyJ9.PxaCwtWVbwUDYYpHRE2gCnWuSqwcb3_lzG7EMPrG0_Q

{
  "name": "Vault"
}

Response

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

{
  "data": {
    "id": "a6ac3db4-335b-460c-97d6-8fd0f210eeb7",
    "inserted_datetime": "2026-08-19T13:19:26.307132Z",
    "name": "Vault",
    "updated_datetime": "2026-08-19T13:19:26.307132Z"
  }
}

Upsert a single bin. To update an existing bin, pass its ID in the id field. If you do not pass an ID, a new bin is created.

Bin names must be unique within a company and cannot contain commas.

Bins require bin inventory tracking to be enabled for your company; the request is rejected otherwise.

Required permission: settings_permissions_bins.

Request

POST /public/v1/bins

Parameters

Parameter Description In Type Required Default Example
id Bin ID. If given, the matching bin is updated; otherwise a new one is created. body string false
name The name of the bin body string true

Responses

Status Description Schema
200 The updated bin BinResponse
201 The created bin BinResponse
400 Invalid parameters
404 Not Found

Company

Get a company

GET /public/v1/companies/:id returns a single company

GET /public/v1/companies/00000000-0000-0000-0000-000000000dc7
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzAyMDMzMDktODRiNC00MmQxLWFkNDMtZjYyNTFkOTE3OWM0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzYxNyIsInR5cCI6ImFjY2VzcyJ9.d71VbbfiVictzXJBU2tgsTnp8CPJuJ5-ek1dHLS89fE

Response

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

{
  "data": {
    "category": "Retailer",
    "custom_data": [
      {
        "id": 199,
        "name": "Custom Field 20",
        "value": "Custom Value"
      }
    ],
    "default_email": "co@example.com",
    "default_payment_term": {
      "days": 15,
      "id": "00000000-0000-0000-0000-000000000020",
      "inserted_datetime": "2026-08-19T13:19:28.960252Z",
      "locked": false,
      "name": "Net 15",
      "time_of_day": "17:00:00",
      "updated_datetime": "2026-08-19T13:19:28.960252Z"
    },
    "default_purchase_order_notes": null,
    "default_sales_order_notes": null,
    "deleted_at": null,
    "group": {
      "id": "00000000-0000-0000-0000-000000000021",
      "name": "Comp Rel Group 0"
    },
    "id": "00000000-0000-0000-0000-000000000dc7",
    "inserted_datetime": "2026-08-19T13:19:28.966346Z",
    "invoice_email": "inv@example.com",
    "leaflink_brand_id": null,
    "leaflink_customer_id": null,
    "legal_business_name": "Legal Co",
    "licenses": [
      {
        "active": true,
        "expiry_datetime": "2026-09-19T13:19:28.957913Z",
        "id": "00000000-0000-0000-0000-0000000001ca",
        "inserted_datetime": "2026-08-19T13:19:28.958043Z",
        "issue_datetime": "2026-08-19T13:19:28.957912Z",
        "license_number": "CDPH-00000016",
        "license_type": "Medium Mixed-Light Tier 2"
      }
    ],
    "locations": [
      {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-0000000016a4",
        "id": "00000000-0000-0000-0000-000000000700",
        "license_id": null,
        "name": "Place 124"
      }
    ],
    "name": "Company 588",
    "order_shipment_email": null,
    "outstanding_balance": "0",
    "outstanding_balance_threshold": null,
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-719@example.com",
      "full_name": "FirstName1434 LastName1435",
      "id": "00000000-0000-0000-0000-000000001dc5",
      "inserted_datetime": "2026-08-19T13:19:28.963947Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001e88",
        "name": "Admin 775"
      }
    },
    "owner_id": "00000000-0000-0000-0000-000000001dc5",
    "phone_number": null,
    "purchase_order_email": null,
    "qb_customer_id": null,
    "qb_vendor_id": null,
    "relationship_type": {
      "id": "00000000-0000-0000-0000-000000000007",
      "name": "Supplier"
    },
    "sales_order_email": "order@example.com",
    "updated_datetime": "2026-08-19T13:19:28.966346Z",
    "website": null
  }
}

Get a single company given the ID.

Required permission: companies_permissions_view.

Request

GET /public/v1/companies/{id}

Parameters

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

Responses

Status Description Schema
200 A single company CompanyResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzE0MzgxYWEtYmE3NC00ODhiLThkYTUtZDM2NDIxZDRhMGQyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzc3NyIsInR5cCI6ImFjY2VzcyJ9.QCXDcOGs_rQO5bDl8KE7baO2iqrZnYuzZ277pLttIN4

Response

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

{
  "data": [
    {
      "category": "Retailer",
      "custom_data": [
        {
          "id": 201,
          "name": "Custom Field 22",
          "value": "Custom Data 1"
        }
      ],
      "default_email": "company-1@example.com",
      "default_payment_term": null,
      "default_purchase_order_notes": "Default Purchase Order Notes 1",
      "default_sales_order_notes": "Default Order External Notes 1",
      "deleted_at": null,
      "group": {
        "id": "00000000-0000-0000-0000-000000000022",
        "name": "Comp Rel Group 1"
      },
      "id": "00000000-0000-0000-0000-000000000e1c",
      "inserted_datetime": "2023-10-01T00:00:00.000000Z",
      "invoice_email": "invoice email",
      "leaflink_brand_id": 777,
      "leaflink_customer_id": 555,
      "legal_business_name": "Company Legal Name 1",
      "licenses": [
        {
          "active": true,
          "expiry_datetime": "2026-09-19T13:19:29.529664Z",
          "id": "00000000-0000-0000-0000-0000000001cf",
          "inserted_datetime": "2026-08-19T13:19:29.529764Z",
          "issue_datetime": "2026-08-19T13:19:29.529662Z",
          "license_number": "CDPH-00000022",
          "license_type": "Small Outdoor"
        }
      ],
      "locations": [
        {
          "address": "123 Fake Street, Beverly Hills, CA 90210, US",
          "company_id": "00000000-0000-0000-0000-000000001718",
          "id": "00000000-0000-0000-0000-000000000712",
          "license_id": null,
          "name": "Place 142"
        }
      ],
      "name": "Company 703",
      "order_shipment_email": "order shipment email",
      "outstanding_balance": "0",
      "outstanding_balance_threshold": 1000,
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "owner@example.com",
        "full_name": "FirstName1752 LastName1753",
        "id": "00000000-0000-0000-0000-000000001e63",
        "inserted_datetime": "2026-08-19T13:19:29.515926Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000001f2a",
          "name": "Admin 937"
        }
      },
      "owner_id": "00000000-0000-0000-0000-000000001e63",
      "phone_number": "1234567890",
      "purchase_order_email": "purchase email",
      "qb_customer_id": "QB-CUST-1",
      "qb_vendor_id": "QB-VEND-1",
      "relationship_type": {
        "id": "00000000-0000-0000-0000-000000000008",
        "name": "Supplier"
      },
      "sales_order_email": "order email",
      "updated_datetime": "2023-11-03T00:00:00.000000Z",
      "website": "https://www.example.com"
    },
    {
      "category": "Manufacturer",
      "custom_data": [
        {
          "id": 201,
          "name": "Custom Field 22",
          "value": null
        }
      ],
      "default_email": "company-1586@example.com",
      "default_payment_term": null,
      "default_purchase_order_notes": null,
      "default_sales_order_notes": null,
      "deleted_at": null,
      "group": null,
      "id": "00000000-0000-0000-0000-000000000e1d",
      "inserted_datetime": "2023-10-02T00:00:00.000000Z",
      "invoice_email": null,
      "leaflink_brand_id": null,
      "leaflink_customer_id": null,
      "legal_business_name": "Company Legal Name 706",
      "licenses": [
        {
          "active": true,
          "expiry_datetime": "2026-09-19T13:19:29.539059Z",
          "id": "00000000-0000-0000-0000-0000000001d0",
          "inserted_datetime": "2026-08-19T13:19:29.539126Z",
          "issue_datetime": "2026-08-19T13:19:29.539058Z",
          "license_number": "CDPH-00000023",
          "license_type": "Type 10 Retailer"
        }
      ],
      "locations": [],
      "name": "Company 706",
      "order_shipment_email": null,
      "outstanding_balance": "0",
      "outstanding_balance_threshold": null,
      "owner": null,
      "owner_id": null,
      "phone_number": null,
      "purchase_order_email": null,
      "qb_customer_id": null,
      "qb_vendor_id": 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.

Required permission: companies_permissions_view. Results are filtered to only include companies the authenticated user can access under their team restrictions.

Request

GET /public/v1/companies

Parameters

Parameter Description In Type Required Default Example
deleted Filter deleted companies. no returns non-deleted, only returns deleted, include returns both. query string false no
inserted_datetime Filter companies by their creation datetime query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1
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

Upsert a company

POST /public/v1/companies upsert returns the related company's locations and licenses

POST /public/v1/companies
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiM2VjY2NmNzUtYTc5ZC00MjFkLThlMzUtZGI0OGNiMjJhODVmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzY5NCIsInR5cCI6ImFjY2VzcyJ9.lvjdl6LDAwNh43uc8nUNlY17s0yhs8KEpJFpVMCXu3g

{
  "id": "00000000-0000-0000-0000-000000000df2",
  "name": "Updated Name"
}

Response

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

{
  "data": {
    "category": "Delivery",
    "custom_data": [],
    "default_email": "company-1441@example.com",
    "default_payment_term": null,
    "default_purchase_order_notes": null,
    "default_sales_order_notes": null,
    "deleted_at": null,
    "group": null,
    "id": "00000000-0000-0000-0000-000000000df2",
    "inserted_datetime": "2026-08-19T13:19:29.224722Z",
    "invoice_email": null,
    "leaflink_brand_id": null,
    "leaflink_customer_id": null,
    "legal_business_name": "Company Legal Name 645",
    "licenses": [
      {
        "active": true,
        "expiry_datetime": "2026-09-19T13:19:29.218666Z",
        "id": "00000000-0000-0000-0000-0000000001cc",
        "inserted_datetime": "2026-08-19T13:19:29.218709Z",
        "issue_datetime": "2026-08-19T13:19:29.218666Z",
        "license_number": "CDPH-00000018",
        "license_type": "Nursery"
      }
    ],
    "locations": [
      {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-0000000016dd",
        "id": "00000000-0000-0000-0000-00000000070c",
        "license_id": null,
        "name": "Place 136"
      }
    ],
    "name": "Updated Name",
    "order_shipment_email": null,
    "outstanding_balance": "0",
    "outstanding_balance_threshold": null,
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-802@example.com",
      "full_name": "FirstName1599 LastName1601",
      "id": "00000000-0000-0000-0000-000000001e16",
      "inserted_datetime": "2026-08-19T13:19:29.223289Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001edd",
        "name": "Admin 860"
      }
    },
    "owner_id": "00000000-0000-0000-0000-000000001e16",
    "phone_number": null,
    "purchase_order_email": null,
    "qb_customer_id": null,
    "qb_vendor_id": null,
    "relationship_type": null,
    "sales_order_email": null,
    "updated_datetime": "2026-08-19T13:19:29.235344Z",
    "website": null
  }
}

Upsert a single company. To update an existing company, pass in an existing company ID in the id field. If you do not pass in an ID, a new company and its associated company will be created. Required permission: companies_permissions_create to create a new company, companies_permissions_edit (and access to the company under team restrictions) to update an existing company.

Request

POST /public/v1/companies

Parameters

Parameter Description In Type Required Default Example
category Category of the related company body string false Retailer
custom_data A map of custom field IDs to their values. Use GET /public/v1/custom-fields?parent_object=company to retrieve available custom fields, their IDs, and their types. The value format depends on the field's type: a text field takes a string, a date field takes a full ISO8601 datetime, and a checkbox field takes an array of its selected options. body object false {"101":"Some text value","102":"2026-08-18T00:00:00.000-07:00","103":["Option A","Option B"]}
default_email Default email address for the related company body string false
default_payment_term_id The ID of the payment term to apply by default to this company relationship. Use GET /public/v1/payment-terms to look up available payment term IDs. body string false
default_purchase_order_notes Default notes included on purchase orders for this company body string false
default_sales_order_notes Default notes included on sales orders for this company body string false
group_id The ID of the group to assign to this company relationship body string false
id Unique ID for this company. If given, the matching record will be updated. If not given, a new company will be created. body string false
invoice_email Email address for invoices sent to this company body string false
legal_business_name Legal business name of the related company body string false
name Name of the related company body string false Acme Dispensary
order_shipment_email Email address for order shipment notifications sent to this company body string false
outstanding_balance_threshold Threshold amount (in cents) above which an outstanding balance warning is triggered body integer false
owner_id The ID of the user that owns this company relationship body string false
phone_number Phone number for the related company body string false
purchase_order_email Email address for purchase orders sent to this company body string false
relationship_type_id The ID of the relationship type to assign to this company relationship body string false
sales_order_email Email address for sales orders sent to this company body string false
website Website URL for the related company body string false

Responses

Status Description Schema
200 An updated company relationship CompanyResponse
201 A new company relationship CompanyResponse
400 Bad request
404 Not found

CompanyGroup

Delete a company group

DELETE /public/v1/company-groups/:id deletes a company group

DELETE /public/v1/company-groups/00000000-0000-0000-0000-000000000024
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTA4ZGNjYmItNmJmOC00OGZmLTkyYTMtNzgzYWRlMTAwYmRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODEwMSIsInR5cCI6ImFjY2VzcyJ9.Zd32G9qXVHcDvjB6LOrxnW42rs6G11lBlO31zZ7usS8

Response

204
cache-control: max-age=0, private, must-revalidate
b3: bb4071366d0e5d12ad1f4feab05432d0-7d9a14389913c60b-0

Permanently deletes the company group. This is a hard delete: the record is removed from the database and cannot be recovered.

Required permission: settings_permissions_company_relationship_groups.

Request

DELETE /public/v1/company-groups/{id}

Parameters

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

Responses

Status Description Schema
204 No Content
404 Not Found

Get a company group

GET /public/v1/company-groups/:id returns a single company group

GET /public/v1/company-groups/00000000-0000-0000-0000-00000000002b
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzJlMmM2Y2MtNzJjZC00ZWU5LWIyZjQtMmYxMWY1ZGRhNTA4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODE2OSIsInR5cCI6ImFjY2VzcyJ9.AXZQ5NxAkH4glmpryYLlnzKfPVMa2zunr_q4nhwRyMw

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-00000000002b",
    "inserted_datetime": "2026-08-19T13:19:30.952522Z",
    "name": "Key Accounts",
    "updated_datetime": "2026-08-19T13:19:30.952522Z"
  }
}

Get a single company group given the ID.

Required permission: settings_permissions_company_relationship_groups.

Request

GET /public/v1/company-groups/{id}

Parameters

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

Responses

Status Description Schema
200 A single company group CompanyGroupFullResponse
404 Not Found

Get company groups

GET /public/v1/company-groups returns paginated company groups for the company with next_page

GET /public/v1/company-groups
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOGQ4YTBjYTMtYjRiNy00OTQxLWIxZGUtNGMyNTY0ODEwYmE5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODE4NiIsInR5cCI6ImFjY2VzcyJ9.uCpuTb_MNYOoQozLoEFmrpFB2MNYO25t4T3ssVP7lS0

Response

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

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-00000000002c",
      "inserted_datetime": "2026-08-19T13:19:31.020241Z",
      "name": "CG1",
      "updated_datetime": "2026-08-19T13:19:31.020241Z"
    },
    {
      "id": "00000000-0000-0000-0000-00000000002d",
      "inserted_datetime": "2026-08-19T13:19:31.020619Z",
      "name": "CG2",
      "updated_datetime": "2026-08-19T13:19:31.020619Z"
    },
    {
      "id": "00000000-0000-0000-0000-00000000002e",
      "inserted_datetime": "2026-08-19T13:19:31.020901Z",
      "name": "CG3",
      "updated_datetime": "2026-08-19T13:19:31.020901Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/company-groups?page[number]=2"
}

List company groups for the authenticated company.

Required permission: settings_permissions_company_relationship_groups.

Request

GET /public/v1/company-groups

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of company groups CompanyGroups

Upsert a company group

POST /public/v1/company-groups creates a company group

POST /public/v1/company-groups
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOWZjZTY5NzUtZDE5Mi00MGRlLWFmOWEtODU5OTgyNTAzZWFkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODEyNyIsInR5cCI6ImFjY2VzcyJ9.LW8KLG8LIR8wV8W_hLPyIWRs_IQKKg0CBXzwD41FD_s

{
  "name": "Key Accounts"
}

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000026",
    "inserted_datetime": "2026-08-19T13:19:30.819132Z",
    "name": "Key Accounts",
    "updated_datetime": "2026-08-19T13:19:30.819132Z"
  }
}

Upsert a single company group. To update an existing company group, pass its ID in the id field. If you do not pass an ID, a new company group is created.

Required permission: settings_permissions_company_relationship_groups.

Request

POST /public/v1/company-groups

Parameters

Parameter Description In Type Required Default Example
id Company group ID. If given, the matching company group is updated; otherwise a new one is created. body string false
name The name of the company group body string true

Responses

Status Description Schema
200 The updated company group CompanyGroupFullResponse
201 The created company group CompanyGroupFullResponse
400 Invalid parameters
404 Not Found

Contact

Get a contact

GET /public/v1/contacts/:id returns a single contact

GET /public/v1/contacts/00000000-0000-0000-0000-000000000069
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODA1ZWIzOTAtMDBlYy00NTk0LWFiMmMtNDNmMjMxMjhmMDM1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzk0OSIsInR5cCI6ImFjY2VzcyJ9.RRroqNhh_Q8K-fGH27c-hWfOxtP-zYfILSLWe2uinjg

Response

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

{
  "data": {
    "company": {
      "id": "00000000-0000-0000-0000-000000000e61"
    },
    "custom_data": [
      {
        "id": 205,
        "name": "Custom Field 26",
        "value": "Custom Data 1"
      }
    ],
    "deleted_at": null,
    "description": null,
    "driver_license_issuing_state": null,
    "driver_license_number": null,
    "email": null,
    "first_name": "John",
    "full_name": "John Doe",
    "id": "00000000-0000-0000-0000-000000000069",
    "inserted_datetime": "2026-08-19T13:19:30.216543Z",
    "last_name": "Doe",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-1050@example.com",
      "full_name": "FirstName2120 LastName2121",
      "id": "00000000-0000-0000-0000-000000001f10",
      "inserted_datetime": "2026-08-19T13:19:30.209409Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001fd4",
        "name": "Admin 1107"
      }
    },
    "phone_number": null,
    "title": null,
    "updated_datetime": "2026-08-19T13:19:30.216543Z",
    "work_phone_number": null
  }
}

Get a single contact given the ID.

Required permission: contacts_permissions_view.

Request

GET /public/v1/contacts/{id}

Parameters

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

Responses

Status Description Schema
200 A single contact ContactResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzEzYzVhN2ItZmRiZi00OGI0LWIxNjEtYjViZTZhNTJmYjY2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODIwNSIsInR5cCI6ImFjY2VzcyJ9.s1bGeRjBVENVJ5a3M8B7GNnFcjldtz8CHIUnTqIq9AE

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 70491583930ab91ae2b98b7fa30a1f52-2246ae203f5fdc56-0

{
  "data": [
    {
      "company": {
        "id": "00000000-0000-0000-0000-000000000ead"
      },
      "custom_data": [
        {
          "id": 212,
          "name": "Custom Field 33",
          "value": "Custom Data 1"
        }
      ],
      "deleted_at": null,
      "description": "Description 1",
      "driver_license_issuing_state": "CA",
      "driver_license_number": "1234567890",
      "email": "email1",
      "first_name": "first",
      "full_name": "first name1",
      "id": "00000000-0000-0000-0000-000000000082",
      "inserted_datetime": "2026-08-19T13:19:31.111858Z",
      "last_name": "name1",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "contact-owner@example.com",
        "full_name": "FirstName2668 LastName2669",
        "id": "00000000-0000-0000-0000-00000000200f",
        "inserted_datetime": "2026-08-19T13:19:31.105915Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000020d5",
          "name": "Admin 1364"
        }
      },
      "phone_number": "1234567890",
      "title": null,
      "updated_datetime": "2026-08-19T13:19:31.111858Z",
      "work_phone_number": "1234567891"
    },
    {
      "company": {
        "id": "00000000-0000-0000-0000-000000000eae"
      },
      "custom_data": [
        {
          "id": 212,
          "name": "Custom Field 33",
          "value": null
        }
      ],
      "deleted_at": null,
      "description": "Description 2",
      "driver_license_issuing_state": "NV",
      "driver_license_number": "123456789",
      "email": "email2",
      "first_name": "first",
      "full_name": "first name2",
      "id": "00000000-0000-0000-0000-000000000083",
      "inserted_datetime": "2026-08-19T13:19:31.117640Z",
      "last_name": "name2",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "contact-owner@example.com",
        "full_name": "FirstName2668 LastName2669",
        "id": "00000000-0000-0000-0000-00000000200f",
        "inserted_datetime": "2026-08-19T13:19:31.105915Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000020d5",
          "name": "Admin 1364"
        }
      },
      "phone_number": "1234567890",
      "title": null,
      "updated_datetime": "2026-08-19T13:19:31.117640Z",
      "work_phone_number": "1234567892"
    }
  ],
  "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.

Required permission: contacts_permissions_view. Results are filtered to only include contacts the authenticated user can access under their team restrictions.

Request

GET /public/v1/contacts

Parameters

Parameter Description In Type Required Default Example
deleted Filter deleted contacts. no returns non-deleted, only returns deleted, include returns both. query string false no
inserted_datetime Filter contacts by their creation datetime query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1
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

Upsert a contact

POST /public/v1/contacts creating a contact with all optional fields succeeds with a 201 response containing the new contact

POST /public/v1/contacts
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTQ1ZTc5NmMtOTlmMC00NzZhLWEwMjItNzAyMWQ4MzQyNTkyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODIyMyIsInR5cCI6ImFjY2VzcyJ9.ImcaK5LZS-jvN_SJ_DhiJLVJNKE8k-tSRGvU8BPVI6E

{
  "company_id": "00000000-0000-0000-0000-000000000eb6",
  "custom_data": {
    "213": [
      "VIP",
      "Wholesale"
    ]
  },
  "description": "Notes",
  "driver_license_issuing_state": "CA",
  "driver_license_number": "D123",
  "email": "jane@example.com",
  "first_name": "Jane",
  "last_name": "Doe",
  "owner_id": "00000000-0000-0000-0000-000000002024",
  "phone_number": "555-1111",
  "title": "Buyer",
  "work_phone_number": "555-2222"
}

Response

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

{
  "data": {
    "company": {
      "id": "00000000-0000-0000-0000-000000000eb6"
    },
    "custom_data": [
      {
        "id": 213,
        "name": "Custom Field 34",
        "value": "VIP,Wholesale"
      }
    ],
    "deleted_at": null,
    "description": "Notes",
    "driver_license_issuing_state": "CA",
    "driver_license_number": "D123",
    "email": "jane@example.com",
    "first_name": "Jane",
    "full_name": "Jane Doe",
    "id": "00000000-0000-0000-0000-000000000086",
    "inserted_datetime": "2026-08-19T13:19:31.188851Z",
    "last_name": "Doe",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-1325@example.com",
      "full_name": "FirstName2714 LastName2715",
      "id": "00000000-0000-0000-0000-000000002024",
      "inserted_datetime": "2026-08-19T13:19:31.170316Z",
      "role": {
        "id": "00000000-0000-0000-0000-0000000020ea",
        "name": "Admin 1385"
      }
    },
    "phone_number": "555-1111",
    "title": "Buyer",
    "updated_datetime": "2026-08-19T13:19:31.188851Z",
    "work_phone_number": "555-2222"
  }
}

Upsert a single contact. To update an existing contact, pass in an existing contact ID in the id field as well as the other fields you want to update. If you do not pass in an ID, a new contact will be created. Required permission: contacts_permissions_create to create a new contact, contacts_permissions_edit (and access to the contact under team restrictions) to update an existing contact.

Request

POST /public/v1/contacts

Parameters

Parameter Description In Type Required Default Example
company_id The ID of the company relationship (company) this contact belongs to body string false
custom_data A map of custom field IDs to their values. Use GET /public/v1/custom-fields?parent_object=contact to retrieve available custom fields, their IDs, and their types. The value format depends on the field's type: a text field takes a string, a date field takes a full ISO8601 datetime, and a checkbox field takes an array of its selected options. body object false {"101":"Some text value","102":"2026-08-18T00:00:00.000-07:00","103":["Option A","Option B"]}
description Description for the contact body string false
driver_license_issuing_state Driver license issuing state for shipping manifests body string false
driver_license_number Driver license number for shipping manifests body string false
email Email address for the contact body string false
first_name First name for the contact body string true
id Unique ID for this contact. If given, the contact matching the ID will be updated. If not given, a new contact will be created. body string false
last_name Last name for the contact body string false
owner_id The ID of the user that owns this contact body string false
phone_number Phone number for the contact body string false
title Job title for the contact body string false
work_phone_number Work phone number for the contact body string false

Responses

Status Description Schema
200 An updated contact ContactResponse
201 A new contact ContactResponse
400 Bad request
404 Not found

Cost

Add costs to batches

POST /public/v1/batches/add-costs adds costs to a batch and distributes across batches by quantity

POST /public/v1/batches/add-costs
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiM2UxMjg4MGEtMjlmZi00YjUyLThhMDItNzRiZWQ5ODYwNDE3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODEyMCIsInR5cCI6ImFjY2VzcyJ9.sMfE_ynDAJz9qjotDfm6qAuZ_5NA1y1uHZ-3-IE2gfM

{
  "batch_ids": [
    "00000000-0000-0000-0000-000000000903"
  ],
  "costs": [
    {
      "cost_per_unit": 3,
      "cost_type_id": "00000000-0000-0000-0000-000000000047",
      "quantity": 2
    }
  ]
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 7678a557d78bba32700895b640531a2e-10570661b8719cb7-0

{
  "data": [
    {
      "batch_number": null,
      "cbd": null,
      "cost_per_unit_actual": "1.2",
      "cost_per_unit_default": "0.8",
      "creator": null,
      "custom_data": [],
      "deleted_at": null,
      "description": null,
      "expiration_date": null,
      "harvest_datetime": null,
      "id": "00000000-0000-0000-0000-000000000903",
      "inserted_datetime": "2026-08-19T13:19:30.825667Z",
      "manufactured_datetime": "2026-08-19T13:19:30.771958Z",
      "name": "B479",
      "owner_id": "00000000-0000-0000-0000-000000001fc5",
      "primary_test_result": null,
      "product_id": "1cbc272b-7346-4526-9c1e-b2d3832eeb82",
      "thc": null,
      "total_cost_actual": "6",
      "total_cost_default": "4",
      "updated_datetime": "2026-08-19T13:19:30.825667Z"
    }
  ]
}

Add one or more costs to each of the given batches.

batch_ids is a non-empty list of batch UUIDs. Every batch must belong to a batch-tracked product. The cost is applied to each batch's active quantity. location_ids optionally scopes the batch stock the cost applies to; omit it to apply across all locations.

Each entry in costs accepts the following fields:

When distribute_by_quantity is true, the total of each cost (cost_per_unit × quantity) is split across the selected records in proportion to each record's quantity, instead of applying the full cost to every record. Quantities are converted to a common unit before the split, so all selected records must share the same unit type category. Selecting a single record is a no-op (the whole cost lands on it). When false or omitted, the same cost is applied in full to each selected record.

Common errors (HTTP 400 unless noted):

Required permission: costs_permissions_apply_to_inventory.

Request

POST /public/v1/batches/add-costs

Parameters

Parameter Description In Type Required Default Example
payload The batches and costs to apply body AddBatchCostsRequest true

Responses

Status Description Schema
200 The affected batches Batches
400 Invalid parameters
403 Cost Accounting disabled or missing permission

Add costs to packages

POST /public/v1/packages/add-costs adds a cost to a package

POST /public/v1/packages/add-costs
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWU5ODM2NzEtMjhmYS00OGQ3LWExZmQtMjdlZjc0NDJmOTIxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODE2NCIsInR5cCI6ImFjY2VzcyJ9.q9ZNiyUbPK44lnRO1LwzZtHq2Z7qk4oQjIKkPIa6BxM

{
  "costs": [
    {
      "cost_type_id": "00000000-0000-0000-0000-000000000049",
      "quantity": 4
    }
  ],
  "package_ids": [
    "00000000-0000-0000-0000-00000000010c"
  ]
}

Response

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

{
  "data": [
    {
      "batch_number": null,
      "biotrack_id": null,
      "biotrack_inventory_type_id": null,
      "biotrack_net_quantity_per_unit": null,
      "biotrack_room_id": null,
      "biotrack_status": null,
      "biotrack_usable_weight": null,
      "compliance_label": "ABCDEF012345670000000030",
      "compliance_product_name": "Buds",
      "compliance_strain_name": "Cotton Candy",
      "compliance_transferred_datetime": null,
      "compliance_type": "METRC",
      "cost_per_unit_actual": "2.666666666666666666666666667",
      "cost_per_unit_default": "2.666666666666666666666666667",
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-1283@example.com",
        "full_name": "FirstName2616 LastName2617",
        "id": "00000000-0000-0000-0000-000000001ff9",
        "inserted_datetime": "2026-08-19T13:19:31.004285Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000020bd",
          "name": "Admin 1340"
        }
      },
      "custom_data": [],
      "description": null,
      "expiration_date": null,
      "expiration_datetime": null,
      "finished_datetime": null,
      "harvest_date": null,
      "id": "00000000-0000-0000-0000-00000000010c",
      "inactivated_datetime": null,
      "inserted_datetime": "2026-08-19T13:19:31.030078Z",
      "is_production_batch": false,
      "is_test_sample": false,
      "is_trade_sample": false,
      "lab_testing_state": "NotSubmitted",
      "license": {
        "active": true,
        "expiry_datetime": "2026-09-19T13:19:30.946466Z",
        "id": "00000000-0000-0000-0000-0000000001de",
        "inserted_datetime": "2026-08-19T13:19:30.946527Z",
        "issue_datetime": "2026-08-19T13:19:30.946465Z",
        "license_number": "CDPH-00000038",
        "license_type": "Medium Indoor"
      },
      "location": {
        "id": "00000000-0000-0000-0000-00000000077e",
        "name": "Place 250"
      },
      "metrc_archived_date": null,
      "metrc_finished_date": null,
      "metrc_id": 30,
      "metrc_label": "ABCDEF012345670000000030",
      "metrc_production_batch_number": null,
      "metrc_received_datetime": null,
      "metrc_received_from_manifest_number": null,
      "metrc_source_harvest_names": null,
      "metrc_status": "ACTIVE",
      "metrc_transfer_id": null,
      "metrc_unit_name": "Ounces",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-1272@example.com",
        "full_name": "FirstName2592 LastName2593",
        "id": "00000000-0000-0000-0000-000000001fee",
        "inserted_datetime": "2026-08-19T13:19:30.972867Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000020b2",
          "name": "Admin 1329"
        }
      },
      "packaged_date": "2014-11-29",
      "primary_test_result": null,
      "product_id": "5aec1ada-8882-4c49-917c-a4e9a0e260d3",
      "product_unit_quantity": "3.000000000",
      "product_unit_type": {
        "id": "00000000-0000-0000-0000-00000001320c",
        "name": "Ounce"
      },
      "quantity": "3.000000000",
      "quantity_active": "3.000000000",
      "quantity_assembling": "0.000000000",
      "quantity_available": "3.000000000",
      "status": "active",
      "total_cost_actual": "8",
      "total_cost_default": "8",
      "unit_type": {
        "id": "00000000-0000-0000-0000-00000001320c",
        "name": "Ounce"
      }
    }
  ]
}

Add one or more costs to each of the given packages.

package_ids is a non-empty list of package UUIDs. Packages carry their own location, so this endpoint does not accept location_ids. Unlike batches and products, the cost is applied to the package's full current quantity regardless of its status (active, selling, assembling, etc.).

Each entry in costs accepts the following fields:

When distribute_by_quantity is true, the total of each cost (cost_per_unit × quantity) is split across the selected records in proportion to each record's quantity, instead of applying the full cost to every record. Quantities are converted to a common unit before the split, so all selected records must share the same unit type category. Selecting a single record is a no-op (the whole cost lands on it). When false or omitted, the same cost is applied in full to each selected record.

Common errors (HTTP 400 unless noted):

Required permission: costs_permissions_apply_to_inventory.

Request

POST /public/v1/packages/add-costs

Parameters

Parameter Description In Type Required Default Example
payload The packages and costs to apply body AddPackageCostsRequest true

Responses

Status Description Schema
200 The affected packages Packages
400 Invalid parameters
403 Cost Accounting disabled or missing permission

Add costs to products

POST /public/v1/products/add-costs adds costs to a product, defaulting cost_per_unit to the cost type when omitted

POST /public/v1/products/add-costs
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNmJiMGZjMTMtMWI5Ny00YTMyLThhYTAtOTc5Y2E1ODJjYmQ1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODI1OSIsInR5cCI6ImFjY2VzcyJ9.InQYkJfd7DdPZEUzJjmNi3MW92cx40XOOlJfrNZQrqk

{
  "costs": [
    {
      "cost_type_id": "00000000-0000-0000-0000-00000000004c",
      "quantity": 3
    },
    {
      "cost_per_unit": 5,
      "cost_type_id": "00000000-0000-0000-0000-00000000004c",
      "quantity": 1
    }
  ],
  "product_ids": [
    "6e5dc0f3-8662-4020-95eb-770783872b96"
  ]
}

Response

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

{
  "data": [
    {
      "brand": null,
      "category": {
        "id": "00000000-0000-0000-0000-0000000009f1",
        "name": "Some category 216",
        "official_product_category_id": "OTHER"
      },
      "creator": null,
      "custom_data": [],
      "deleted_at": null,
      "description": null,
      "description_markdown": null,
      "external_name": null,
      "gross_weight": null,
      "gross_weight_unit_type": null,
      "id": "6e5dc0f3-8662-4020-95eb-770783872b96",
      "images": [
        {
          "id": "00000000-0000-0000-0000-000000000028",
          "name": "Image Name 107",
          "rank": 0,
          "url": "https://google.com/original-5.jpg"
        }
      ],
      "inserted_datetime": "2026-08-19T13:19:31.326462Z",
      "inventory_tracking_method": "PRODUCT",
      "is_active": true,
      "is_featured": false,
      "leaflink_product_id": null,
      "menu_visibility": "DO_NOT_INCLUDE",
      "menus": [
        {
          "menu_id": "00000000-0000-0000-0000-0000000000b0",
          "menu_name": "Menu 1"
        }
      ],
      "msrp": null,
      "name": "Product 527",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-1360@example.com",
        "full_name": "FirstName2784 LastName2785",
        "id": "00000000-0000-0000-0000-000000002047",
        "inserted_datetime": "2026-08-19T13:19:31.318700Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000002114",
          "name": "Admin 1427"
        }
      },
      "product_group": {
        "id": "00000000-0000-0000-0000-0000000009bd",
        "name": "Product Group 204"
      },
      "quantity_available_threshold_max": null,
      "quantity_available_threshold_min": null,
      "sku": "sku 528",
      "strain": null,
      "subcategory": {
        "id": "00000000-0000-0000-0000-0000000009c6",
        "name": "Some subcategory 207"
      },
      "tags": [
        {
          "id": "00000000-0000-0000-0000-000000000040",
          "name": "Tag 1"
        }
      ],
      "total_cannabinoid_unit": null,
      "total_cbd": null,
      "total_thc": null,
      "treez_wholesale_price": null,
      "unit_cost": null,
      "unit_net_weight": null,
      "unit_net_weight_serving_size_unit_type": null,
      "unit_price": "1",
      "unit_serving_size": null,
      "unit_type": {
        "id": "00000000-0000-0000-0000-0000000135a9",
        "name": "Gram"
      },
      "units_per_case": null,
      "upc": null,
      "updated_datetime": "2026-08-19T13:19:31.326462Z",
      "vendor": {
        "id": "00000000-0000-0000-0000-000000000ebc",
        "name": "Company 1033",
        "updated_datetime": "2026-08-19T13:19:31.323809Z"
      },
      "wholesale_unit_price": null
    }
  ]
}

Add one or more costs to each of the given product-tracked products.

product_ids is a non-empty list of product UUIDs. Every product must be product-tracked. The cost is applied to each product's active quantity. location_ids optionally scopes the product stock the cost applies to; omit it to apply across all locations.

Each entry in costs accepts the following fields:

When distribute_by_quantity is true, the total of each cost (cost_per_unit × quantity) is split across the selected records in proportion to each record's quantity, instead of applying the full cost to every record. Quantities are converted to a common unit before the split, so all selected records must share the same unit type category. Selecting a single record is a no-op (the whole cost lands on it). When false or omitted, the same cost is applied in full to each selected record.

Common errors (HTTP 400 unless noted):

Required permission: costs_permissions_apply_to_inventory.

Request

POST /public/v1/products/add-costs

Parameters

Parameter Description In Type Required Default Example
payload The products and costs to apply body AddProductCostsRequest true

Responses

Status Description Schema
200 The affected products Products
400 Invalid parameters
403 Cost Accounting disabled or missing permission

CostType

Delete a cost type

DELETE /public/v1/cost-types/:id soft-deletes a cost type

DELETE /public/v1/cost-types/00000000-0000-0000-0000-000000000037
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjUsImlhdCI6MTc4NzE0NTU2NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzZjMzk0YWQtOWUyYy00NjQ3LWJlNjItOTI1ZDFiMDllOGE2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NjkwNyIsInR5cCI6ImFjY2VzcyJ9.JiFUjMjyGvopvcOp9uCnuQ2AdKf-MgVKe_aK_aXUoKQ

Response

204
cache-control: max-age=0, private, must-revalidate
b3: e35bdcebca80a13c563f1153045bfd34-c1982d4c087cae14-0

Deletes the cost type. This is a soft delete: the record's deleted_at is set and it is no longer returned by the API, but it is retained in the database.

Required permission: costs_permissions_manage_cost_types.

Request

DELETE /public/v1/cost-types/{id}

Parameters

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

Responses

Status Description Schema
204 No Content
404 Not Found

Get a cost type

GET /public/v1/cost-types/:id returns a single cost type with a string cost_per_unit and embedded unit_type

GET /public/v1/cost-types/00000000-0000-0000-0000-00000000003e
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzUzNjM1YTUtNDEyNC00NGEwLWI4NjQtMGJhYmFkODI2MTBkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk1NSIsInR5cCI6ImFjY2VzcyJ9.6hn8lvng4rw-JTNwlARJ_x0zS_7sWRpob1TVub51FMw

Response

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

{
  "data": {
    "active": true,
    "allow_inline_edits": true,
    "cost_per_unit": "25.5",
    "deleted_at": null,
    "description": null,
    "id": "00000000-0000-0000-0000-00000000003e",
    "inserted_datetime": "2026-08-19T13:19:26.267815Z",
    "name": "Freight",
    "unit_type": {
      "id": "00000000-0000-0000-0000-0000000106b7",
      "name": "Unit Type 8"
    },
    "updated_datetime": "2026-08-19T13:19:26.267815Z"
  }
}

Get a single cost type given the ID.

Required permission: costs_permissions_manage_cost_types.

Request

GET /public/v1/cost-types/{id}

Parameters

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

Responses

Status Description Schema
200 A single cost type CostTypeResponse
404 Not Found

Get cost types

GET /public/v1/cost-types returns paginated cost types for the company with next_page

GET /public/v1/cost-types
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGM4NmVhODgtOGY3Yy00ZDFjLWFjZGItYzM1YmFiNjdmYmJiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk2NiIsInR5cCI6ImFjY2VzcyJ9.pkEwu0pXFnbF0vO_E2lUkn2QKBvydT_nFiDJmXo3bHM

Response

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

{
  "data": [
    {
      "active": true,
      "allow_inline_edits": true,
      "cost_per_unit": "1",
      "deleted_at": null,
      "description": null,
      "id": "00000000-0000-0000-0000-00000000003f",
      "inserted_datetime": "2025-01-01T00:00:00.000000Z",
      "name": "CT1",
      "unit_type": {
        "id": "00000000-0000-0000-0000-000000010754",
        "name": "Unit Type 9"
      },
      "updated_datetime": "2026-08-19T13:19:26.319865Z"
    },
    {
      "active": true,
      "allow_inline_edits": true,
      "cost_per_unit": "1",
      "deleted_at": null,
      "description": null,
      "id": "00000000-0000-0000-0000-000000000040",
      "inserted_datetime": "2025-01-02T00:00:00.000000Z",
      "name": "CT2",
      "unit_type": {
        "id": "00000000-0000-0000-0000-000000010755",
        "name": "Unit Type 10"
      },
      "updated_datetime": "2026-08-19T13:19:26.321138Z"
    },
    {
      "active": true,
      "allow_inline_edits": true,
      "cost_per_unit": "1",
      "deleted_at": null,
      "description": null,
      "id": "00000000-0000-0000-0000-000000000041",
      "inserted_datetime": "2025-01-03T00:00:00.000000Z",
      "name": "CT3",
      "unit_type": {
        "id": "00000000-0000-0000-0000-000000010756",
        "name": "Unit Type 11"
      },
      "updated_datetime": "2026-08-19T13:19:26.322496Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/cost-types?page[number]=2"
}

List cost types for the authenticated company. A cost type is a reusable category of cost accounting figure (e.g. freight, labor) with a default per-unit amount and unit of measure, which can then be applied to inventory.

Required permission: costs_permissions_manage_cost_types.

Request

GET /public/v1/cost-types

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of cost types CostTypes

Upsert a cost type

POST /public/v1/cost-types creates a cost type

POST /public/v1/cost-types
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzY1NWNkYzQtYzNmNS00MzZjLWFiM2MtZmUxY2Y3Mjg2OWVjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NjkyNSIsInR5cCI6ImFjY2VzcyJ9.huNh88dNMZJhqH0GtbRM3ySTlJiAV4clbx5lZiAT1d4

{
  "active": true,
  "allow_inline_edits": true,
  "cost_per_unit": "25.5",
  "description": "Inbound shipping",
  "name": "Freight",
  "unit_type_id": "00000000-0000-0000-0000-000000010519"
}

Response

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

{
  "data": {
    "active": true,
    "allow_inline_edits": true,
    "cost_per_unit": "25.5",
    "deleted_at": null,
    "description": "Inbound shipping",
    "id": "00000000-0000-0000-0000-000000000039",
    "inserted_datetime": "2026-08-19T13:19:26.052735Z",
    "name": "Freight",
    "unit_type": {
      "id": "00000000-0000-0000-0000-000000010519",
      "name": "Unit Type 2"
    },
    "updated_datetime": "2026-08-19T13:19:26.052735Z"
  }
}

Upsert a single cost type. To update an existing cost type, pass its ID in the id field. If you do not pass an ID, a new cost type is created. When creating, name, cost_per_unit, unit_type_id and allow_inline_edits are required. The unit type cannot be changed once set.

Required permission: costs_permissions_manage_cost_types.

Request

POST /public/v1/cost-types

Parameters

Parameter Description In Type Required Default Example
active Whether the cost type is active body boolean false
allow_inline_edits When true, the per-unit amount can be overridden each time this cost type is applied to a record; when false, the applied amount is locked to this cost type's cost_per_unit. body boolean true
cost_per_unit The cost per unit as a decimal string body string true
description A description of the cost type body string false
id Cost type ID. If given, the matching cost type is updated; otherwise a new one is created. body string false
name The name of the cost type body string true
unit_type_id The ID of the unit of measure this cost is priced per. Use GET /public/v1/unit-types to find unit type IDs. body string true

Responses

Status Description Schema
200 The updated cost type CostTypeResponse
201 The created cost type CostTypeResponse
400 Invalid parameters
404 Not Found

Credit

Cancel a credit

POST /public/v1/credits/:id/cancel cancels a credit, idempotently, and can delete its credit uses

POST /public/v1/credits/7e37612f-99ae-4de3-9166-baf421f26060/cancel
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjBjZjNjMGMtYjFkYy00MTBkLTgzY2UtMDQ2MzlhYTQ5ZjExIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzYyMiIsInR5cCI6ImFjY2VzcyJ9.NwgXlgtHQApuKwU2zHZTFYxVj9uXeXwvqFNECqA4ozk

Response

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

{
  "data": {
    "amount": "100",
    "canceled_datetime": "2026-08-19T13:19:29.011313Z",
    "company": {
      "id": "00000000-0000-0000-0000-000000000dcb",
      "name": "Company 594",
      "updated_datetime": "2026-08-19T13:19:28.987204Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-727@example.com",
      "full_name": "FirstName1448 LastName1449",
      "id": "00000000-0000-0000-0000-000000001dcc",
      "inserted_datetime": "2026-08-19T13:19:28.990427Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001e90",
        "name": "Admin 783"
      }
    },
    "credit_number": "CRT-00000043",
    "credit_uses": [
      {
        "amount": "40",
        "credit": {
          "amount": "100",
          "credit_number": "CRT-00000043",
          "id": "7e37612f-99ae-4de3-9166-baf421f26060",
          "source": "USER"
        },
        "id": "1bed0e11-440a-4942-9eeb-b62205ebe297",
        "inserted_datetime": "2026-08-19T13:19:28.993177Z",
        "payment": null
      }
    ],
    "deleted_in_qbo": false,
    "external_note": "External note",
    "id": "7e37612f-99ae-4de3-9166-baf421f26060",
    "inserted_datetime": "2026-08-19T13:19:28.991977Z",
    "internal_note": "Internal note",
    "original_amount": "100",
    "owner": null,
    "payment": null,
    "qb_credit_memo_id": null,
    "qb_payment_id": null,
    "qb_sync_status": null,
    "remaining_balance": "60",
    "return": null,
    "source": "USER",
    "status": "CANCELED",
    "updated_datetime": "2026-08-19T13:19:29.011321Z"
  }
}

Cancel (void) a credit. A canceled credit keeps its record and history, but its remaining balance can no longer be applied to invoices.

By default the credit's existing applications to invoices are left in place. Set should_delete_credit_uses to true to also remove those applications, returning the used amounts to the affected invoices.

Overpayment credits (created from an invoice overpayment or a QuickBooks Online payment) cannot be canceled — void the associated payment instead. Canceling an already-canceled credit is a no-op that returns the credit unchanged.

Required permission: credits_permissions_edit.

Request

POST /public/v1/credits/{id}/cancel

Parameters

Parameter Description In Type Required Default Example
cancel Cancel options body CancelCredit false
id Credit ID path string true

Responses

Status Description Schema
200 The canceled credit CreditResponse
400 Bad Request
403 Forbidden
404 Not Found

Create or update a credit

POST /public/v1/credits creates a manually-created credit then updates it

POST /public/v1/credits
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMjgzZTZiNTYtMzA4Yi00YjZlLTkyZDMtOTU1OTY3NDkyYWM4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzYwNyIsInR5cCI6ImFjY2VzcyJ9.lSi4vEY63OOGBaoh0STOyCfqkJJKDNEe2zyEookQlZg

{
  "amount": 80,
  "id": "d77ad251-1b26-4d96-bb60-18686badf9c4",
  "internal_note": "updated"
}

Response

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

{
  "data": {
    "amount": "80",
    "canceled_datetime": null,
    "company": {
      "id": "00000000-0000-0000-0000-000000000dc4",
      "name": "Company 583",
      "updated_datetime": "2026-08-19T13:19:28.873100Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-706@example.com",
      "full_name": "FirstName1406 LastName1407",
      "id": "00000000-0000-0000-0000-000000001db7",
      "inserted_datetime": "2026-08-19T13:19:28.864779Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001e7b",
        "name": "Admin 762"
      }
    },
    "credit_number": "CRT-0000001",
    "credit_uses": [
      {
        "amount": "40",
        "credit": {
          "amount": "80",
          "credit_number": "CRT-0000001",
          "id": "d77ad251-1b26-4d96-bb60-18686badf9c4",
          "source": "USER"
        },
        "id": "91154989-1c24-4316-8a11-51fdcbf67804",
        "inserted_datetime": "2026-08-19T13:19:28.923414Z",
        "payment": {
          "amount": "10",
          "company": {
            "id": "00000000-0000-0000-0000-000000000dc5",
            "name": "Company 586",
            "updated_datetime": "2026-08-19T13:19:28.907250Z"
          },
          "credit_uses": [
            {
              "amount": "40",
              "credit": {
                "amount": "80",
                "credit_number": "CRT-0000001",
                "id": "d77ad251-1b26-4d96-bb60-18686badf9c4",
                "source": "USER"
              },
              "id": "91154989-1c24-4316-8a11-51fdcbf67804"
            }
          ],
          "description": null,
          "fully_paid_with_credits": false,
          "id": "00000000-0000-0000-0000-00000000005c",
          "inserted_datetime": "2026-08-19T13:19:28.920936Z",
          "invoice": {
            "id": "00000000-0000-0000-0000-0000000000d1",
            "invoice_number": "Invoice #22",
            "status": "NOT_PAID",
            "total": "32.00"
          },
          "overpayment_credits": [],
          "payment_date": "2026-08-19T13:19:28.920261Z",
          "payment_method": {
            "active": true,
            "deleted_at": null,
            "id": "00000000-0000-0000-0000-00000000007c",
            "inserted_datetime": "2026-08-19T13:19:28.918989Z",
            "name": "Payment Method 31",
            "qb_payment_method_id": null,
            "type": "CREDIT_CARD",
            "updated_datetime": "2026-08-19T13:19:28.918989Z"
          },
          "payment_number": "Payment #21",
          "payment_type": "INVOICE",
          "purchase": null,
          "quickbooks_deposit_account_id": null,
          "status": "POSTED",
          "updated_datetime": "2026-08-19T13:19:28.920936Z"
        }
      }
    ],
    "deleted_in_qbo": false,
    "external_note": "ext",
    "id": "d77ad251-1b26-4d96-bb60-18686badf9c4",
    "inserted_datetime": "2026-08-19T13:19:28.888254Z",
    "internal_note": "updated",
    "original_amount": "150",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-706@example.com",
      "full_name": "FirstName1406 LastName1407",
      "id": "00000000-0000-0000-0000-000000001db7",
      "inserted_datetime": "2026-08-19T13:19:28.864779Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001e7b",
        "name": "Admin 762"
      }
    },
    "payment": null,
    "qb_credit_memo_id": null,
    "qb_payment_id": null,
    "qb_sync_status": null,
    "remaining_balance": "40",
    "return": null,
    "source": "USER",
    "status": "ACTIVE",
    "updated_datetime": "2026-08-19T13:19:28.939171Z"
  }
}

Create a new credit or update an existing one.

Omit id to create a new credit; include the id of an existing credit to update it. Only the fields you send are changed; omitted fields keep their current value.

Credits created through the API are always manually-created (USER source) credits — the same as a credit you would add by hand in the Distru UI. Only these manually-created credits can be updated through the API. Credits generated automatically (from a return, an invoice overpayment, or QuickBooks Online) cannot be created or modified here.

On update the customer (company_id) cannot be changed. amount must be greater than 0 and, on update, cannot be set below the amount already used by the credit.

Required permission: credits_permissions_create to create, credits_permissions_edit to update.

Request

POST /public/v1/credits

Parameters

Parameter Description In Type Required Default Example
credit Credit data body UpsertCredit true

Responses

Status Description Schema
200 The updated credit CreditResponse
201 The created credit CreditResponse
400 Bad Request
403 Forbidden
404 Not Found

Delete a credit

DELETE /public/v1/credits/:id soft-deletes a credit

DELETE /public/v1/credits/a21cea42-bb95-454d-9f28-7c090af024e6
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYmZlM2NjNTktMTMzOC00NDViLWIwMDktMmJmYTZkOWE2NmMwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzU3MSIsInR5cCI6ImFjY2VzcyJ9.8KGwr9YbZxUUPfQAORZf2nT5ulAt239Z1Xv-zEgpju8

Response

204
cache-control: max-age=0, private, must-revalidate
b3: b5d8652931a029d9b24afec5860f1984-429570ef0fc6c561-0

Soft-delete a credit. The credit is marked as deleted and stops appearing in the API and the Distru UI, but the record is retained rather than being permanently removed.

A credit cannot be deleted once it has been used (applied to an invoice). Overpayment credits (created from an invoice overpayment or a QuickBooks Online payment) cannot be deleted unless they have already been canceled — void the associated payment instead.

Required permission: credits_permissions_delete.

Request

DELETE /public/v1/credits/{id}

Parameters

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

Responses

Status Description Schema
204 No Content
400 Bad Request
403 Forbidden
404 Not Found

Get a credit

GET /public/v1/credits/:id returns a single credit with its active credit uses

GET /public/v1/credits/1078cb5d-099f-4939-9e22-d835ade9a116
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzU2MDIzNzctOWY4NS00YWVkLWI4ODUtZjAzMTAwZDUzYTg2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzQ1NSIsInR5cCI6ImFjY2VzcyJ9.WKw8OCsb45Ndj17UdH0uaSIsMlbNA-XCiiAjnNTHwEE

Response

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

{
  "data": {
    "amount": "100",
    "canceled_datetime": null,
    "company": {
      "id": "00000000-0000-0000-0000-000000000d8e",
      "name": "Company 471",
      "updated_datetime": "2026-08-19T13:19:28.435843Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-578@example.com",
      "full_name": "FirstName1150 LastName1151",
      "id": "00000000-0000-0000-0000-000000001d37",
      "inserted_datetime": "2026-08-19T13:19:28.438600Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001df3",
        "name": "Admin 626"
      }
    },
    "credit_number": "CRT-00000019",
    "credit_uses": [
      {
        "amount": "25",
        "credit": {
          "amount": "100",
          "credit_number": "CRT-00000019",
          "id": "1078cb5d-099f-4939-9e22-d835ade9a116",
          "source": "USER"
        },
        "id": "f34b58b6-4e9f-4de7-bbd8-465c49454a95",
        "inserted_datetime": "2026-08-19T13:19:28.442164Z",
        "payment": {
          "amount": "10",
          "company": {
            "id": "00000000-0000-0000-0000-000000000d87",
            "name": "Company 463",
            "updated_datetime": "2026-08-19T13:19:28.403230Z"
          },
          "credit_uses": [
            {
              "amount": "25",
              "credit": {
                "amount": "100",
                "credit_number": "CRT-00000019",
                "id": "1078cb5d-099f-4939-9e22-d835ade9a116",
                "source": "USER"
              },
              "id": "f34b58b6-4e9f-4de7-bbd8-465c49454a95"
            }
          ],
          "description": null,
          "fully_paid_with_credits": false,
          "id": "00000000-0000-0000-0000-000000000057",
          "inserted_datetime": "2026-08-19T13:19:28.416365Z",
          "invoice": {
            "id": "00000000-0000-0000-0000-0000000000cc",
            "invoice_number": "Invoice #17",
            "status": "NOT_PAID",
            "total": "32.00"
          },
          "overpayment_credits": [],
          "payment_date": "2026-08-19T13:19:28.415631Z",
          "payment_method": {
            "active": true,
            "deleted_at": null,
            "id": "00000000-0000-0000-0000-000000000077",
            "inserted_datetime": "2026-08-19T13:19:28.415233Z",
            "name": "Payment Method 26",
            "qb_payment_method_id": null,
            "type": "CREDIT_CARD",
            "updated_datetime": "2026-08-19T13:19:28.415233Z"
          },
          "payment_number": "Payment #16",
          "payment_type": "INVOICE",
          "purchase": null,
          "quickbooks_deposit_account_id": null,
          "status": "POSTED",
          "updated_datetime": "2026-08-19T13:19:28.416365Z"
        }
      }
    ],
    "deleted_in_qbo": false,
    "external_note": "External note",
    "id": "1078cb5d-099f-4939-9e22-d835ade9a116",
    "inserted_datetime": "2026-08-19T13:19:28.440310Z",
    "internal_note": "Internal note",
    "original_amount": "150",
    "owner": null,
    "payment": null,
    "qb_credit_memo_id": null,
    "qb_payment_id": null,
    "qb_sync_status": null,
    "remaining_balance": "75",
    "return": null,
    "source": "USER",
    "status": "ACTIVE",
    "updated_datetime": "2026-08-19T13:19:28.441400Z"
  }
}

Get a single credit given the ID.

Required permission: credits_permissions_view.

Request

GET /public/v1/credits/{id}

Parameters

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

Responses

Status Description Schema
200 A single credit CreditResponse
404 Not Found

Get credits

GET /public/v1/credits returns credits for the company with status and remaining balance

GET /public/v1/credits
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMWRmYmE4ZTgtZGY2MC00YjgyLTkyNGQtYWFjNzQzOTk0OTI5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzc5MSIsInR5cCI6ImFjY2VzcyJ9.fdPYldrrj_yfb1hXiScN9awtXTRpnwrkQh9-BKDHBt4

Response

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

{
  "data": [
    {
      "amount": "100",
      "canceled_datetime": null,
      "company": {
        "id": "00000000-0000-0000-0000-000000000e1f",
        "name": "Company 711",
        "updated_datetime": "2026-08-19T13:19:29.572785Z"
      },
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-894@example.com",
        "full_name": "FirstName1786 LastName1787",
        "id": "00000000-0000-0000-0000-000000001e74",
        "inserted_datetime": "2026-08-19T13:19:29.582357Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000001f3b",
          "name": "Admin 954"
        }
      },
      "credit_number": "CRT-A",
      "credit_uses": [
        {
          "amount": "40",
          "credit": {
            "amount": "100",
            "credit_number": "CRT-A",
            "id": "915e21e7-4d26-4de2-82bc-3fcd3bc4dc7b",
            "source": "USER"
          },
          "id": "d96ed31b-cdde-4e41-8d25-20b19aaddaea",
          "inserted_datetime": "2026-08-19T13:19:29.585104Z",
          "payment": null
        }
      ],
      "deleted_in_qbo": false,
      "external_note": "ext",
      "id": "915e21e7-4d26-4de2-82bc-3fcd3bc4dc7b",
      "inserted_datetime": "2026-08-19T13:19:29.583528Z",
      "internal_note": "int",
      "original_amount": "150",
      "owner": null,
      "payment": null,
      "qb_credit_memo_id": null,
      "qb_payment_id": null,
      "qb_sync_status": null,
      "remaining_balance": "60",
      "return": null,
      "source": "USER",
      "status": "ACTIVE",
      "updated_datetime": "2026-08-19T13:19:29.584295Z"
    }
  ],
  "next_page": null
}

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

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

Required permission: credits_permissions_view.

Request

GET /public/v1/credits

Parameters

Parameter Description In Type Required Default Example
credit_number Filter credits whose credit number contains this value query string false
inserted_datetime Filter credits by their creation datetime query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1
source Filter credits by how they were created query string false
status Filter credits by their status query string false
updated_datetime Filter credits by the datetime they were most recently modified query string false ,2022-07-10T00:00:00Z

Responses

Status Description Schema
200 A list of credits Credits

CustomField

Create a custom field

POST /public/v1/custom-fields can create a custom field of type dropdown

POST /public/v1/custom-fields
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMmJiMGNmYTktNjg2ZS00MmQzLTk3MjktZjJjMDJkOTcyMzZiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzAzNiIsInR5cCI6ImFjY2VzcyJ9.pVo4QCuO8RjlUcdgyYDnHJY_1gTDNUpOEl-XedTFjRc

{
  "field_options": [
    "A",
    "B"
  ],
  "field_type": "dropdown",
  "filterable": true,
  "name": "Dropdown Field",
  "parent_object": "product"
}

Response

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

{
  "data": {
    "description": null,
    "disabled_field_options": [],
    "field_options": [
      "A",
      "B"
    ],
    "field_type": "dropdown",
    "filterable": true,
    "id": 165,
    "name": "Dropdown Field",
    "parent_object": "product",
    "required": false
  }
}

Create a custom field for the specified parent object. Updates are not supported for this endpoint.

Required permission: settings_permissions_custom_fields.

Request

POST /public/v1/custom-fields

Parameters

Parameter Description In Type Required Default Example
description Description of the custom field body string false
field_options The selectable values, for dropdown and checkbox fields body array false
field_type The kind of value this field stores, e.g. text, date, dropdown, checkbox body string true
filterable Whether records can be filtered by this field's value body boolean false
name Name of the custom field body string true
parent_object The entity type to attach this field to, e.g. order, invoice, product, company, contact, package, batch body string true
required Whether a value for the field is required when saving a record body boolean false

Responses

Status Description Schema
201 Custom field created CustomFieldDefinitionResponse
400 Invalid parameters

Get a custom field definition

GET /public/v1/custom-fields/:id returns a single custom field

GET /public/v1/custom-fields/161
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZTA4MWQ0M2EtNTk1Yy00ZTU4LWFlMzUtYjgxNzE2ODdiNTI4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk3MyIsInR5cCI6ImFjY2VzcyJ9.8l-QIBNibYjvLwYcNJFNXn27KT3ytBYa3vkc_eh0l4Q

Response

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

{
  "data": {
    "description": "A test field",
    "disabled_field_options": [
      "B"
    ],
    "field_options": [
      "A",
      "B",
      "C"
    ],
    "field_type": "dropdown",
    "filterable": true,
    "id": 161,
    "name": "Test Field",
    "parent_object": "product",
    "required": false
  }
}

Get a single custom field definition given the ID.

Required permission: settings_permissions_custom_fields.

Request

GET /public/v1/custom-fields/{id}

Parameters

Parameter Description In Type Required Default Example
id Custom field ID path integer true

Responses

Status Description Schema
200 A single custom field definition CustomFieldDefinitionResponse
404 Not Found

List custom field definitions

GET /public/v1/custom-fields returns custom fields for the company

GET /public/v1/custom-fields
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTU0YzljM2UtNjZkZC00NDM2LTg5ZTctODY0OTA4N2NhNzk0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzE3MiIsInR5cCI6ImFjY2VzcyJ9.tLddJ-gUInC8zpniTRXP3LO2PIUK1Xs_KSfMT86BpXs

Response

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

{
  "data": [
    {
      "description": null,
      "disabled_field_options": [],
      "field_options": [],
      "field_type": "text",
      "filterable": false,
      "id": 192,
      "name": "Field 1",
      "parent_object": "product",
      "required": false
    },
    {
      "description": null,
      "disabled_field_options": [
        "A"
      ],
      "field_options": [
        "A",
        "B"
      ],
      "field_type": "dropdown",
      "filterable": true,
      "id": 193,
      "name": "Field 2",
      "parent_object": "product",
      "required": false
    }
  ]
}

List all custom field definitions for the authenticated company. Optionally filter by parent_object to get fields for a specific entity type.

Required permission: settings_permissions_custom_fields.

Request

GET /public/v1/custom-fields

Parameters

Parameter Description In Type Required Default Example
parent_object Filter by parent object type (e.g., order, invoice, product) query string false

Responses

Status Description Schema
200 List of custom field definitions CustomFieldDefinitions

Update a custom field

POST /public/v1/custom-fields/:id can update a custom field name

POST /public/v1/custom-fields/160
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWU1NmQ2MDEtYzlhZC00MDliLTgwZDctNTdlZTk0MTA0YWRlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk2NSIsInR5cCI6ImFjY2VzcyJ9.qHm36EmKVQp-xcjeWDTxBKLMhbjh9oyAoXSgb8_NcVo

{
  "name": "Updated Name"
}

Response

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

{
  "data": {
    "description": null,
    "disabled_field_options": [
      "Medium"
    ],
    "field_options": [
      "Large",
      "Medium",
      "Small"
    ],
    "field_type": "dropdown",
    "filterable": false,
    "id": 160,
    "name": "Updated Name",
    "parent_object": "product",
    "required": false
  }
}

Update an existing custom field. Only name, description, required, and field_options can be updated. Field type and parent object cannot be changed after creation.

Required permission: settings_permissions_custom_fields.

Request

POST /public/v1/custom-fields/{id}

Parameters

Parameter Description In Type Required Default Example
description Description of the custom field body string false
field_options Field options (replaces existing options) body array false
id Custom field ID path integer true
name Name of the custom field body string false
required Whether a value for the field is required when saving a record body boolean false

Responses

Status Description Schema
200 Custom field updated CustomFieldDefinitionResponse
400 Invalid parameters
404 Not Found

Driver

Delete a driver

DELETE /public/v1/drivers/:id soft-deletes a driver

DELETE /public/v1/drivers/00000000-0000-0000-0000-00000000002d
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjAyNDAyNTEtNmY1NS00NTk1LTgwMzktYTdmNGE4NWQ2NDlmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODMwOSIsInR5cCI6ImFjY2VzcyJ9.Bl2SNbTQhZqC-E2XkLvzBNddEjnfznD3sX8mScvwknU

Response

204
cache-control: max-age=0, private, must-revalidate
b3: 72940dee818d0cfe643c585ec2e72e0b-65e7b6548c56c49b-0

Deletes the driver. This is a soft delete: the record's deleted_at is set and it is no longer returned by the API, but it is retained in the database.

Required permission: settings_permissions_drivers.

Request

DELETE /public/v1/drivers/{id}

Parameters

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

Responses

Status Description Schema
204 No Content
404 Not Found

Get a driver

GET /public/v1/drivers/:id returns a single driver

GET /public/v1/drivers/00000000-0000-0000-0000-000000000025
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZmFlYzU5MjUtZWYzMy00NWVlLWIzMDMtMjViM2Y2MTM0NjAzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODI2NSIsInR5cCI6ImFjY2VzcyJ9.q03eWknn-T5soWwUaqZtfD3fQV9yIHwNR0yu-zuxXe4

Response

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

{
  "data": {
    "birth_date": "1990-01-01",
    "driver_license": "D1234567",
    "email": "test@example.com",
    "first_name": "Sam",
    "hire_date": "2020-01-01",
    "id": "00000000-0000-0000-0000-000000000025",
    "inserted_datetime": "2026-08-19T13:19:31.325920Z",
    "last_name": "Rivera",
    "occupational_license_number": null,
    "phone_number": null,
    "updated_datetime": "2026-08-19T13:19:31.325920Z",
    "us_state": "CA"
  }
}

Get a single driver given the ID.

Required permission: settings_permissions_drivers.

Request

GET /public/v1/drivers/{id}

Parameters

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

Responses

Status Description Schema
200 A single driver DriverResponse
404 Not Found

Get drivers

GET /public/v1/drivers returns paginated drivers for the company with next_page

GET /public/v1/drivers
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZmI5MDFlODItZTk0Yi00MWYwLWI2ZTktMTgxMzRkOWNhN2NhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODI4MiIsInR5cCI6ImFjY2VzcyJ9.JG66IKj9MamU8aSPwiVaTBcou-3RazZcV2khOIa8awA

Response

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

{
  "data": [
    {
      "birth_date": "1990-01-01",
      "driver_license": "D1234567",
      "email": "d1@example.com",
      "first_name": "Test",
      "hire_date": "2020-01-01",
      "id": "00000000-0000-0000-0000-000000000027",
      "inserted_datetime": "2025-01-01T00:00:00.000000Z",
      "last_name": "Driver",
      "occupational_license_number": null,
      "phone_number": null,
      "updated_datetime": "2026-08-19T13:19:31.373240Z",
      "us_state": "CA"
    },
    {
      "birth_date": "1990-01-01",
      "driver_license": "D1234567",
      "email": "d2@example.com",
      "first_name": "Test",
      "hire_date": "2020-01-01",
      "id": "00000000-0000-0000-0000-000000000028",
      "inserted_datetime": "2025-01-02T00:00:00.000000Z",
      "last_name": "Driver",
      "occupational_license_number": null,
      "phone_number": null,
      "updated_datetime": "2026-08-19T13:19:31.377556Z",
      "us_state": "CA"
    },
    {
      "birth_date": "1990-01-01",
      "driver_license": "D1234567",
      "email": "d3@example.com",
      "first_name": "Test",
      "hire_date": "2020-01-01",
      "id": "00000000-0000-0000-0000-000000000029",
      "inserted_datetime": "2025-01-03T00:00:00.000000Z",
      "last_name": "Driver",
      "occupational_license_number": null,
      "phone_number": null,
      "updated_datetime": "2026-08-19T13:19:31.381173Z",
      "us_state": "CA"
    }
  ],
  "next_page": "https://www.example.com/public/v1/drivers?page[number]=2"
}

List drivers for the authenticated company.

Required permission: settings_permissions_drivers.

Request

GET /public/v1/drivers

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of drivers Drivers

Upsert a driver

POST /public/v1/drivers creates a driver for a METRC company

POST /public/v1/drivers
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzlhMzQwZDAtNTc0My00NDk3LWFhYzQtNTFhYzgyZmM2MWNiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODIxNCIsInR5cCI6ImFjY2VzcyJ9.Qu3BpeZyoTWVsoKybpx8UvjIiYi2he0mmC9np5WbiFk

{
  "driver_license": "D1234567",
  "first_name": "Sam",
  "last_name": "Rivera",
  "occupational_license_number": "OCC-889",
  "phone_number": "555-0100"
}

Response

201
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 7d177524afb606c9a87435ca605b9e1e-8188624a21c9cbca-0

{
  "data": {
    "birth_date": null,
    "driver_license": "D1234567",
    "email": null,
    "first_name": "Sam",
    "hire_date": null,
    "id": "00000000-0000-0000-0000-000000000021",
    "inserted_datetime": "2026-08-19T13:19:31.147445Z",
    "last_name": "Rivera",
    "occupational_license_number": "OCC-889",
    "phone_number": "555-0100",
    "updated_datetime": "2026-08-19T13:19:31.147445Z",
    "us_state": null
  }
}

Upsert a single driver. To update an existing driver, pass its ID in the id field. If you do not pass an ID, a new driver is created.

Driver management is only available for companies with a METRC or BIOTRACK compliance type. Requests from companies with any other compliance type are rejected.

Required fields depend on the company's compliance type and apply only when CREATING a driver. On update (when an id is given) all fields are optional and only the fields you send are changed; omitted fields keep their stored value. - METRC: first_name, last_name, phone_number, driver_license, occupational_license_number. - BIOTRACK: first_name, last_name, birth_date, email, driver_license, us_state, hire_date.

Required permission: settings_permissions_drivers.

Request

POST /public/v1/drivers

Parameters

Parameter Description In Type Required Default Example
birth_date The driver's birth date, ISO-8601 (required when creating a driver for BIOTRACK companies) body string false
driver_license The driver's license number (required when creating a driver) body string false
email The driver's email (required when creating a driver for BIOTRACK companies) body string false
first_name The driver's first name (required when creating a driver) body string false
hire_date The driver's hire date, ISO-8601 (required when creating a driver for BIOTRACK companies) body string false
id Driver ID. If given, the matching driver is updated; otherwise a new one is created. body string false
last_name The driver's last name (required when creating a driver) body string false
occupational_license_number The driver's occupational license number (required when creating a driver for METRC companies) body string false
phone_number The driver's phone number (required when creating a driver for METRC companies) body string false
us_state The driver's US state (required when creating a driver for BIOTRACK companies) body string false

Responses

Status Description Schema
200 The updated driver DriverResponse
201 The created driver DriverResponse
400 Invalid parameters
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjkxMGU2OWItNzNhZS00ZmRmLThlYTgtNWIxYThkOWYwZDNiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzcyMiIsInR5cCI6ImFjY2VzcyJ9.wPzhXJSf3syo76B3WZL1cK-2JQD0D9Nv8uBpPyKen-o

{
  "file": {
    "filename": "test-image.png",
    "content_type": "image/png"
  },
  "name": "My Test Image",
  "product_id": "6d049130-2991-4425-9e9e-b82314eb80fe"
}

Response

201
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 5a9893a8c32b03d65e8fa85b640be05e-9b2a9eb1527fd8dd-0

{
  "data": {
    "assembly_id": null,
    "batch_id": null,
    "company_relationship_id": null,
    "contact_id": null,
    "id": "00000000-0000-0000-0000-000000000051",
    "invoice_id": null,
    "license_id": null,
    "mime_type": "image/png",
    "name": "My Test Image",
    "order_id": null,
    "order_shipment_id": null,
    "product_id": "6d049130-2991-4425-9e9e-b82314eb80fe",
    "purchase_id": null,
    "request_id": null,
    "return_id": null,
    "size_in_bytes": 355974,
    "stock_transfer_id": null,
    "task_id": null,
    "upload_datetime": "2026-08-19T13:19:29.360322Z",
    "uploader": {
      "id": "00000000-0000-0000-0000-000000001e2a",
      "name": "FirstName1638 LastName1639"
    },
    "url": "/var/folders/2z/jg98hkm57rx18c_x3bnqbr8c0000gn/T/b48fb6ae-85d8-42d5-b4b7-c5293fc9f8a5/test-image.png"
  }
}

Upload a new file attachment and associate it with a single record. Exactly one reference ID must be provided (e.g. product_id, order_id, purchase_id) to indicate which record the file is attached to. Send the request as multipart/form-data.

Required permission: products_permissions_edit.

Request

POST /public/v1/file-attachments

Parameters

Parameter Description In Type Required Default Example
assembly_id Assembly 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
company_relationship_id Company relationship 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
file The file to upload formData file true
invoice_id Invoice 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
name Display name for the attachment (defaults to filename if not provided) formData string false
order_id Order 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
product_id Product 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
request_id Request 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
stock_transfer_id Stock transfer 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

Responses

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

Inventory

Get inventory levels

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

GET /public/v1/inventory?grouping[]=PRODUCT&product_ids[]=c1a68ef5-0e3a-476e-9c08-987a11db85b9
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzYsImlhdCI6MTc4NzE0NTU3NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMjZjMTUwODYtZmUwMi00NTU5LTg4ZjEtZGEwMmUwMjIwZTZlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTYyMyIsInR5cCI6ImFjY2VzcyJ9.LGlkNmWq35ZiNNiGgHmHxpMcrq8UZQmSW3xJiKl3ZtQ

Response

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

{
  "data": [
    {
      "active": "10.000000000",
      "available": "10.000000000",
      "cost_default_per_unit": null,
      "cost_per_unit_actual": null,
      "product_id": "c1a68ef5-0e3a-476e-9c08-987a11db85b9",
      "reserved": "0.000000000",
      "total_cost_actual": null,
      "total_cost_default": null,
      "updated_datetime": "2026-08-19T13:19:36.697801Z"
    }
  ],
  "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.

Required permission: products_permissions_view.

Request

GET /public/v1/inventory

Parameters

Parameter Description In Type Required Default Example
batch_ids Filter inventory levels by batch IDs query array false ["00000000-0000-0000-0000-000000000101","00000000-0000-0000-0000-000000000102"]
grouping Attributes to group inventory by. PRODUCT is required to be in the list. Accepted values are "BATCH_NUMBER", "LOCATION" and "PRODUCT". query array true ["PRODUCT","LOCATION"]
location_ids Filter inventory levels by location IDs query array false ["00000000-0000-0000-0000-000000000001","00000000-0000-0000-0000-000000000002"]
page Pagination information query number false ?page[number]=1
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 an invoice

GET /invoices/:id renders charges and payments

GET /public/v1/invoices/00000000-0000-0000-0000-0000000000eb
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzUsImlhdCI6MTc4NzE0NTU3NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjUwMzUzODktZTk3MC00NzllLTkyOGYtMDE4YzA2ODUzM2M5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTI3NSIsInR5cCI6ImFjY2VzcyJ9.eR4_abMQ0ieZ67yCgUf6P-5ogUQnMHEqqBZzDwOnvyQ

Response

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

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001adc",
      "id": "00000000-0000-0000-0000-000000000851",
      "license_id": "00000000-0000-0000-0000-000000000219",
      "license_number": "CDPH-00000097",
      "name": "Place 461"
    },
    "charges": [
      {
        "id": "0877d4de-9d01-4e9f-bf78-5b637d89cec6",
        "inserted_datetime": "2026-08-19T13:19:35.229218Z",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "tax": {
          "id": "00000000-0000-0000-0000-00000000002e",
          "name": "T1"
        },
        "type": "CHARGE",
        "unit_type": "PERCENT"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-00000000107f",
      "name": "Company 1666",
      "updated_datetime": "2026-08-19T13:19:35.075070Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-2362@example.com",
      "full_name": "FirstName4796 LastName4797",
      "id": "00000000-0000-0000-0000-00000000243c",
      "inserted_datetime": "2026-08-19T13:19:35.037509Z",
      "role": {
        "id": "00000000-0000-0000-0000-00000000251c",
        "name": "Admin 2459"
      }
    },
    "custom_data": [],
    "due_datetime": "2026-08-19T13:19:35.142738Z",
    "external_notes": null,
    "id": "00000000-0000-0000-0000-0000000000eb",
    "inserted_datetime": "2026-08-19T13:19:35.143235Z",
    "internal_notes": null,
    "invoice_datetime": "2026-08-19T13:19:35.142737Z",
    "invoice_number": "Invoice #44",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000a9c",
          "name": "B1686"
        },
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "description": null,
        "id": "00000000-0000-0000-0000-0000000000c8",
        "inserted_datetime": "2026-08-19T13:19:35.145431Z",
        "order_item": {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000a9c",
            "name": "B1686"
          },
          "compliance_quantity": null,
          "cost_per_unit": null,
          "cost_per_unit_default": null,
          "id": "0c2257de-e392-41a9-8955-6ba0840185dc",
          "inserted_datetime": "2026-08-19T13:19:35.088342Z",
          "is_sample": false,
          "leaflink_id": null,
          "location": null,
          "note": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "040d3c68-3ad2-4951-8a93-e9da9f7ee01d",
            "name": "Product 1684",
            "sku": "sku 1685",
            "updated_datetime": "2026-08-19T13:19:35.085862Z"
          },
          "quantity": "15.000000000",
          "returned_quantity": "0",
          "thc_percentage_total": null,
          "total_cost_actual": null,
          "total_cost_default": null
        },
        "order_item_id": "0c2257de-e392-41a9-8955-6ba0840185dc",
        "package": null,
        "price": "10.000000000",
        "product": {
          "id": "040d3c68-3ad2-4951-8a93-e9da9f7ee01d",
          "name": "Product 1684",
          "sku": "sku 1685",
          "updated_datetime": "2026-08-19T13:19:35.085862Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000a9d",
          "name": "B1690"
        },
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "description": null,
        "id": "00000000-0000-0000-0000-0000000000c9",
        "inserted_datetime": "2026-08-19T13:19:35.147238Z",
        "order_item": {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000a9d",
            "name": "B1690"
          },
          "compliance_quantity": null,
          "cost_per_unit": null,
          "cost_per_unit_default": null,
          "id": "afdc50ed-20a2-4d05-95e7-0a0dd5cd2438",
          "inserted_datetime": "2026-08-19T13:19:35.099882Z",
          "is_sample": false,
          "leaflink_id": null,
          "location": null,
          "note": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "40a60e26-6fc8-40b0-a399-29aaa0fb5fcd",
            "name": "Product 1688",
            "sku": "sku 1689",
            "updated_datetime": "2026-08-19T13:19:35.097716Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "thc_percentage_total": null,
          "total_cost_actual": null,
          "total_cost_default": null
        },
        "order_item_id": "afdc50ed-20a2-4d05-95e7-0a0dd5cd2438",
        "package": null,
        "price": "10.000000000",
        "product": {
          "id": "40a60e26-6fc8-40b0-a399-29aaa0fb5fcd",
          "name": "Product 1688",
          "sku": "sku 1689",
          "updated_datetime": "2026-08-19T13:19:35.097716Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "order": {
      "id": "574a7db9-dda1-4353-93eb-15d98df22a47",
      "order_number": "SO-89",
      "status": "PENDING",
      "total": "320.00"
    },
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-2362@example.com",
      "full_name": "FirstName4796 LastName4797",
      "id": "00000000-0000-0000-0000-00000000243c",
      "inserted_datetime": "2026-08-19T13:19:35.037509Z",
      "role": {
        "id": "00000000-0000-0000-0000-00000000251c",
        "name": "Admin 2459"
      }
    },
    "paid_amount": "5.00",
    "payment_term_name": null,
    "payments": [
      {
        "amount": "5",
        "company": {
          "id": "00000000-0000-0000-0000-00000000107f",
          "name": "Company 1666",
          "updated_datetime": "2026-08-19T13:19:35.075070Z"
        },
        "credit_uses": [],
        "description": null,
        "fully_paid_with_credits": false,
        "id": "00000000-0000-0000-0000-00000000005e",
        "inserted_datetime": "2026-08-19T13:19:35.171587Z",
        "invoice": {
          "id": "00000000-0000-0000-0000-0000000000eb",
          "invoice_number": "Invoice #44",
          "status": "PARTIALLY_PAID",
          "total": "200.00"
        },
        "overpayment_credits": [],
        "payment_date": "2026-08-19T13:19:35.154336Z",
        "payment_method": {
          "active": true,
          "deleted_at": null,
          "id": "00000000-0000-0000-0000-00000000007e",
          "inserted_datetime": "2026-08-19T13:19:35.153543Z",
          "name": "Payment Method 33",
          "qb_payment_method_id": null,
          "type": "CREDIT_CARD",
          "updated_datetime": "2026-08-19T13:19:35.153543Z"
        },
        "payment_number": "PYT-0000001",
        "payment_type": "INVOICE",
        "purchase": null,
        "quickbooks_deposit_account_id": null,
        "status": "POSTED",
        "updated_datetime": "2026-08-19T13:19:35.171587Z"
      }
    ],
    "remaining_amount": null,
    "status": "PARTIALLY_PAID",
    "total": "200.00",
    "updated_datetime": "2026-08-19T13:19:35.174268Z",
    "voided_datetime": null
  }
}

Get a single invoice given the ID. Required permission: invoices_permissions_view. The authenticated user must also have access to the requested invoice under their team restrictions.

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 InvoiceResponse

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzksImlhdCI6MTc4NzE0NTU3OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzllY2E5OTQtMjI4Yi00YzJkLWIyNGUtMTI3NjExMDIyZTFjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTAwMDciLCJ0eXAiOiJhY2Nlc3MifQ.KCevaiqOWP_ueLZcEH860kSNwsYg82NQxAikDdBHSvo

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 5716b45545a8fd604957b75248585b39-850faeb1ec98a0c7-0

{
  "data": [
    {
      "billing_location": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-000000001d4f",
        "id": "00000000-0000-0000-0000-000000000963",
        "license_id": "00000000-0000-0000-0000-000000000278",
        "license_number": "CDPH-00000192",
        "name": "Place 734"
      },
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-00000000126f",
        "name": "Company 2293",
        "updated_datetime": "2026-08-19T13:19:39.551209Z"
      },
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-3096@example.com",
        "full_name": "FirstName6264 LastName6265",
        "id": "00000000-0000-0000-0000-000000002729",
        "inserted_datetime": "2026-08-19T13:19:39.530828Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000027fc",
          "name": "Admin 3195"
        }
      },
      "custom_data": [
        {
          "id": 227,
          "name": "Custom Field 48",
          "value": null
        }
      ],
      "due_datetime": "2026-08-19T13:19:39.611948Z",
      "external_notes": null,
      "id": "00000000-0000-0000-0000-000000000115",
      "inserted_datetime": "2026-08-19T13:19:39.612441Z",
      "internal_notes": null,
      "invoice_datetime": "2026-08-19T13:19:39.611948Z",
      "invoice_number": "Invoice #81",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000c04",
            "name": "B2771"
          },
          "cost_per_unit": null,
          "cost_per_unit_default": null,
          "description": null,
          "id": "00000000-0000-0000-0000-0000000000fc",
          "inserted_datetime": "2026-08-19T13:19:39.613419Z",
          "order_item": {
            "batch": {
              "batch_number": null,
              "id": "00000000-0000-0000-0000-000000000c04",
              "name": "B2771"
            },
            "compliance_quantity": null,
            "cost_per_unit": null,
            "cost_per_unit_default": null,
            "id": "fef0099e-b9f1-44ff-826f-5cceb79745ea",
            "inserted_datetime": "2026-08-19T13:19:39.562482Z",
            "is_sample": false,
            "leaflink_id": null,
            "location": null,
            "note": null,
            "package": null,
            "price": "10.000000000",
            "price_base": "10",
            "product": {
              "id": "5c897b89-8ab3-442a-8212-1108fa6d891a",
              "name": "Product 2769",
              "sku": "sku 2770",
              "updated_datetime": "2026-08-19T13:19:39.560470Z"
            },
            "quantity": "15.000000000",
            "returned_quantity": "0",
            "thc_percentage_total": null,
            "total_cost_actual": null,
            "total_cost_default": null
          },
          "order_item_id": "fef0099e-b9f1-44ff-826f-5cceb79745ea",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "5c897b89-8ab3-442a-8212-1108fa6d891a",
            "name": "Product 2769",
            "sku": "sku 2770",
            "updated_datetime": "2026-08-19T13:19:39.560470Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000c05",
            "name": "B2774"
          },
          "cost_per_unit": null,
          "cost_per_unit_default": null,
          "description": null,
          "id": "00000000-0000-0000-0000-0000000000fd",
          "inserted_datetime": "2026-08-19T13:19:39.614639Z",
          "order_item": {
            "batch": {
              "batch_number": null,
              "id": "00000000-0000-0000-0000-000000000c05",
              "name": "B2774"
            },
            "compliance_quantity": null,
            "cost_per_unit": null,
            "cost_per_unit_default": null,
            "id": "5ba71026-c0c4-43de-b83d-f675b169ff1a",
            "inserted_datetime": "2026-08-19T13:19:39.572243Z",
            "is_sample": false,
            "leaflink_id": null,
            "location": null,
            "note": null,
            "package": null,
            "price": "10.000000000",
            "price_base": "10",
            "product": {
              "id": "a4f86671-50dc-48a8-bcc7-f5e3df4a2758",
              "name": "Product 2772",
              "sku": "sku 2773",
              "updated_datetime": "2026-08-19T13:19:39.570269Z"
            },
            "quantity": "10.000000000",
            "returned_quantity": "0",
            "thc_percentage_total": null,
            "total_cost_actual": null,
            "total_cost_default": null
          },
          "order_item_id": "5ba71026-c0c4-43de-b83d-f675b169ff1a",
          "package": null,
          "price": "10.000000000",
          "product": {
            "id": "a4f86671-50dc-48a8-bcc7-f5e3df4a2758",
            "name": "Product 2772",
            "sku": "sku 2773",
            "updated_datetime": "2026-08-19T13:19:39.570269Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "order": {
        "id": "e0c44259-8d47-4306-bf78-2a88b5175f00",
        "order_number": "SO-154",
        "status": "PENDING",
        "total": "320.00"
      },
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-3096@example.com",
        "full_name": "FirstName6264 LastName6265",
        "id": "00000000-0000-0000-0000-000000002729",
        "inserted_datetime": "2026-08-19T13:19:39.530828Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000027fc",
          "name": "Admin 3195"
        }
      },
      "paid_amount": "0.0",
      "payment_term_name": null,
      "payments": [],
      "remaining_amount": "200.00",
      "status": "NOT_PAID",
      "total": "200.00",
      "updated_datetime": "2026-08-19T13:19:39.612441Z",
      "voided_datetime": null
    },
    {
      "billing_location": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-000000001d3f",
        "id": "00000000-0000-0000-0000-00000000095c",
        "license_id": "00000000-0000-0000-0000-000000000277",
        "license_number": "CDPH-00000191",
        "name": "Place 727"
      },
      "charges": [
        {
          "id": "92880d53-3b19-4919-bd81-e92500f69fd6",
          "inserted_datetime": "2026-08-19T13:19:39.527249Z",
          "name": "C1",
          "percent": "10.0000",
          "price": "1.00",
          "tax": {
            "id": "00000000-0000-0000-0000-000000000030",
            "name": "T1"
          },
          "type": "CHARGE",
          "unit_type": "PERCENT"
        }
      ],
      "company": {
        "id": "00000000-0000-0000-0000-000000001260",
        "name": "Company 2277",
        "updated_datetime": "2026-08-19T13:19:39.433887Z"
      },
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "user1@a.com",
        "full_name": "John Foo",
        "id": "00000000-0000-0000-0000-000000002714",
        "inserted_datetime": "2026-08-19T13:19:39.394814Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000027ea",
          "name": "Admin 3177"
        }
      },
      "custom_data": [
        {
          "id": 227,
          "name": "Custom Field 48",
          "value": "Custom Field Value 1"
        }
      ],
      "due_datetime": "2020-01-01T00:00:01.000000Z",
      "external_notes": "Visible to the customer",
      "id": "00000000-0000-0000-0000-000000000114",
      "inserted_datetime": "2026-08-19T13:19:39.454533Z",
      "internal_notes": "Only visible internally",
      "invoice_datetime": "2020-01-01T00:00:02.000000Z",
      "invoice_number": "INV-123",
      "items": [
        {
          "batch": null,
          "cost_per_unit": null,
          "cost_per_unit_default": null,
          "description": "Line description",
          "id": "00000000-0000-0000-0000-0000000000fb",
          "inserted_datetime": "2026-08-19T13:19:39.455832Z",
          "order_item": {
            "batch": null,
            "compliance_quantity": null,
            "cost_per_unit": null,
            "cost_per_unit_default": null,
            "id": "9f3e3cd4-bdc3-4230-abba-0da942de44dc",
            "inserted_datetime": "2026-08-19T13:19:39.436610Z",
            "is_sample": false,
            "leaflink_id": null,
            "location": null,
            "note": null,
            "package": {
              "batch_number": "B1",
              "compliance_label": "ABCDEF012345670000000225",
              "id": "00000000-0000-0000-0000-00000000016f",
              "metrc_label": "ABCDEF012345670000000225",
              "status": "active"
            },
            "price": "10.000000000",
            "price_base": "10",
            "product": {
              "id": "9ceb923f-cdf8-4ff3-8c90-2f8164588d41",
              "name": "P1",
              "sku": "SKU1",
              "updated_datetime": "2026-08-19T13:19:39.411960Z"
            },
            "quantity": "2.000000000",
            "returned_quantity": "0",
            "thc_percentage_total": null,
            "total_cost_actual": null,
            "total_cost_default": null
          },
          "order_item_id": "9f3e3cd4-bdc3-4230-abba-0da942de44dc",
          "package": {
            "batch_number": "B1",
            "compliance_label": "ABCDEF012345670000000225",
            "id": "00000000-0000-0000-0000-00000000016f",
            "metrc_label": "ABCDEF012345670000000225",
            "status": "active"
          },
          "price": "10.000000000",
          "product": {
            "id": "9ceb923f-cdf8-4ff3-8c90-2f8164588d41",
            "name": "P1",
            "sku": "SKU1",
            "updated_datetime": "2026-08-19T13:19:39.411960Z"
          },
          "quantity": "1.000000000",
          "returned_quantity": "0",
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "order": {
        "id": "1536cce6-2002-4d9a-89b6-6cb63600c11d",
        "order_number": "SO-123",
        "status": "COMPLETED",
        "total": "10.00"
      },
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "user2@a.com",
        "full_name": "John Bar",
        "id": "00000000-0000-0000-0000-000000002715",
        "inserted_datetime": "2026-08-19T13:19:39.397891Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000027eb",
          "name": "Admin 3178"
        }
      },
      "paid_amount": "5.00",
      "payment_term_name": "Net 30",
      "payments": [
        {
          "amount": "5",
          "company": {
            "id": "00000000-0000-0000-0000-000000001260",
            "name": "Company 2277",
            "updated_datetime": "2026-08-19T13:19:39.433887Z"
          },
          "credit_uses": [],
          "description": null,
          "fully_paid_with_credits": false,
          "id": "00000000-0000-0000-0000-000000000069",
          "inserted_datetime": "2026-08-19T13:19:39.476507Z",
          "invoice": {
            "id": "00000000-0000-0000-0000-000000000114",
            "invoice_number": "INV-123",
            "status": "PARTIALLY_PAID",
            "total": "8.00"
          },
          "overpayment_credits": [],
          "payment_date": "2026-08-19T13:19:39.465714Z",
          "payment_method": {
            "active": true,
            "deleted_at": null,
            "id": "00000000-0000-0000-0000-00000000008a",
            "inserted_datetime": "2026-08-19T13:19:39.465372Z",
            "name": "Payment Method 45",
            "qb_payment_method_id": null,
            "type": "CREDIT_CARD",
            "updated_datetime": "2026-08-19T13:19:39.465372Z"
          },
          "payment_number": "PYT-0000001",
          "payment_type": "INVOICE",
          "purchase": null,
          "quickbooks_deposit_account_id": null,
          "status": "POSTED",
          "updated_datetime": "2026-08-19T13:19:39.476507Z"
        }
      ],
      "remaining_amount": "3.00",
      "status": "PARTIALLY_PAID",
      "total": "8.00",
      "updated_datetime": "2026-08-19T13:19:39.479134Z",
      "voided_datetime": null
    }
  ],
  "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.

Required permission: invoices_permissions_view. Results are filtered to only include invoices the authenticated user can access under their team restrictions.

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 query number false ?page[number]=1
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-0000000000fa/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzYsImlhdCI6MTc4NzE0NTU3NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODg0NjRhMGUtODkyYS00Y2VjLTg1MGItODdlZDBkZDAzY2U0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTY2NCIsInR5cCI6ImFjY2VzcyJ9.FUXbu8JQQ_Px2UWHnu5BhmuaYqsC2kIMPU0FKWcximA

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

Response

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

{
  "data": {
    "amount": "100",
    "company": {
      "id": "00000000-0000-0000-0000-000000001151",
      "name": "Company 1952",
      "updated_datetime": "2026-08-19T13:19:36.930599Z"
    },
    "credit_uses": [],
    "description": "Payment for invoice",
    "fully_paid_with_credits": false,
    "id": "00000000-0000-0000-0000-000000000063",
    "inserted_datetime": "2026-08-19T13:19:36.969749Z",
    "invoice": {
      "id": "00000000-0000-0000-0000-0000000000fa",
      "invoice_number": "Invoice #54",
      "status": "OVER_PAID",
      "total": "100.00"
    },
    "overpayment_credits": [
      {
        "amount": "0.01",
        "credit_number": "CRT-0000001",
        "id": "cd04f370-be8a-4da4-a6ea-c8e9b88385fc",
        "source": "INVOICE_PAYMENT"
      }
    ],
    "payment_date": "2020-01-01T00:00:00.000000Z",
    "payment_method": {
      "active": true,
      "deleted_at": null,
      "id": "00000000-0000-0000-0000-000000000085",
      "inserted_datetime": "2026-08-19T13:19:36.944886Z",
      "name": "Payment Method 0",
      "qb_payment_method_id": null,
      "type": "CREDIT_CARD",
      "updated_datetime": "2026-08-19T13:19:36.944886Z"
    },
    "payment_number": "PYT-0000001",
    "payment_type": "INVOICE",
    "purchase": null,
    "quickbooks_deposit_account_id": "QBD-123",
    "quickbooks_deposit_account_name": "QBD-NAME",
    "quickbooks_sync_enqueued": true,
    "status": "POSTED",
    "updated_datetime": "2026-08-19T13:19:36.969749Z"
  }
}

Required permission: invoices_permissions_receive_payment. The authenticated user must also be allowed to view invoices under their team restrictions.

Request

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

Parameters

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

Responses

Status Description Schema
200 A single payment PaymentResponse

Upsert an invoice

POST /invoices creates an invoice

POST /public/v1/invoices
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzQsImlhdCI6MTc4NzE0NTU3NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzM4MGY4MGMtZWQ5Ny00YzhjLWJkNmItYzc3NDM0MGU2MjhkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTczLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTAzNyIsInR5cCI6ImFjY2VzcyJ9.lOLBbYEFz0KInsmrFLX4jzziuCAlvtGjtSBq_yOGQDM

{
  "billing_location_id": "00000000-0000-0000-0000-000000000812",
  "charges": [
    {
      "name": "C1",
      "percent": "10.0000",
      "type": "CHARGE",
      "unit_type": "PERCENT"
    },
    {
      "name": "C2",
      "price": "-5.0000",
      "type": "DISCOUNT",
      "unit_type": "PRICE"
    }
  ],
  "custom_data": {
    "219": [
      "A",
      "B"
    ]
  },
  "due_datetime": "2020-01-30T00:00:01.000000Z",
  "external_notes": "Visible to the customer",
  "internal_notes": "Only visible internally",
  "invoice_datetime": "2020-01-01T00:00:00.000000Z",
  "items": [
    {
      "description": "Custom line note",
      "order_item_id": "ec28f574-87be-4888-ae9a-043fc9606c6e",
      "quantity": "1.000000000"
    },
    {
      "order_item_id": "9cc62f27-caf4-436e-88f2-5044772bcac0",
      "quantity": "10.000000000"
    }
  ],
  "order_id": "3707e309-d307-4440-bd41-b20a822a0e4a",
  "owner_id": "00000000-0000-0000-0000-00000000234d"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 4f6cc138da5e9745034492a4a55dab0a-558cfb034f1bf62c-0

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001a13",
      "id": "00000000-0000-0000-0000-000000000812",
      "license_id": null,
      "license_number": null,
      "name": "Place 398"
    },
    "charges": [
      {
        "id": "b6518d4b-4655-40ac-b8b7-93dab0567776",
        "inserted_datetime": "2026-08-19T13:19:34.258747Z",
        "name": "C1",
        "percent": "10.0000",
        "price": "5.30",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "996a84a7-580a-4de4-9edf-8c884712525a",
        "inserted_datetime": "2026-08-19T13:19:34.259945Z",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-000000000fdc",
      "name": "Company 1465",
      "updated_datetime": "2026-08-19T13:19:34.193683Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-00000000234d",
      "inserted_datetime": "2026-08-19T13:19:34.197963Z",
      "role": {
        "id": "00000000-0000-0000-0000-00000000242d",
        "name": "Admin 2220"
      }
    },
    "custom_data": [
      {
        "id": 219,
        "name": "Custom Field 40",
        "value": "A,B"
      }
    ],
    "due_datetime": "2020-01-30T00:00:01.000000Z",
    "external_notes": "Visible to the customer",
    "id": "00000000-0000-0000-0000-0000000000e6",
    "inserted_datetime": "2026-08-19T13:19:34.257811Z",
    "internal_notes": "Only visible internally",
    "invoice_datetime": "2020-01-01T00:00:00.000000Z",
    "invoice_number": "INV-0000001",
    "items": [
      {
        "batch": null,
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "description": "Custom line note",
        "id": "00000000-0000-0000-0000-0000000000c0",
        "inserted_datetime": "2026-08-19T13:19:34.260500Z",
        "order_item": {
          "batch": null,
          "compliance_quantity": null,
          "cost_per_unit": null,
          "cost_per_unit_default": null,
          "id": "ec28f574-87be-4888-ae9a-043fc9606c6e",
          "inserted_datetime": "2026-08-19T13:19:34.237726Z",
          "is_sample": false,
          "leaflink_id": null,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 90210, US",
            "company_id": "00000000-0000-0000-0000-000000001a13",
            "id": "00000000-0000-0000-0000-000000000812",
            "license_id": null,
            "name": "Place 398"
          },
          "note": null,
          "package": null,
          "price": "3.000000000",
          "price_base": "3",
          "product": {
            "id": "ac1323c3-4658-4bc7-bea5-1f8e4965b3c1",
            "name": "P1",
            "sku": "SKU1",
            "updated_datetime": "2026-08-19T13:19:34.207830Z"
          },
          "quantity": "1.000000000",
          "returned_quantity": "0",
          "thc_percentage_total": null,
          "total_cost_actual": null,
          "total_cost_default": null
        },
        "order_item_id": "ec28f574-87be-4888-ae9a-043fc9606c6e",
        "package": null,
        "price": "3.000000000",
        "product": {
          "id": "ac1323c3-4658-4bc7-bea5-1f8e4965b3c1",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2026-08-19T13:19:34.207830Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000a2c",
          "name": "B2"
        },
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "description": null,
        "id": "00000000-0000-0000-0000-0000000000c1",
        "inserted_datetime": "2026-08-19T13:19:34.261187Z",
        "order_item": {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000a2c",
            "name": "B2"
          },
          "compliance_quantity": null,
          "cost_per_unit": null,
          "cost_per_unit_default": null,
          "id": "9cc62f27-caf4-436e-88f2-5044772bcac0",
          "inserted_datetime": "2026-08-19T13:19:34.243574Z",
          "is_sample": false,
          "leaflink_id": null,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 90210, US",
            "company_id": "00000000-0000-0000-0000-000000001a13",
            "id": "00000000-0000-0000-0000-000000000812",
            "license_id": null,
            "name": "Place 398"
          },
          "note": null,
          "package": null,
          "price": "5.000000000",
          "price_base": "5",
          "product": {
            "id": "b71140dd-a2cd-4246-b7ac-0dfc52915e2d",
            "name": "P2",
            "sku": "SKU2",
            "updated_datetime": "2026-08-19T13:19:34.218506Z"
          },
          "quantity": "10.000000000",
          "returned_quantity": "0",
          "thc_percentage_total": null,
          "total_cost_actual": null,
          "total_cost_default": null
        },
        "order_item_id": "9cc62f27-caf4-436e-88f2-5044772bcac0",
        "package": null,
        "price": "5.000000000",
        "product": {
          "id": "b71140dd-a2cd-4246-b7ac-0dfc52915e2d",
          "name": "P2",
          "sku": "SKU2",
          "updated_datetime": "2026-08-19T13:19:34.218506Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "order": {
      "id": "3707e309-d307-4440-bd41-b20a822a0e4a",
      "order_number": "SO-77",
      "status": "PROCESSING",
      "total": "0.00"
    },
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-00000000234d",
      "inserted_datetime": "2026-08-19T13:19:34.197963Z",
      "role": {
        "id": "00000000-0000-0000-0000-00000000242d",
        "name": "Admin 2220"
      }
    },
    "paid_amount": "0.0",
    "payment_term_name": null,
    "payments": [],
    "remaining_amount": "53.30",
    "status": "NOT_PAID",
    "total": "53.30",
    "updated_datetime": "2026-08-19T13:19:34.268004Z",
    "voided_datetime": null
  }
}

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. Required permission: invoices_permissions_create to create a new invoice, invoices_permissions_edit (and access to the invoice under team restrictions) to update an existing invoice.

Request

POST /public/v1/invoices

Parameters

Parameter Description In Type Required Default Example
billing_location_id The billing location's ID body string false
charges The extra lines added on top of the invoice's items — fees, discounts, or taxes. Each entry follows the InvoiceChargeRequest shape. body array false
custom_data A map of custom field IDs to their values. Use GET /public/v1/custom-fields?parent_object=invoice to retrieve available custom fields, their IDs, and their types. The value format depends on the field's type: a text field takes a string, a date field takes a full ISO8601 datetime, and a checkbox field takes an array of its selected options. body object false {"101":"Some text value","102":"2026-08-18T00:00:00.000-07:00","103":["Option A","Option B"]}
due_datetime The datetime at which the invoice is due body string false
external_notes Notes on this invoice that are visible to the customer body string false
id Unique ID for this invoice. Omit it to create a new invoice — Distru assigns the ID. Provide an existing invoice's ID to update that invoice; an ID that doesn't exist returns a not-found error. body string false
internal_notes Notes on this invoice that are only visible internally body string false
invoice_datetime The datetime on which the invoice was placed body string false
items The line items being billed on this invoice, one entry per line. Each entry follows the InvoiceItemRequest shape. body array false
owner_id The ID of the Distru user that owns this invoice body string false

Responses

Status Description Schema
200 A single invoice InvoiceResponse

Location

Get a location

GET /public/v1/locations/:id returns the expected location

GET /public/v1/locations/00000000-0000-0000-0000-000000000740
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDZjMDhiZDYtZWU2ZS00Y2Q2LWFlMjgtOGEwY2RmNDFlYmRlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzk0NiIsInR5cCI6ImFjY2VzcyJ9.59AatuyThrWEW60SAOgwgRZQbE5wW8GArh-UoOFrAVg

Response

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

{
  "data": {
    "address": "123 Fake Street, Beverly Hills, CA 90210, US",
    "apt": null,
    "city": "Beverly Hills",
    "company_id": "00000000-0000-0000-0000-00000000178b",
    "country": "US",
    "deleted_at": null,
    "id": "00000000-0000-0000-0000-000000000740",
    "inserted_datetime": "2026-08-19T13:19:30.198905Z",
    "latitude": 33.5,
    "license": {
      "active": true,
      "expiry_datetime": "2026-09-19T13:19:30.192473Z",
      "id": "00000000-0000-0000-0000-0000000001d6",
      "inserted_datetime": "2026-08-19T13:19:30.192542Z",
      "issue_datetime": "2026-08-19T13:19:30.192472Z",
      "license_number": "CDPH-00000030",
      "license_type": "Other"
    },
    "license_id": "00000000-0000-0000-0000-0000000001d6",
    "longitude": -117.2,
    "metrc_id": 42,
    "name": "Place 188",
    "state": "CA",
    "street_address": "123 Fake Street",
    "updated_datetime": "2026-08-19T13:19:30.198905Z",
    "zip": "90210"
  }
}

Get a single location given the ID.

Required permission: companies_permissions_view.

Request

GET /public/v1/locations/{id}

Parameters

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

Responses

Status Description Schema
200 A single location LocationResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZTE2ODE4MjctMWU4OS00ZGU2LWIyYzQtM2FmOWM1NjQ2OTM3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODAxNiIsInR5cCI6ImFjY2VzcyJ9.D_L2KPm363qhNLNC7OZMKbVyLMrNRDrKktyn_ipR9is

Response

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

{
  "data": [
    {
      "address": "123 Fake Street, Suite 100, Beverly Hills, CA 90210, US",
      "apt": "Suite 100",
      "city": "Beverly Hills",
      "company_id": "00000000-0000-0000-0000-0000000017b8",
      "country": "US",
      "deleted_at": null,
      "id": "00000000-0000-0000-0000-000000000759",
      "inserted_datetime": "2026-08-19T13:19:30.464051Z",
      "latitude": 12.34,
      "license": null,
      "license_id": null,
      "longitude": -56.78,
      "metrc_id": null,
      "name": "Place 213",
      "state": "CA",
      "street_address": "123 Fake Street",
      "updated_datetime": "2026-08-19T13:19:30.464051Z",
      "zip": "90210"
    },
    {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "apt": null,
      "city": "Beverly Hills",
      "company_id": "00000000-0000-0000-0000-0000000017b8",
      "country": "US",
      "deleted_at": null,
      "id": "00000000-0000-0000-0000-00000000075a",
      "inserted_datetime": "2026-08-19T13:19:30.478087Z",
      "latitude": 1.0,
      "license": {
        "active": true,
        "expiry_datetime": "2026-09-19T13:19:30.457296Z",
        "id": "00000000-0000-0000-0000-0000000001d9",
        "inserted_datetime": "2026-08-19T13:19:30.457340Z",
        "issue_datetime": "2026-08-19T13:19:30.457295Z",
        "license_number": "CDPH-00000033",
        "license_type": "Type N Infusions"
      },
      "license_id": "00000000-0000-0000-0000-0000000001d9",
      "longitude": 2.0,
      "metrc_id": 999,
      "name": "Place 214",
      "state": "CA",
      "street_address": "123 Fake Street",
      "updated_datetime": "2026-08-19T13:19:30.478087Z",
      "zip": "90210"
    }
  ],
  "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.

Required permission: companies_permissions_view.

Request

GET /public/v1/locations

Parameters

Parameter Description In Type Required Default Example
deleted Filter deleted locations. no returns non-deleted, only returns deleted, include returns both. query string false no
inserted_datetime Filter by creation datetime. Accepts a comma-separated from,to range (ISO-8601 UTC); either side may be omitted, e.g. 2022-07-10T00:00:00Z, returns locations created on or after that time. query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1
updated_datetime Filter by last-modified datetime. Accepts a comma-separated from,to range (ISO-8601 UTC); either side may be omitted, e.g. ,2022-07-10T00:00:00Z returns locations last modified on or before that time. query string false ,2022-07-10T00:00:00Z

Responses

Status Description Schema
200 A list of locations Locations

Get a menu

GET /public/v1/menus/:id returns the expected menu

GET /public/v1/menus/00000000-0000-0000-0000-000000000090
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiN2E5ZGM1YjQtNTljNi00NTNmLTlhYjMtMjA3MzBhMDFiOTgwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzAyNSIsInR5cCI6ImFjY2VzcyJ9.81WRAZoQSv1f8fBCjvjOiK374Vm-GOAiPMhbHScmPEw

Response

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

{
  "data": {
    "active": true,
    "available_delivery_days": [
      "MONDAY",
      "TUESDAY",
      "WEDNESDAY",
      "THURSDAY",
      "FRIDAY",
      "SATURDAY",
      "SUNDAY"
    ],
    "default_order_status": "PENDING",
    "discoverable": true,
    "external_name": "External Test Menu",
    "id": "00000000-0000-0000-0000-000000000090",
    "inserted_datetime": "2026-08-19T13:19:26.603012Z",
    "internal_name": "Test Menu",
    "minimum_order_lead_time_days": 0,
    "minimum_order_subtotal": "50.5",
    "product_count": 1,
    "updated_datetime": "2026-08-19T13:19:26.603012Z",
    "url": "https://distru.com/menu/company/test",
    "visibility": "PUBLIC"
  }
}

Get a single menu given the ID.

Required permission: products_permissions_view.

Request

GET /public/v1/menus/{id}

Parameters

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

Responses

Status Description Schema
200 A single menu MenuResponse
404 Not Found

Get menus

GET /public/v1/menus returns menus for the company with default pagination

GET /public/v1/menus
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjdmNjRlNmYtN2M5Yi00ZGY3LWFjNWMtNzBhODA3ZGY3OTc1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzE3NyIsInR5cCI6ImFjY2VzcyJ9.WdQTJNzcv0WQdFpq4fG2nOKIU44rG8RpclwlUE2E46c

Response

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

{
  "data": [
    {
      "active": true,
      "available_delivery_days": [
        "MONDAY",
        "TUESDAY",
        "WEDNESDAY",
        "THURSDAY",
        "FRIDAY",
        "SATURDAY",
        "SUNDAY"
      ],
      "default_order_status": "PENDING",
      "discoverable": true,
      "external_name": "Ext A",
      "id": "00000000-0000-0000-0000-0000000000ac",
      "inserted_datetime": "2026-08-19T13:19:27.260805Z",
      "internal_name": "Alpha",
      "minimum_order_lead_time_days": 0,
      "minimum_order_subtotal": null,
      "product_count": 0,
      "updated_datetime": "2026-08-19T13:19:27.260805Z",
      "url": null,
      "visibility": "PUBLIC"
    },
    {
      "active": true,
      "available_delivery_days": [
        "MONDAY",
        "TUESDAY",
        "WEDNESDAY",
        "THURSDAY",
        "FRIDAY",
        "SATURDAY",
        "SUNDAY"
      ],
      "default_order_status": "PENDING",
      "discoverable": true,
      "external_name": "Ext B",
      "id": "00000000-0000-0000-0000-0000000000ad",
      "inserted_datetime": "2026-08-19T13:19:27.269554Z",
      "internal_name": "Beta",
      "minimum_order_lead_time_days": 0,
      "minimum_order_subtotal": null,
      "product_count": 0,
      "updated_datetime": "2026-08-19T13:19:27.269554Z",
      "url": null,
      "visibility": "PUBLIC"
    }
  ],
  "next_page": null
}

List menus for the authenticated company with visibility, active state, and active product counts. A menu is a shareable product catalog and price list you send to customers.

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

Required permission: products_permissions_view.

Request

GET /public/v1/menus

Parameters

Parameter Description In Type Required Default Example
active Filter by menu active flag: true, false, or true,false (both). query string false
page Pagination information query number false ?page[number]=1
visibility Comma-separated visibility: PUBLIC, PRIVATE, PASSCODE_PROTECTED. query string false

Responses

Status Description Schema
200 Menus index Menus

Metrc

Get Metrc tags

GET /public/v1/metrc/tags returns the company's Metrc tags with the full shape

GET /public/v1/metrc/tags
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTg1YjMwN2MtYjM2Ni00YTE5LTg4ODYtMGViZmEwM2Y1OWI2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzI0MSIsInR5cCI6ImFjY2VzcyJ9.xwi73vVmunuHNdjy0JnQEVCo1FxvCThr4rez-SFP5XU

Response

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

{
  "data": [
    {
      "assigned_datetime": "2024-01-02T12:00:00.000000Z",
      "commissioned_date": "2026-08-19",
      "id": "00000000-0000-0000-0000-000000000037",
      "inserted_datetime": "2026-08-19T13:19:27.516342Z",
      "is_assigned": true,
      "kind": "PACKAGE",
      "license_id": "00000000-0000-0000-0000-0000000001c1",
      "tag": "1A4010200001234000000001",
      "updated_datetime": "2026-08-19T13:19:27.516342Z"
    }
  ],
  "next_page": null
}

Get the Metrc tags (unique compliance identifiers) provisioned to your licenses, filtered by various attributes. Results are ordered by tag label.

Note: The page size for this endpoint is 5,000 Metrc tags per page.

Request

GET /public/v1/metrc/tags

Parameters

Parameter Description In Type Required Default Example
inserted_datetime Filter by when the tag was created in Distru. Accepts a comma-separated from,to range (ISO-8601 UTC); either side may be omitted, e.g. 2022-07-10T00:00:00Z, returns tags created on or after that time. query string false 2022-07-10T00:00:00Z,
is_assigned Filter by whether the tag has been assigned to a package or plant. query boolean false false
kind Filter by tag kind: PACKAGE (retail/wholesale package tags) or PLANT (plant tags). query string false PACKAGE
license_id Filter by the ID of the license the tags belong to. query string false
page Pagination information query number false ?page[number]=1
search Filter to tags whose label contains this value (case-insensitive substring match). query string false 0004999
tag Filter by an exact full tag label. query string false 1A4FF0100000022000004999
updated_datetime Filter by when the tag was last modified in Distru. Accepts a comma-separated from,to range (ISO-8601 UTC); either side may be omitted, e.g. ,2022-07-10T00:00:00Z returns tags last modified on or before that time. query string false ,2022-07-10T00:00:00Z

Responses

Status Description Schema
200 A list of Metrc tags MetrcTags

Get a Metrc tag

GET /public/v1/metrc/tags/:id returns a single Metrc tag

GET /public/v1/metrc/tags/00000000-0000-0000-0000-00000000002e
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTgyMWQwNTItYWQ1MS00NmRhLTkzOTItN2Y0YzEwYWMxOWY2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzE5NiIsInR5cCI6ImFjY2VzcyJ9.NplNPEsMTdqn1jZSRyKCoSmd-4agwov6orFsFn8bdPQ

Response

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

{
  "data": {
    "assigned_datetime": null,
    "commissioned_date": "2026-08-19",
    "id": "00000000-0000-0000-0000-00000000002e",
    "inserted_datetime": "2026-08-19T13:19:27.325041Z",
    "is_assigned": false,
    "kind": "PACKAGE",
    "license_id": "00000000-0000-0000-0000-0000000001bb",
    "tag": "1A4010200001234000000001",
    "updated_datetime": "2026-08-19T13:19:27.325041Z"
  }
}

Get a single Metrc tag given its Distru ID.

Request

GET /public/v1/metrc/tags/{id}

Parameters

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

Responses

Status Description Schema
200 A single Metrc tag MetrcTagResponse
404 Not Found

OfficialProductCategory

Get official product categories

GET /public/v1/official-product-categories returns the global official product categories with raw string ids

GET /public/v1/official-product-categories
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjZlMzgzODAtMWNlMS00ZmE1LThmYWUtOTkwYmI0YTZhOGNkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzc4NyIsInR5cCI6ImFjY2VzcyJ9.lC7n7x09lBnfy_SSKu1hktLQ0ROOe48tCaF0pZrGeIc

Response

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

{
  "data": [
    {
      "id": "CAPSULES",
      "name": "Capsules"
    },
    {
      "id": "CLONES",
      "name": "Clones & Seeds"
    },
    {
      "id": "CONCENTRATES",
      "name": "Concentrates"
    },
    {
      "id": "EDIBLES",
      "name": "Edibles"
    },
    {
      "id": "FLOWER",
      "name": "Flower"
    },
    {
      "id": "MERCH",
      "name": "Merch"
    },
    {
      "id": "OTHER",
      "name": "Other"
    },
    {
      "id": "PREROLLS",
      "name": "Pre-Rolls"
    },
    {
      "id": "TINCTURES",
      "name": "Tinctures"
    },
    {
      "id": "TOPICALS",
      "name": "Topicals"
    },
    {
      "id": "VAPES",
      "name": "Vapes"
    }
  ]
}

List the official product categories in Distru. These are global, system-defined reference categories that every company shares. Your own product categories each map to one of these via official_product_category_id.

Request

GET /public/v1/official-product-categories

Responses

Status Description Schema
200 A list of official product categories OfficialProductCategories

Order

Get an order

GET /orders/:id returns the expected order

GET /public/v1/orders/5076d840-70da-4843-ac22-24cd40787001
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxODMsImlhdCI6MTc4NzE0NTU4MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTEyNjE2MDEtZTFmMS00YjFhLTk4YWItNGU1YTdmNjczZTkwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTgyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTAyMzMiLCJ0eXAiOiJhY2Nlc3MifQ.NsHDi6YO4XFoIufG3p2zchlPYOW89EqPN2iJmm_tbC8

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 12d62a288074616f3928e4ddc7e3711d-10d3b5c21446780b-0

{
  "data": {
    "billing_location": null,
    "biotrack_id": null,
    "blaze_payment_type": null,
    "buyer_company": null,
    "buyer_note": null,
    "charges": [
      {
        "id": "6c9fbdf4-f9ad-4c26-a3c0-ea26adcda13d",
        "inserted_datetime": "2026-08-19T13:19:44.034815Z",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "tax": {
          "id": "00000000-0000-0000-0000-000000000032",
          "name": "T1"
        },
        "type": "CHARGE",
        "unit_type": "PERCENT"
      }
    ],
    "combined_order": null,
    "company": {
      "id": "00000000-0000-0000-0000-000000001311",
      "name": "Company 2491",
      "updated_datetime": "2026-08-19T13:19:43.957698Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-3299@example.com",
      "full_name": "FirstName6672 LastName6673",
      "id": "00000000-0000-0000-0000-0000000027fa",
      "inserted_datetime": "2026-08-19T13:19:43.953944Z",
      "role": {
        "id": "00000000-0000-0000-0000-0000000028ca",
        "name": "Admin 3401"
      }
    },
    "custom_data": [
      {
        "id": 230,
        "name": "Custom Field 51",
        "value": "Custom Field Value 1"
      }
    ],
    "delivered_datetime": "2026-08-19T13:19:43.975657Z",
    "delivery_datetime": null,
    "due_datetime": "2026-08-19T13:19:43.975662Z",
    "external_notes": null,
    "id": "5076d840-70da-4843-ac22-24cd40787001",
    "inserted_datetime": "2026-08-19T13:19:43.975998Z",
    "internal_notes": null,
    "inventory_source": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001e14",
      "id": "00000000-0000-0000-0000-0000000009a1",
      "license_id": null,
      "license_number": null,
      "name": "Place 796"
    },
    "invoices": [],
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000c7f",
          "name": "B3142"
        },
        "compliance_quantity": null,
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "id": "c8f72dba-8d4d-451a-975d-dbc6abe9e094",
        "inserted_datetime": "2026-08-19T13:19:43.987784Z",
        "is_sample": false,
        "leaflink_id": null,
        "location": null,
        "note": null,
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "dbe76e5d-d951-423f-86f9-5a232abb5d5e",
          "name": "Product 3140",
          "sku": "sku 3141",
          "updated_datetime": "2026-08-19T13:19:43.985302Z"
        },
        "quantity": "15.000000000",
        "returned_quantity": "0",
        "thc_percentage_total": null,
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000c80",
          "name": "B3145"
        },
        "compliance_quantity": null,
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "id": "b01e018c-91e1-4b66-9595-2eb1f129d9c0",
        "inserted_datetime": "2026-08-19T13:19:43.998659Z",
        "is_sample": false,
        "leaflink_id": null,
        "location": null,
        "note": null,
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "5acdda30-0fbd-4cf2-adf7-f0926842b4af",
          "name": "Product 3143",
          "sku": "sku 3144",
          "updated_datetime": "2026-08-19T13:19:43.996383Z"
        },
        "quantity": "10.000000000",
        "returned_quantity": "0",
        "thc_percentage_total": null,
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000c81",
          "name": "B3148"
        },
        "compliance_quantity": null,
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "id": "d3d3bbc3-295d-4169-bdde-63fdc123fed5",
        "inserted_datetime": "2026-08-19T13:19:44.007145Z",
        "is_sample": false,
        "leaflink_id": null,
        "location": null,
        "note": null,
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "9d596ebe-456d-44a5-b960-9dd1e43558cb",
          "name": "Product 3146",
          "sku": "sku 3147",
          "updated_datetime": "2026-08-19T13:19:44.005343Z"
        },
        "quantity": "5.000000000",
        "returned_quantity": "0",
        "thc_percentage_total": null,
        "total_cost_actual": null,
        "total_cost_default": null
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000c82",
          "name": "B3151"
        },
        "compliance_quantity": null,
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "id": "c8f59bb7-1422-4dfd-97fb-c16d92f55b39",
        "inserted_datetime": "2026-08-19T13:19:44.015415Z",
        "is_sample": false,
        "leaflink_id": null,
        "location": null,
        "note": null,
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "1e42db9c-3f44-48ff-9977-6dcbf8fa4e30",
          "name": "Product 3149",
          "sku": "sku 3150",
          "updated_datetime": "2026-08-19T13:19:44.013585Z"
        },
        "quantity": "2.000000000",
        "returned_quantity": "0",
        "thc_percentage_total": null,
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_id": null,
    "leaflink_order_number": null,
    "menu": null,
    "metrc_transfer_id": null,
    "metrc_transfer_template_error": null,
    "metrc_transfer_template_id": null,
    "metrc_transfer_template_status": null,
    "order_datetime": "2026-08-19T13:19:43.975662Z",
    "order_number": "SO-171",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-3299@example.com",
      "full_name": "FirstName6672 LastName6673",
      "id": "00000000-0000-0000-0000-0000000027fa",
      "inserted_datetime": "2026-08-19T13:19:43.953944Z",
      "role": {
        "id": "00000000-0000-0000-0000-0000000028ca",
        "name": "Admin 3401"
      }
    },
    "payment_term_name": null,
    "returns": [],
    "shipping_location": null,
    "status": "COMPLETED",
    "total": "320.00",
    "updated_datetime": "2026-08-19T13:19:44.028632Z"
  }
}

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.

Required permission: orders_permissions_view. The authenticated user must also have access to the requested order under their team restrictions.

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 OrderResponse

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxODUsImlhdCI6MTc4NzE0NTU4NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZThmNTUwZjMtNzc2MC00NGRjLWFkMjItZDgwZjljYmZiYjJhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTg0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTAzMjQiLCJ0eXAiOiJhY2Nlc3MifQ.AneQTRz2UaDCCfZCkTzK1V0IO7LsghQXWjK287VNbHI

Response

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

{
  "data": [
    {
      "billing_location": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-000000001e64",
        "id": "00000000-0000-0000-0000-0000000009bf",
        "license_id": null,
        "license_number": null,
        "name": "Place 825"
      },
      "biotrack_id": null,
      "blaze_payment_type": "CASH",
      "buyer_company": null,
      "buyer_note": null,
      "charges": [
        {
          "id": "c1c5d472-aeea-4481-97b2-91ccf12470ea",
          "inserted_datetime": "2026-08-19T13:19:46.004632Z",
          "name": "C1",
          "percent": "10.0000",
          "price": "1.00",
          "tax": {
            "id": "00000000-0000-0000-0000-000000000033",
            "name": "T1"
          },
          "type": "CHARGE",
          "unit_type": "PERCENT"
        }
      ],
      "combined_order": null,
      "company": {
        "id": "00000000-0000-0000-0000-000000001355",
        "name": "Company 2572",
        "updated_datetime": "2030-11-01T00:00:00.000000Z"
      },
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "user1@a.com",
        "full_name": "John Foo",
        "id": "00000000-0000-0000-0000-000000002852",
        "inserted_datetime": "2026-08-19T13:19:45.949208Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000002923",
          "name": "Admin 3490"
        }
      },
      "custom_data": [
        {
          "id": 231,
          "name": "Custom Field 52",
          "value": "Custom Field Value 1"
        }
      ],
      "delivered_datetime": "2020-01-03T00:00:00.000000Z",
      "delivery_datetime": "2020-01-01T00:00:00.000000Z",
      "due_datetime": "2020-01-01T00:00:01.000000Z",
      "external_notes": null,
      "id": "b4dd44e9-4f2a-448b-a7be-e9498768238c",
      "inserted_datetime": "2020-01-01T00:00:03.000000Z",
      "internal_notes": "Internal notes for this order",
      "inventory_source": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-000000001e64",
        "id": "00000000-0000-0000-0000-0000000009bf",
        "license_id": null,
        "license_number": null,
        "name": "Place 825"
      },
      "invoices": [],
      "items": [
        {
          "batch": null,
          "compliance_quantity": "10.0000",
          "cost_per_unit": null,
          "cost_per_unit_default": null,
          "id": "499f215a-3760-4403-924c-7f2f287d7b2c",
          "inserted_datetime": "2026-08-19T13:19:45.999484Z",
          "is_sample": true,
          "leaflink_id": null,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 90210, US",
            "company_id": "00000000-0000-0000-0000-000000001e64",
            "id": "00000000-0000-0000-0000-0000000009bf",
            "license_id": null,
            "name": "Place 825"
          },
          "note": null,
          "package": {
            "batch_number": "B1",
            "compliance_label": "ABCDEF012345670000000239",
            "id": "00000000-0000-0000-0000-000000000177",
            "metrc_label": "ABCDEF012345670000000239",
            "status": "active"
          },
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "626c93f3-22bd-45fa-bc2b-b9bb5cc0b50d",
            "name": "P1",
            "sku": "SKU1",
            "updated_datetime": "2023-11-02T00:00:00.000000Z"
          },
          "quantity": "1.000000000",
          "returned_quantity": "0",
          "thc_percentage_total": null,
          "total_cost_actual": null,
          "total_cost_default": null
        }
      ],
      "leaflink_id": "1",
      "leaflink_order_number": "5d29a4bb-3365-4fe6-883e-dacb7d033309",
      "menu": null,
      "metrc_transfer_id": 1,
      "metrc_transfer_template_error": null,
      "metrc_transfer_template_id": 2,
      "metrc_transfer_template_status": "COMPLETED",
      "order_datetime": "2020-01-01T00:00:02.000000Z",
      "order_number": "SO-123",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "user2@a.com",
        "full_name": "John Bar",
        "id": "00000000-0000-0000-0000-000000002853",
        "inserted_datetime": "2026-08-19T13:19:45.952271Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000002924",
          "name": "Admin 3491"
        }
      },
      "payment_term_name": null,
      "returns": [],
      "shipping_location": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-000000001e64",
        "id": "00000000-0000-0000-0000-0000000009bf",
        "license_id": null,
        "license_number": null,
        "name": "Place 825"
      },
      "status": "COMPLETED",
      "total": "11.00",
      "updated_datetime": "2020-01-01T00:00:04.000000Z"
    }
  ],
  "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.

Required permission: orders_permissions_view. Results are filtered to only include orders the authenticated user can access under their team restrictions.

Request

GET /public/v1/orders

Parameters

Parameter Description In Type Required Default Example
company_id Filter orders by buyer company (company relationship ID — same UUID as each order's company.id and GET /public/v1/companies).
query string false 550e8400-e29b-41d4-a716-446655440000
delivery_datetime Filter orders by the delivery datetime query string false 2022-07-10T00:00:00Z,
due_datetime Filter orders by their due datetime (the datetime by which the customer is expected to pay) 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 query number false ?page[number]=1
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
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzcsImlhdCI6MTc4NzE0NTU3NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzFmM2E1M2EtZDdkNC00ZTM4LThmZTQtMWU2ZTcwODc3NWE4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTcyOCIsInR5cCI6ImFjY2VzcyJ9.TYBvGClRZwskjvzsNVaxuMiIEe_XMZ-RZbJA3tENjpc

{
  "billing_location_id": "00000000-0000-0000-0000-0000000008e9",
  "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-000000001190",
  "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-0000000008e6",
      "price_base": "10.000000000",
      "product_id": "a5984352-e748-4aaa-bce4-770a7b824c8b",
      "quantity": "1.000000000"
    }
  ],
  "order_datetime": "2020-01-01T00:00:02.000000Z",
  "owner_id": "00000000-0000-0000-0000-000000002600",
  "shipping_location_id": "00000000-0000-0000-0000-0000000008e9",
  "status": "PROCESSING"
}

Response

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

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001c43",
      "id": "00000000-0000-0000-0000-0000000008e9",
      "license_id": null,
      "license_number": null,
      "name": "Place 613"
    },
    "biotrack_id": null,
    "blaze_payment_type": null,
    "buyer_company": null,
    "buyer_note": null,
    "charges": [
      {
        "id": "331963d2-a1bd-4dd6-be05-c7733740b715",
        "inserted_datetime": "2026-08-19T13:19:37.402266Z",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "e79b6a41-2677-4bfb-9b9b-8aa7ff3ef1b8",
        "inserted_datetime": "2026-08-19T13:19:37.403296Z",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "combined_order": null,
    "company": {
      "id": "00000000-0000-0000-0000-000000001190",
      "name": "Company 2025",
      "updated_datetime": "2026-08-19T13:19:37.331787Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000002600",
      "inserted_datetime": "2026-08-19T13:19:37.355154Z",
      "role": {
        "id": "00000000-0000-0000-0000-0000000026d9",
        "name": "Admin 2904"
      }
    },
    "custom_data": [
      {
        "id": 223,
        "name": "Custom Field 44",
        "value": null
      }
    ],
    "delivered_datetime": null,
    "delivery_datetime": "2020-01-01T00:00:00.000000Z",
    "due_datetime": "2020-01-01T00:00:01.000000Z",
    "external_notes": "Thank you for ordering!",
    "id": "1152f517-5b66-47c1-9598-ba716d437d3f",
    "inserted_datetime": "2026-08-19T13:19:37.401172Z",
    "internal_notes": "Internal notes for this order",
    "inventory_source": null,
    "invoices": [],
    "items": [
      {
        "batch": null,
        "compliance_quantity": null,
        "cost_per_unit": null,
        "cost_per_unit_default": null,
        "id": "6927268c-2dd0-4af7-9d6c-ec8aa2e0abc1",
        "inserted_datetime": "2026-08-19T13:19:37.403799Z",
        "is_sample": false,
        "leaflink_id": null,
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 90210, US",
          "company_id": "00000000-0000-0000-0000-000000001c3f",
          "id": "00000000-0000-0000-0000-0000000008e6",
          "license_id": "00000000-0000-0000-0000-00000000024c",
          "name": "Place 610"
        },
        "note": null,
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "a5984352-e748-4aaa-bce4-770a7b824c8b",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2026-08-19T13:19:37.366447Z"
        },
        "quantity": "1.000000000",
        "returned_quantity": "0",
        "thc_percentage_total": null,
        "total_cost_actual": null,
        "total_cost_default": null
      }
    ],
    "leaflink_id": null,
    "leaflink_order_number": null,
    "menu": null,
    "metrc_transfer_id": null,
    "metrc_transfer_template_error": null,
    "metrc_transfer_template_id": null,
    "metrc_transfer_template_status": null,
    "order_datetime": "2020-01-01T00:00:02.000000Z",
    "order_number": "SO-0000001",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-000000002600",
      "inserted_datetime": "2026-08-19T13:19:37.355154Z",
      "role": {
        "id": "00000000-0000-0000-0000-0000000026d9",
        "name": "Admin 2904"
      }
    },
    "payment_term_name": null,
    "returns": [],
    "shipping_location": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001c43",
      "id": "00000000-0000-0000-0000-0000000008e9",
      "license_id": null,
      "license_number": null,
      "name": "Place 613"
    },
    "status": "PROCESSING",
    "total": "6.00",
    "updated_datetime": "2026-08-19T13:19:37.436749Z"
  }
}

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. Required permission: orders_permissions_create to create a new order, orders_permissions_edit (and access to the order under team restrictions) to update an existing order.

Request

POST /public/v1/orders

Parameters

Parameter Description In Type Required Default Example
billing_location_id The billing location's ID body string false
biotrack_id The ID of the BioTrack manifest to associate with this order body 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. body string false CASH
charges The extra lines added on top of the order's items — fees, discounts, or taxes. Each entry follows the OrderChargeRequest shape. body array false
company_id Company ID body string false
custom_data A map of custom field IDs to their values. Use GET /public/v1/custom-fields?parent_object=order to retrieve available custom fields, their IDs, and their types. The value format depends on the field's type: a text field takes a string, a date field takes a full ISO8601 datetime, and a checkbox field takes an array of its selected options. body object false {"101":"Leave at the loading dock","102":"2026-08-18T00:00:00.000-07:00","103":["Fragile","Signature Required"]}
delivery_datetime The datetime on which the order was / will be delivered body string false
due_datetime The datetime by which the customer is expected to pay for this order. Optional: when omitted, it is derived from the customer's default payment term, then the company default order payment term, then falls back to the order date (COD). body string false
email_invoice When true, email the order's invoice. No email is sent unless the order has an invoice (see upsert_invoice) and a recipient can be resolved from email_invoice_addresses or the buyer company relationship's invoice email. body boolean false
email_invoice_addresses Comma-separated list of email addresses to send the invoice to when email_invoice is true. Takes precedence over the company relationship's invoice email. Invalid addresses are rejected. body string false amy@distru.com,john@distru.com
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. body string false
id Unique ID for this order. Omit it to create a new order — Distru assigns the ID. Provide an existing order's ID to update that order; an ID that doesn't exist returns a not-found error. body string false
internal_notes Internal notes for this order body string false
items The products being sold on this order, one entry per line. Each entry follows the OrderItemRequest shape. body array false
metrc_transfer_id The ID of the Metrc transfer to associate with this order body integer false
order_datetime The datetime on which the order was placed body string false
owner_id The ID of the Distru user that owns this order body string false
shipping_location_id The shipping location's ID body string false
status The status to set for this order, controlling where it sits in its lifecycle and how it affects inventory and compliance. See the status field on the order response for what each value means. Note that some transitions have requirements (for example, moving to DELIVERING, DELIVERED, or COMPLETED requires every line item to be fulfilled). body string false PENDING
upsert_invoice When true, create an invoice for this order if it doesn't have one yet, or update the existing invoice with the order's latest changes. body boolean false

Responses

Status Description Schema
200 A single order OrderResponse

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzUsImlhdCI6MTc4NzE0NTU3NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjAwYmFlOTEtYjVkMC00MWVmLTkxNmItNWRiOGExODUxMmY1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTQ3OSIsInR5cCI6ImFjY2VzcyJ9.5nmKUQPYAMZrml1LbgGiRjDXYkKxXlmJyv14xwcSr94

Response

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

{
  "data": [
    {
      "batch_number": null,
      "biotrack_id": null,
      "biotrack_inventory_type_id": null,
      "biotrack_net_quantity_per_unit": null,
      "biotrack_room_id": null,
      "biotrack_status": null,
      "biotrack_usable_weight": null,
      "compliance_label": "ABCDEF012345670000000196",
      "compliance_product_name": "Buds",
      "compliance_strain_name": "Cotton Candy",
      "compliance_transferred_datetime": null,
      "compliance_type": "METRC",
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-2567@example.com",
        "full_name": "FirstName5206 LastName5207",
        "id": "00000000-0000-0000-0000-00000000250c",
        "inserted_datetime": "2026-08-19T13:19:35.990335Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000025ea",
          "name": "Admin 2665"
        }
      },
      "custom_data": [
        {
          "id": 222,
          "name": "Custom Field 43",
          "value": "Custom Field Value 1"
        }
      ],
      "description": null,
      "expiration_date": "2024-01-01T00:00:00.000000Z",
      "expiration_datetime": "2024-01-01T00:00:00.000000Z",
      "finished_datetime": null,
      "harvest_date": "2024-06-15",
      "id": "00000000-0000-0000-0000-000000000161",
      "inactivated_datetime": null,
      "inserted_datetime": "2026-08-19T13:19:36.004889Z",
      "is_production_batch": false,
      "is_test_sample": false,
      "is_trade_sample": true,
      "lab_testing_state": "NotSubmitted",
      "license": {
        "active": true,
        "expiry_datetime": "2026-09-19T13:19:35.960067Z",
        "id": "00000000-0000-0000-0000-000000000233",
        "inserted_datetime": "2026-08-19T13:19:35.960128Z",
        "issue_datetime": "2026-08-19T13:19:35.960066Z",
        "license_number": "CDPH-00000123",
        "license_type": "Specialty Cottage Indoor"
      },
      "location": {
        "id": "00000000-0000-0000-0000-000000000894",
        "name": "Place 528"
      },
      "metrc_archived_date": null,
      "metrc_finished_date": null,
      "metrc_id": 196,
      "metrc_label": "ABCDEF012345670000000196",
      "metrc_production_batch_number": null,
      "metrc_received_datetime": null,
      "metrc_received_from_manifest_number": null,
      "metrc_source_harvest_names": null,
      "metrc_status": "ACTIVE",
      "metrc_transfer_id": null,
      "metrc_unit_name": "Ounces",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-2563@example.com",
        "full_name": "FirstName5198 LastName5199",
        "id": "00000000-0000-0000-0000-000000002508",
        "inserted_datetime": "2026-08-19T13:19:35.971182Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000025e6",
          "name": "Admin 2661"
        }
      },
      "packaged_date": "2024-07-01",
      "primary_test_result": null,
      "product_id": "3bbf8142-febd-47ff-bc53-b8f1383d4a0d",
      "product_unit_quantity": "7.500000000",
      "product_unit_type": {
        "id": "00000000-0000-0000-0000-000000015e52",
        "name": "3"
      },
      "quantity": "5.000000000",
      "quantity_active": "5.000000000",
      "quantity_assembling": "0.000000000",
      "quantity_available": "5.000000000",
      "status": "active",
      "unit_type": {
        "id": "00000000-0000-0000-0000-000000015e53",
        "name": "2"
      }
    },
    {
      "batch_number": null,
      "biotrack_id": null,
      "biotrack_inventory_type_id": null,
      "biotrack_net_quantity_per_unit": null,
      "biotrack_room_id": null,
      "biotrack_status": null,
      "biotrack_usable_weight": null,
      "compliance_label": "ABCDEF012345670000000198",
      "compliance_product_name": "Buds",
      "compliance_strain_name": "Cotton Candy",
      "compliance_transferred_datetime": null,
      "compliance_type": "METRC",
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-2574@example.com",
        "full_name": "FirstName5220 LastName5221",
        "id": "00000000-0000-0000-0000-000000002513",
        "inserted_datetime": "2026-08-19T13:19:36.049007Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000025f0",
          "name": "Admin 2671"
        }
      },
      "custom_data": [
        {
          "id": 222,
          "name": "Custom Field 43",
          "value": null
        }
      ],
      "description": null,
      "expiration_date": null,
      "expiration_datetime": null,
      "finished_datetime": null,
      "harvest_date": null,
      "id": "00000000-0000-0000-0000-000000000162",
      "inactivated_datetime": null,
      "inserted_datetime": "2026-08-19T13:19:36.063376Z",
      "is_production_batch": false,
      "is_test_sample": false,
      "is_trade_sample": false,
      "lab_testing_state": "NotSubmitted",
      "license": {
        "active": true,
        "expiry_datetime": "2026-09-19T13:19:35.960067Z",
        "id": "00000000-0000-0000-0000-000000000233",
        "inserted_datetime": "2026-08-19T13:19:35.960128Z",
        "issue_datetime": "2026-08-19T13:19:35.960066Z",
        "license_number": "CDPH-00000123",
        "license_type": "Specialty Cottage Indoor"
      },
      "location": {
        "id": "00000000-0000-0000-0000-000000000897",
        "name": "Place 531"
      },
      "metrc_archived_date": null,
      "metrc_finished_date": null,
      "metrc_id": 198,
      "metrc_label": "ABCDEF012345670000000198",
      "metrc_production_batch_number": null,
      "metrc_received_datetime": null,
      "metrc_received_from_manifest_number": null,
      "metrc_source_harvest_names": null,
      "metrc_status": "ACTIVE",
      "metrc_transfer_id": null,
      "metrc_unit_name": "Ounces",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-2563@example.com",
        "full_name": "FirstName5198 LastName5199",
        "id": "00000000-0000-0000-0000-000000002508",
        "inserted_datetime": "2026-08-19T13:19:35.971182Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000025e6",
          "name": "Admin 2661"
        }
      },
      "packaged_date": null,
      "primary_test_result": {
        "cbd_mg_per_unit": "1",
        "cbd_mg_per_unit_total": "2",
        "cbd_percentage": "3",
        "cbd_percentage_total": "4",
        "coa_url": null,
        "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": "3bbf8142-febd-47ff-bc53-b8f1383d4a0d",
      "product_unit_quantity": "15.000000000",
      "product_unit_type": {
        "id": "00000000-0000-0000-0000-000000015e52",
        "name": "3"
      },
      "quantity": "20.000000000",
      "quantity_active": "20.000000000",
      "quantity_assembling": "0.000000000",
      "quantity_available": "20.000000000",
      "status": "active",
      "unit_type": {
        "id": "00000000-0000-0000-0000-000000015e54",
        "name": "4"
      }
    }
  ],
  "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.

Required permission: products_permissions_view. Results are filtered to only include packages the authenticated user can access under their team restrictions.

Request

GET /public/v1/packages

Parameters

Parameter Description In Type Required Default Example
ids Filter packages by package ID (same UUID string as each package's id in responses). Values that do not decode to an internal package id match no rows. query array false ?ids[]=00000000-0000-0000-0000-000000000001&ids[]=00000000-0000-0000-0000-000000000002
inserted_datetime Filter packages by their creation datetime query string false 2022-07-10T00:00:00Z,
license_number Filter packages by license number query string false 1234567890
location_ids A list of location UUIDs to filter packages by. query array false ?location_ids[]=c40e87ce-0647-409b-89fa-620275d77fcc&location_ids[]=65ca530a-1ea2-439b-b4c2-598abb1fc6f3
page Pagination information query number false ?page[number]=1
product_ids Filter packages by product ID query array false ?product_ids[]=c40e87ce-0647-409b-89fa-620275d77fcc&product_ids[]=65ca530a-1ea2-439b-b4c2-598abb1fc6f3
statuses Filter packages by their status query array false ?statuses[]=active&statuses[]=selling&statuses[]=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

Update a package

POST /public/v1/packages/:id updates the Distru-tracked fields and returns the full package

POST /public/v1/packages/00000000-0000-0000-0000-000000000122
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzIsImlhdCI6MTc4NzE0NTU3MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzM1ZjRmMmUtNzRlZi00ZGJhLTg3ZDItNzVkMDY0NGE1OTljIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODQ0OSIsInR5cCI6ImFjY2VzcyJ9.ScxVb02FPbMl5fCYMvh9-fQwTdgKOUOw0HiAlLFqlL8

{
  "batch_number": "NEW-BATCH-001",
  "custom_data": {
    "214": "Updated Value"
  },
  "description": "Updated description",
  "expiration_datetime": "2025-02-02T03:04:05.000000Z",
  "harvest_date": "2025-03-03"
}

Response

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

{
  "data": {
    "batch_number": "NEW-BATCH-001",
    "biotrack_id": null,
    "biotrack_inventory_type_id": null,
    "biotrack_net_quantity_per_unit": null,
    "biotrack_room_id": null,
    "biotrack_status": null,
    "biotrack_usable_weight": null,
    "compliance_label": "ABCDEF012345670000000070",
    "compliance_product_name": "Buds",
    "compliance_strain_name": "Cotton Candy",
    "compliance_transferred_datetime": null,
    "compliance_type": "METRC",
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-1556@example.com",
      "full_name": "FirstName3176 LastName3177",
      "id": "00000000-0000-0000-0000-00000000210b",
      "inserted_datetime": "2026-08-19T13:19:32.041911Z",
      "role": {
        "id": "00000000-0000-0000-0000-0000000021e0",
        "name": "Admin 1631"
      }
    },
    "custom_data": [
      {
        "id": 214,
        "name": "Custom Field 35",
        "value": "Updated Value"
      }
    ],
    "description": "Updated description",
    "expiration_date": "2025-02-02T03:04:05.000000Z",
    "expiration_datetime": "2025-02-02T03:04:05.000000Z",
    "finished_datetime": null,
    "harvest_date": "2025-03-03",
    "id": "00000000-0000-0000-0000-000000000122",
    "inactivated_datetime": null,
    "inserted_datetime": "2026-08-19T13:19:32.056956Z",
    "is_production_batch": false,
    "is_test_sample": false,
    "is_trade_sample": false,
    "lab_testing_state": "NotSubmitted",
    "license": {
      "active": true,
      "expiry_datetime": "2026-09-19T13:19:32.008679Z",
      "id": "00000000-0000-0000-0000-0000000001ef",
      "inserted_datetime": "2026-08-19T13:19:32.008758Z",
      "issue_datetime": "2026-08-19T13:19:32.008678Z",
      "license_number": "CDPH-00000055",
      "license_type": "Specialty Indoor"
    },
    "location": {
      "id": "00000000-0000-0000-0000-0000000007a5",
      "name": "Place 289"
    },
    "metrc_archived_date": null,
    "metrc_finished_date": null,
    "metrc_id": 70,
    "metrc_label": "ABCDEF012345670000000070",
    "metrc_production_batch_number": null,
    "metrc_received_datetime": null,
    "metrc_received_from_manifest_number": null,
    "metrc_source_harvest_names": null,
    "metrc_status": "ACTIVE",
    "metrc_transfer_id": null,
    "metrc_unit_name": "Ounces",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-1549@example.com",
      "full_name": "FirstName3162 LastName3163",
      "id": "00000000-0000-0000-0000-000000002104",
      "inserted_datetime": "2026-08-19T13:19:32.017824Z",
      "role": {
        "id": "00000000-0000-0000-0000-0000000021d8",
        "name": "Admin 1623"
      }
    },
    "packaged_date": "2014-11-29",
    "primary_test_result": null,
    "product_id": "cb458154-1557-43ec-af98-2bc5b6664326",
    "product_unit_quantity": "141.747462720",
    "product_unit_type": {
      "id": "00000000-0000-0000-0000-000000013b0f",
      "name": "Gram"
    },
    "quantity": "5.000000000",
    "quantity_active": "5.000000000",
    "quantity_assembling": "0.000000000",
    "quantity_available": "5.000000000",
    "status": "active",
    "unit_type": {
      "id": "00000000-0000-0000-0000-000000013b11",
      "name": "Ounce"
    }
  }
}

Update the Distru-tracked fields of an existing package. Packages cannot be created through the API, only updated.

Supports sparse updates: only the fields included in the request are changed; omitted fields are left untouched.

Required permission: products_permissions_edit.

Request

POST /public/v1/packages/{id}

Parameters

Parameter Description In Type Required Default Example
batch_number The batch number of the package body string false
bin_ids The IDs of the bins this package is stored in. Behaviour: omit bin_ids to leave the package's bins unchanged; pass null or an empty array to clear all bins; pass a non-empty array to replace the package's bins with exactly those. Ignored unless bin inventory tracking is enabled for your company.
body array false
custom_data A map of custom field IDs to their values. Use GET /public/v1/custom-fields?parent_object=package to retrieve available custom fields, their IDs, and their types. The value format depends on the field's type: a text field takes a string, a date field takes a full ISO8601 datetime, and a checkbox field takes an array of its selected options. body object false {"101":"Some text value","102":"2026-08-18T00:00:00.000-07:00","103":["Option A","Option B"]}
description Free-form text describing the package body string false
expiration_datetime The expiration datetime of the package (ISO 8601 format) body string false
harvest_date The harvest date of the package (YYYY-MM-DD) body string false
id Package ID path string true

Responses

Status Description Schema
200 The updated package PackageFullResponse
400 Invalid parameters
404 Not Found

Payment

Get a payment

GET /public/v1/payments/:id returns a single payment

GET /public/v1/payments/00000000-0000-0000-0000-00000000004c
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzA3MWMwYmItYjE1OS00Yzc0LWEwYmEtZjIwZjJiMGQ0MmNlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzMzOSIsInR5cCI6ImFjY2VzcyJ9.SlKdWlIUKjZ_bHzBVwhrvk-CfPH3lt2yF3MuZB4IEXA

Response

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

{
  "data": {
    "amount": "10",
    "company": {
      "id": "00000000-0000-0000-0000-000000000d50",
      "name": "Company 384",
      "updated_datetime": "2026-08-19T13:19:27.959745Z"
    },
    "credit_uses": [
      {
        "amount": "30",
        "credit": {
          "amount": "100",
          "credit_number": "CRT-U",
          "id": "279c7387-5571-468e-9d12-bf848ec3b88d",
          "source": "USER"
        },
        "id": "56436c17-d339-4b25-9610-f45a48e86298"
      }
    ],
    "description": null,
    "fully_paid_with_credits": false,
    "id": "00000000-0000-0000-0000-00000000004c",
    "inserted_datetime": "2026-08-19T13:19:27.974503Z",
    "invoice": {
      "id": "00000000-0000-0000-0000-0000000000c0",
      "invoice_number": "Invoice #5",
      "status": "NOT_PAID",
      "total": "32.00"
    },
    "overpayment_credits": [
      {
        "amount": "20",
        "credit_number": "CRT-OP",
        "id": "2e1c918f-c528-437b-9c01-2b90c16a2524",
        "source": "INVOICE_PAYMENT"
      }
    ],
    "payment_date": "2026-08-19T13:19:27.973966Z",
    "payment_method": {
      "active": true,
      "deleted_at": null,
      "id": "00000000-0000-0000-0000-00000000006b",
      "inserted_datetime": "2026-08-19T13:19:27.972900Z",
      "name": "Payment Method 14",
      "qb_payment_method_id": null,
      "type": "CREDIT_CARD",
      "updated_datetime": "2026-08-19T13:19:27.972900Z"
    },
    "payment_number": "Payment #5",
    "payment_type": "INVOICE",
    "purchase": null,
    "quickbooks_deposit_account_id": null,
    "quickbooks_deposit_account_name": null,
    "status": "POSTED",
    "updated_datetime": "2026-08-19T13:19:27.974503Z"
  }
}

Get a single payment given the ID.

Required permission: payments_permissions_view.

Request

GET /public/v1/payments/{id}

Parameters

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

Responses

Status Description Schema
200 A single payment PaymentResponse
404 Not Found

Get payments

GET /public/v1/payments returns invoice and purchase payments related to the company

GET /public/v1/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMmM5YThkMjUtYmEwMS00MzY1LTlhMDctMjQwOWNhYTExMmRlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzQ3NSIsInR5cCI6ImFjY2VzcyJ9.AZrK3K1bZLhG9nPuWk3tg_5pJdLI1Kot0XLW2AvfCUs

Response

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

{
  "data": [
    {
      "amount": "75.25",
      "company": {
        "id": "00000000-0000-0000-0000-000000000d90",
        "name": "Company 474",
        "updated_datetime": "2026-08-19T13:19:28.465266Z"
      },
      "credit_uses": null,
      "description": "pur payment",
      "fully_paid_with_credits": false,
      "id": "00000000-0000-0000-0000-000000000059",
      "inserted_datetime": "2026-08-19T13:19:28.475742Z",
      "invoice": null,
      "overpayment_credits": null,
      "payment_date": "2026-08-19T13:19:28.475544Z",
      "payment_method": {
        "active": true,
        "deleted_at": null,
        "id": "00000000-0000-0000-0000-000000000079",
        "inserted_datetime": "2026-08-19T13:19:28.475175Z",
        "name": "Payment Method 28",
        "qb_payment_method_id": null,
        "type": "CREDIT_CARD",
        "updated_datetime": "2026-08-19T13:19:28.475175Z"
      },
      "payment_number": "Payment #18",
      "payment_type": "PURCHASE",
      "purchase": {
        "id": "00000000-0000-0000-0000-0000000000b9",
        "purchase_number": "Purchase #6",
        "status": "PENDING",
        "total": "32.00"
      },
      "quickbooks_deposit_account_id": null,
      "status": "POSTED",
      "updated_datetime": "2026-08-19T13:19:28.475742Z"
    },
    {
      "amount": "150.5",
      "company": {
        "id": "00000000-0000-0000-0000-000000000d8f",
        "name": "Company 472",
        "updated_datetime": "2026-08-19T13:19:28.440678Z"
      },
      "credit_uses": [
        {
          "amount": "30",
          "credit": {
            "amount": "100",
            "credit_number": "CRT-U",
            "id": "b052b52e-a37d-4d18-ac68-e101a1d36d5e",
            "source": "USER"
          },
          "id": "dccad88c-216d-4c24-880a-347d2e4e2124"
        }
      ],
      "description": "inv payment",
      "fully_paid_with_credits": false,
      "id": "00000000-0000-0000-0000-000000000058",
      "inserted_datetime": "2026-08-19T13:19:28.452858Z",
      "invoice": {
        "id": "00000000-0000-0000-0000-0000000000cd",
        "invoice_number": "Invoice #18",
        "status": "NOT_PAID",
        "total": "32.00"
      },
      "overpayment_credits": [
        {
          "amount": "20",
          "credit_number": "CRT-OP",
          "id": "dac2542f-9964-4f30-8084-c835b0293783",
          "source": "INVOICE_PAYMENT"
        }
      ],
      "payment_date": "2026-08-19T13:19:28.452281Z",
      "payment_method": {
        "active": true,
        "deleted_at": null,
        "id": "00000000-0000-0000-0000-000000000078",
        "inserted_datetime": "2026-08-19T13:19:28.451829Z",
        "name": "Payment Method 27",
        "qb_payment_method_id": null,
        "type": "CREDIT_CARD",
        "updated_datetime": "2026-08-19T13:19:28.451829Z"
      },
      "payment_number": "Payment #17",
      "payment_type": "INVOICE",
      "purchase": null,
      "quickbooks_deposit_account_id": null,
      "status": "POSTED",
      "updated_datetime": "2026-08-19T13:19:28.452858Z"
    }
  ],
  "next_page": null
}

Get payments sorted by their creation date and filtered by various attributes. A payment is either an invoice payment (money received from a customer) or a purchase payment (money paid to a vendor), distinguished by the payment_type field.

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

Required permission: payments_permissions_view.

Request

GET /public/v1/payments

Parameters

Parameter Description In Type Required Default Example
inserted_datetime Filter payments by their creation datetime query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1
payment_date Filter payments by their payment datetime query string false 2022-07-10T00:00:00Z,
payment_number Filter payments whose payment number contains this value query string false
payment_status Filter payments by their status. Defaults to returning both posted and voided payments. query string false
payment_type Filter payments by whether they belong to an invoice or a purchase query string false
updated_datetime Filter payments by the datetime they were most recently modified query string false ,2022-07-10T00:00:00Z

Responses

Status Description Schema
200 A list of payments Payments

PaymentMethod

Get a payment method

GET /public/v1/payment-methods/:id returns a single payment method

GET /public/v1/payment-methods/00000000-0000-0000-0000-000000000061
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMmNkZGNlMWYtNmVhMy00MWM1LWFkMWEtZjU1N2I0MjQ2ZTY5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzI4NyIsInR5cCI6ImFjY2VzcyJ9.eFXBtauUI-FKANrG6E9MaJjE9Hf_NcuQGv5u715r-8M

Response

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

{
  "data": {
    "active": true,
    "deleted_at": null,
    "id": "00000000-0000-0000-0000-000000000061",
    "inserted_datetime": "2026-08-19T13:19:27.755558Z",
    "name": "Cash",
    "qb_payment_method_id": null,
    "type": "CASH",
    "updated_datetime": "2026-08-19T13:19:27.755558Z"
  }
}

Get a single payment method given the ID.

Required permission: settings_permissions_payment_methods.

Request

GET /public/v1/payment-methods/{id}

Parameters

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

Responses

Status Description Schema
200 A single payment method PaymentMethodResponse
404 Not Found

Get payment methods

GET /public/v1/payment-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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMDNkZjQ3YmQtNDk2My00YTFjLWEwYjgtOGE0ZmZhMzUyYWQ0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzMzOCIsInR5cCI6ImFjY2VzcyJ9.PuQbRmlzWmsBp5vC7Tcf9QBmcPnCRx4YwJWT79rw7U8

Response

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

{
  "data": [
    {
      "active": true,
      "deleted_at": null,
      "id": "00000000-0000-0000-0000-000000000069",
      "inserted_datetime": "2026-08-19T13:19:27.966445Z",
      "name": "Payment Method 12",
      "qb_payment_method_id": null,
      "type": "CREDIT_CARD",
      "updated_datetime": "2026-08-19T13:19:27.966445Z"
    }
  ],
  "next_page": null
}

Get the payment methods configured for your company. A payment method is how money changes hands on a payment — for example Cash, Check, ACH, or Wire. Note: This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Required permission: settings_permissions_payment_methods.

Request

GET /public/v1/payment-methods

Parameters

Parameter Description In Type Required Default Example
deleted Filter deleted payment methods. no returns non-deleted, only returns deleted, include returns both. query string false no

Responses

Status Description Schema
200 A list of payment methods PaymentMethods

PaymentTerm

Get payment terms

GET /public/v1/payment-terms returns payment terms related to the user's company only

GET /public/v1/payment-terms
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGY2MWFhOGUtMTM3NS00MGEyLWJiY2EtZjQ1YTg1MWVlZWU2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzE2OSIsInR5cCI6ImFjY2VzcyJ9.6ghjZZkeMPXx1rB5T0_LTsiWul2Js4FbFzZzSE8HIMg

Response

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

{
  "data": [
    {
      "days": 30,
      "id": "00000000-0000-0000-0000-00000000001d",
      "inserted_datetime": "2026-08-19T13:19:27.209388Z",
      "locked": false,
      "name": "Net 30",
      "time_of_day": "17:00:00",
      "updated_datetime": "2026-08-19T13:19:27.209388Z"
    }
  ],
  "next_page": null
}

Get the payment terms configured for your company. A payment term is the agreed timeframe a customer has to pay an invoice — for example "Net 30" means payment is due 30 days after the invoice date. Note: This endpoint returns eventually consistent data, with changes taking up to 1 second to propagate in responses.

Required permission: settings_permissions_payment_terms.

Request

GET /public/v1/payment-terms

Responses

Status Description Schema
200 A list of payment terms PaymentTerms

Product

Get a product

GET /public/v1/products/:id returns a single product

GET /public/v1/products/d6974828-8947-4ae2-925b-8089d9b40792
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzQsImlhdCI6MTc4NzE0NTU3NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiODViYmE4ZGItZTY5Ny00MmJkLTg4Y2YtODhiNjU2MGJiNzY2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTczLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTEyNCIsInR5cCI6ImFjY2VzcyJ9.OxxBA4P_Xk1r05cpObIAwgdy3MFhnnKUUHqTweyJAAo

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 473498ff37a56776dfd297c8f37c3cc5-58c4d626a4dbbc6f-0

{
  "data": {
    "bill_of_materials": null,
    "brand": null,
    "category": {
      "id": "00000000-0000-0000-0000-000000000b26",
      "name": "Some category 525",
      "official_product_category_id": "OTHER"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-2215@example.com",
      "full_name": "FirstName4500 LastName4501",
      "id": "00000000-0000-0000-0000-0000000023a6",
      "inserted_datetime": "2026-08-19T13:19:34.558793Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000002486",
        "name": "Admin 2309"
      }
    },
    "custom_data": [],
    "deleted_at": null,
    "description": null,
    "description_markdown": null,
    "external_name": null,
    "gross_weight": null,
    "gross_weight_unit_type": null,
    "id": "d6974828-8947-4ae2-925b-8089d9b40792",
    "images": [
      {
        "id": "00000000-0000-0000-0000-00000000002b",
        "name": "Image Name 138",
        "rank": 0,
        "url": "https://google.com/original-8.jpg"
      }
    ],
    "inserted_datetime": "2026-08-19T13:19:34.565775Z",
    "inventory_tracking_method": "PRODUCT",
    "is_active": true,
    "is_featured": false,
    "leaflink_product_id": 777,
    "menu_visibility": "INCLUDE_IN_SELECT",
    "menus": [
      {
        "menu_id": "00000000-0000-0000-0000-0000000000bf",
        "menu_name": "Menu 1"
      }
    ],
    "msrp": null,
    "name": "Test Product",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-2215@example.com",
      "full_name": "FirstName4500 LastName4501",
      "id": "00000000-0000-0000-0000-0000000023a6",
      "inserted_datetime": "2026-08-19T13:19:34.558793Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000002486",
        "name": "Admin 2309"
      }
    },
    "product_group": {
      "id": "00000000-0000-0000-0000-000000000aec",
      "name": "Product Group 507"
    },
    "quantity_available_threshold_max": null,
    "quantity_available_threshold_min": null,
    "sku": "SKU001",
    "strain": null,
    "subcategory": {
      "id": "00000000-0000-0000-0000-000000000af5",
      "name": "Some subcategory 510"
    },
    "tags": [
      {
        "id": "00000000-0000-0000-0000-000000000047",
        "name": "Tag 1"
      }
    ],
    "total_cannabinoid_unit": null,
    "total_cbd": null,
    "total_thc": null,
    "treez_wholesale_price": "9.99",
    "unit_cost": null,
    "unit_net_weight": null,
    "unit_net_weight_serving_size_unit_type": null,
    "unit_price": "1",
    "unit_serving_size": null,
    "unit_type": {
      "id": "00000000-0000-0000-0000-000000014fbe",
      "name": "Gram"
    },
    "units_per_case": null,
    "upc": null,
    "updated_datetime": "2026-08-19T13:19:34.565775Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-000000001018",
      "name": "Company 1537",
      "updated_datetime": "2026-08-19T13:19:34.563475Z"
    },
    "wholesale_unit_price": null
  }
}

Get a single product given the ID. The response always includes the product's bill_of_materials (or null if it has none).

Required permission: products_permissions_view.

Request

GET /public/v1/products/{id}

Parameters

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

Responses

Status Description Schema
200 A single product ProductResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzQsImlhdCI6MTc4NzE0NTU3NCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiM2U3NDY3MjgtMDA0YS00OGY5LTg3MWMtOTRkNzI3MmE3NjMzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTczLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTIxNCIsInR5cCI6ImFjY2VzcyJ9.meGFFGUAopS4i6tDYZJmgGB7W7U35qlvn_TFy8gEA6Q

Response

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

{
  "data": [
    {
      "brand": {
        "id": "00000000-0000-0000-0000-00000000105a",
        "name": "Company 1616",
        "updated_datetime": "2030-11-01T00:00:00.000000Z"
      },
      "category": {
        "id": "00000000-0000-0000-0000-000000000b61",
        "name": "Some category 584",
        "official_product_category_id": "OTHER"
      },
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "product-owner@example.com",
        "full_name": "FirstName4708 LastName4709",
        "id": "00000000-0000-0000-0000-00000000240f",
        "inserted_datetime": "2026-08-19T13:19:34.875907Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000024f0",
          "name": "Admin 2415"
        }
      },
      "custom_data": [
        {
          "id": 220,
          "name": "Custom Field 41",
          "value": "Custom Field Value 1"
        }
      ],
      "deleted_at": null,
      "description": "test",
      "description_markdown": "# test",
      "external_name": "External Name",
      "gross_weight": null,
      "gross_weight_unit_type": null,
      "id": "2bf67f3b-4816-4e6d-8d3c-3faf6ff88ddc",
      "images": [
        {
          "id": "00000000-0000-0000-0000-00000000002c",
          "name": "Image Name 145",
          "rank": 0,
          "url": "https://google.com/original-9.jpg"
        },
        {
          "id": "00000000-0000-0000-0000-00000000002d",
          "name": "Image Name 146",
          "rank": 1,
          "url": "https://google.com/original-10.jpg"
        }
      ],
      "inserted_datetime": "2026-08-19T13:19:34.880277Z",
      "inventory_tracking_method": "BATCH",
      "is_active": true,
      "is_featured": true,
      "leaflink_product_id": 555,
      "menu_visibility": "INCLUDE_IN_ALL",
      "menus": [
        {
          "menu_id": "00000000-0000-0000-0000-0000000000c0",
          "menu_name": "Menu 1"
        }
      ],
      "msrp": null,
      "name": "Product 1608",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "product-owner@example.com",
        "full_name": "FirstName4708 LastName4709",
        "id": "00000000-0000-0000-0000-00000000240f",
        "inserted_datetime": "2026-08-19T13:19:34.875907Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000024f0",
          "name": "Admin 2415"
        }
      },
      "product_group": {
        "id": "00000000-0000-0000-0000-000000000b27",
        "name": "Product Group 566"
      },
      "quantity_available_threshold_max": "50",
      "quantity_available_threshold_min": "5",
      "sku": "sku 1609",
      "strain": {
        "id": "00000000-0000-0000-0000-00000000007c",
        "name": "Strain 35",
        "strain_type": "INDICA"
      },
      "subcategory": {
        "id": "00000000-0000-0000-0000-000000000b30",
        "name": "Some subcategory 569"
      },
      "tags": [
        {
          "id": "00000000-0000-0000-0000-000000000048",
          "name": "Tag 1"
        }
      ],
      "total_cannabinoid_unit": "PERCENT",
      "total_cbd": "3",
      "total_thc": "12",
      "treez_wholesale_price": "12.34",
      "unit_cost": null,
      "unit_net_weight": "20",
      "unit_net_weight_serving_size_unit_type": {
        "id": "00000000-0000-0000-0000-00000001538c",
        "name": "Ounce"
      },
      "unit_price": "1",
      "unit_serving_size": "10",
      "unit_type": {
        "id": "00000000-0000-0000-0000-00000001538a",
        "name": "Gram"
      },
      "units_per_case": null,
      "upc": "036000291452",
      "updated_datetime": "2023-11-01T00:00:00.000000Z",
      "vendor": {
        "id": "00000000-0000-0000-0000-00000000105f",
        "name": "Company 1622",
        "updated_datetime": "2030-11-03T00:00:00.000000Z"
      },
      "wholesale_unit_price": 90.5
    },
    {
      "brand": {
        "id": "00000000-0000-0000-0000-00000000105c",
        "name": "Company 1619",
        "updated_datetime": "2030-11-02T00:00:00.000000Z"
      },
      "category": {
        "id": "00000000-0000-0000-0000-000000000b65",
        "name": "Some category 588",
        "official_product_category_id": "OTHER"
      },
      "creator": null,
      "custom_data": [
        {
          "id": 220,
          "name": "Custom Field 41",
          "value": null
        }
      ],
      "deleted_at": null,
      "description": null,
      "description_markdown": null,
      "external_name": null,
      "gross_weight": null,
      "gross_weight_unit_type": null,
      "id": "55593b0b-fdc5-42e9-8c53-75febf31d98e",
      "images": [],
      "inserted_datetime": "2026-08-19T13:19:34.906550Z",
      "inventory_tracking_method": "PACKAGE",
      "is_active": false,
      "is_featured": false,
      "leaflink_product_id": null,
      "menu_visibility": "DO_NOT_INCLUDE",
      "menus": [],
      "msrp": "100",
      "name": "Product 1618",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "product-owner@example.com",
        "full_name": "FirstName4708 LastName4709",
        "id": "00000000-0000-0000-0000-00000000240f",
        "inserted_datetime": "2026-08-19T13:19:34.875907Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000024f0",
          "name": "Admin 2415"
        }
      },
      "product_group": {
        "id": "00000000-0000-0000-0000-000000000b2b",
        "name": "Product Group 570"
      },
      "quantity_available_threshold_max": null,
      "quantity_available_threshold_min": null,
      "sku": "sku 1619",
      "strain": null,
      "subcategory": {
        "id": "00000000-0000-0000-0000-000000000b34",
        "name": "Some subcategory 573"
      },
      "tags": [],
      "total_cannabinoid_unit": null,
      "total_cbd": null,
      "total_thc": null,
      "treez_wholesale_price": null,
      "unit_cost": null,
      "unit_net_weight": null,
      "unit_net_weight_serving_size_unit_type": null,
      "unit_price": "1",
      "unit_serving_size": null,
      "unit_type": {
        "id": "00000000-0000-0000-0000-000000015388",
        "name": "Pound"
      },
      "units_per_case": null,
      "upc": null,
      "updated_datetime": "2023-11-02T00:00:00.000000Z",
      "vendor": {
        "id": "00000000-0000-0000-0000-000000001061",
        "name": "Company 1624",
        "updated_datetime": "2030-11-04T00:00:00.000000Z"
      },
      "wholesale_unit_price": null
    }
  ],
  "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.

Required permission: products_permissions_view. Results are filtered to only include products the authenticated user can access under their team restrictions.

Request

GET /public/v1/products

Parameters

Parameter Description In Type Required Default Example
deleted Filter deleted products. no returns non-deleted, only returns deleted, include returns both. query string false no
ids Filter products by product ID (same UUID as each product's id in responses). query array false ?ids[]=550e8400-e29b-41d4-a716-446655440000&ids[]=6ba7b810-9dad-11d1-80b4-00c04fd430c8
include_bill_of_materials When true, each product includes its bill_of_materials (or null if it has none). Defaults to false. query boolean false false
inserted_datetime Filter products by their creation datetime query string false 2022-07-10T00:00:00Z,
menu_id Comma-separated public menu IDs; products in any of these menus are returned. Invalid tokens are ignored; if none remain, data is empty. query string false
menu_name Case-insensitive substring match on menu name. When combined with menu_id, both conditions apply (AND). query string false
page Pagination information query number false ?page[number]=1
product_name Filter products by name substring query string 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/products Updates a product with all optional fields set

POST /public/v1/products
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzMsImlhdCI6MTc4NzE0NTU3MywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYWM5ZmNkNTItY2M3My00MjMxLWJhNGMtM2U1NDRmYTM4Y2U5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcyLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODc2NyIsInR5cCI6ImFjY2VzcyJ9.ac1mWbUnpku9sXBr3O3prXb9tW-QmGY1U2If6gu4hHA

{
  "brand_id": "00000000-0000-0000-0000-000000000f7c",
  "category_id": "00000000-0000-0000-0000-000000000aa4",
  "description": "My Product Description",
  "external_name": "External Name",
  "gross_weight": "9.9",
  "gross_weight_unit_type_id": "00000000-0000-0000-0000-0000000144a0",
  "group_id": "00000000-0000-0000-0000-000000000a6b",
  "id": "b61383f3-92f4-4fc8-8b5c-482ed69c27ff",
  "inventory_tracking_method": "PACKAGE",
  "is_featured": true,
  "is_inactive": true,
  "menu_visibility": "INCLUDE_IN_ALL",
  "menus": [
    "00000000-0000-0000-0000-0000000000bb"
  ],
  "msrp": "100.5",
  "name": "Updated Name",
  "owner_id": "00000000-0000-0000-0000-000000002296",
  "quantity_available_threshold_max": "10.5",
  "quantity_available_threshold_min": "5.5",
  "sku": "45678",
  "strain_id": "00000000-0000-0000-0000-000000000079",
  "subcategory_id": "00000000-0000-0000-0000-000000000a74",
  "tags": [
    "00000000-0000-0000-0000-000000000044"
  ],
  "total_cannabinoid_unit": "PERCENT",
  "total_cbd": "5.2",
  "total_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-0000000144a2",
  "unit_price": "200",
  "unit_serving_size": "2.2",
  "unit_type_id": "00000000-0000-0000-0000-0000000144a9",
  "units_per_case": "0.2",
  "upc": "036000291453",
  "vendor_id": "00000000-0000-0000-0000-000000000f79",
  "wholesale_unit_price": "90.50"
}

Response

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

{
  "data": {
    "brand": {
      "id": "00000000-0000-0000-0000-000000000f7c",
      "name": "Company 1341",
      "updated_datetime": "2026-08-19T13:19:33.543412Z"
    },
    "category": {
      "id": "00000000-0000-0000-0000-000000000aa4",
      "name": "Some category 395",
      "official_product_category_id": "OTHER"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-1862@example.com",
      "full_name": "FirstName3790 LastName3791",
      "id": "00000000-0000-0000-0000-00000000223f",
      "inserted_datetime": "2026-08-19T13:19:33.359085Z",
      "role": {
        "id": "00000000-0000-0000-0000-00000000231e",
        "name": "Admin 1949"
      }
    },
    "custom_data": [],
    "deleted_at": null,
    "description": "My Product Description",
    "description_markdown": "My Product Description",
    "external_name": "External Name",
    "gross_weight": "9.9",
    "gross_weight_unit_type": {
      "id": "00000000-0000-0000-0000-0000000144a0",
      "name": "Gram"
    },
    "id": "b61383f3-92f4-4fc8-8b5c-482ed69c27ff",
    "images": [
      {
        "id": "00000000-0000-0000-0000-000000000029",
        "name": "Image Name 127",
        "rank": 0,
        "url": "https://google.com/original-6.jpg"
      },
      {
        "id": "00000000-0000-0000-0000-00000000002a",
        "name": "Image Name 129",
        "rank": 1,
        "url": "https://google.com/original-7.jpg"
      }
    ],
    "inserted_datetime": "2026-08-19T13:19:33.387408Z",
    "inventory_tracking_method": "PACKAGE",
    "is_active": false,
    "is_featured": true,
    "leaflink_product_id": null,
    "menu_visibility": "INCLUDE_IN_ALL",
    "menus": [
      {
        "menu_id": "00000000-0000-0000-0000-0000000000bb",
        "menu_name": "Menu 170"
      }
    ],
    "msrp": "100.5",
    "name": "Updated Name",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "user2@a.com",
      "full_name": "FirstName3964 LastName3965",
      "id": "00000000-0000-0000-0000-000000002296",
      "inserted_datetime": "2026-08-19T13:19:33.558337Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000002377",
        "name": "Admin 2038"
      }
    },
    "product_group": {
      "id": "00000000-0000-0000-0000-000000000a6b",
      "name": "Product Group 378"
    },
    "quantity_available_threshold_max": "10.5",
    "quantity_available_threshold_min": "5.5",
    "sku": "45678",
    "strain": {
      "id": "00000000-0000-0000-0000-000000000079",
      "name": "Strain 32",
      "strain_type": null
    },
    "subcategory": {
      "id": "00000000-0000-0000-0000-000000000a74",
      "name": "Some subcategory 381"
    },
    "tags": [
      {
        "id": "00000000-0000-0000-0000-000000000044",
        "name": "Some tag 17"
      }
    ],
    "total_cannabinoid_unit": "PERCENT",
    "total_cbd": "5.2",
    "total_thc": "10.4",
    "treez_wholesale_price": null,
    "unit_cost": "50.4",
    "unit_net_weight": "3.1",
    "unit_net_weight_serving_size_unit_type": {
      "id": "00000000-0000-0000-0000-0000000144a2",
      "name": "Ounce"
    },
    "unit_price": "200",
    "unit_serving_size": "2.2",
    "unit_type": {
      "id": "00000000-0000-0000-0000-0000000144a9",
      "name": "Unit"
    },
    "units_per_case": "0.2",
    "upc": "036000291453",
    "updated_datetime": "2026-08-19T13:19:33.579031Z",
    "vendor": {
      "id": "00000000-0000-0000-0000-000000000f79",
      "name": "Company 1335",
      "updated_datetime": "2026-08-19T13:19:33.520356Z"
    },
    "wholesale_unit_price": 90.5
  }
}

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. Required permission: products_permissions_create to create a new product, products_permissions_edit (and access to the product under team restrictions) to update an existing product.

Request

POST /public/v1/products

Parameters

Parameter Description In Type Required Default Example
brand_id The ID of the company_relationship association with the brand (company) that is associated with this product. body string false
category_id The ID of the product category of the product. body string false
custom_data A map of custom field IDs to their values. Use GET /public/v1/custom-fields?parent_object=product to retrieve available custom fields, their IDs, and their types. The value format depends on the field's type: a text field takes a string, a date field takes a full ISO8601 datetime, and a checkbox field takes an array of its selected options. body object false {"101":"Some text value","102":"2026-08-18T00:00:00.000-07:00","103":["Option A","Option B"]}
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. body 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. body string false A pack of 5 pre-rolls
external_name Customer-facing name for DistruCommerce menus and Order Tracker. Defaults to Product Name if left blank body string false
gross_weight The gross weight of the product. Must be set together with gross_weight_unit_type_id. body number false
gross_weight_unit_type_id The ID of the weight unit type the gross weight is measured in. Must be a weight-based unit type supported by Metrc, and set together with gross_weight. body string false
group_id The ID of the product's group. body string false
id Unique ID for this product. Omit it to create a new product — Distru assigns the ID. Provide an existing product's ID to update that product; an ID that doesn't exist returns a not-found error. body 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. body string false PACKAGE
is_featured Whether the product is featured. Featured products will be displayed at the top of menus. body boolean false
is_inactive Whether the product is inactive from use. Inactive products can be set to active at any time. body boolean 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). body string false
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. body array false ["0ef8347c-b714-4cd9-ba0e-872488bc9244", "daa0294c-833c-42bd-a133-b4c9e7f64017"]
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 body number false
name Name of the product body string false King Size Pre-rolls
owner_id The ID of the user that is deemed to be the owner of the product. body string 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. body number 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. body number false
sku Stock Keeping Unit (SKU) for this product body string false SKU123
strain_id The ID of the strain associated with the product. body string false
subcategory_id The ID of the product subcategory of the product. The provided subcategory must be a child of the provided category. body string false
tags A list of tags associated with the product. body array false ["0ef8347c-b714-4cd9-ba0e-872488bc9244", "daa0294c-833c-42bd-a133-b4c9e7f64017"]
total_cannabinoid_unit The unit of the THC/CBD content of the product (MG or PERCENT). body string false
total_cbd The CBD content of the product in the unit specified by total_cannabinoid_unit. Must also include total_cannabinoid_unit. body string false
total_thc The THC content of the product in the unit specified by total_cannabinoid_unit. Must also include total_cannabinoid_unit. body string false
unit_cost The cost of the product per unit. body number false
unit_net_weight The net weight of the product per unit. body 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. body string false
unit_price The sale price of the product per unit. body number false
unit_serving_size The serving size of the product per unit. body number false
unit_type_id The ID of the unit type the product. body string false
units_per_case The number of units in a case of the product. body number false
upc Universal Product Code (UPC) for this product body string false 123456789012
vendor_id The ID of the company_relationship association with the vendor (company) that supplies this product. body string false
wholesale_unit_price The wholesale price of the product per unit. body number false

Responses

Status Description Schema
200 A single product ProductResponse

ProductCategory

Delete a product category

DELETE /public/v1/product-categories/:id soft-deletes a product category

DELETE /public/v1/product-categories/00000000-0000-0000-0000-000000000942
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGIxOTNjZTEtZjlkMC00OGMxLTgzMDYtYzYyMDI3MDVkZTdhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzE5MCIsInR5cCI6ImFjY2VzcyJ9.sQZzEe7mISEl2qbXKZV6HXL1g7mL8ZND4zPEMb0I4b8

Response

204
cache-control: max-age=0, private, must-revalidate
b3: e2afb95793c715141be030c718a94858-b894dd274f1dae9a-0

Deletes the product category. This is a soft delete: the record's deleted_at is set and it is no longer returned by the API, but it is retained in the database.

Required permission: settings_permissions_product_categories.

Request

DELETE /public/v1/product-categories/{id}

Parameters

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

Responses

Status Description Schema
204 No Content
404 Not Found

Get a product category

GET /public/v1/product-categories/:id returns a single product category with embedded subcategories

GET /public/v1/product-categories/00000000-0000-0000-0000-000000000953
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDdkZGQzN2YtOTA5Ny00NDcwLWE1N2YtZGI5MGQ1ODIxZmZiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzI2NiIsInR5cCI6ImFjY2VzcyJ9.jGLVUpIZXhO13FJkD-BbzCQwSt9WQ4E4kFYwPZjDrT8

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000953",
    "inserted_datetime": "2026-08-19T13:19:27.581503Z",
    "name": "Edibles",
    "official_product_category_id": "OPC_5",
    "subcategories": [
      {
        "id": "00000000-0000-0000-0000-00000000092d",
        "name": "Gummies"
      }
    ],
    "updated_datetime": "2026-08-19T13:19:27.581503Z"
  }
}

Get a single product category given the ID.

Required permission: settings_permissions_product_categories.

Request

GET /public/v1/product-categories/{id}

Parameters

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

Responses

Status Description Schema
200 A single product category ProductCategoryResponse
404 Not Found

Get product categories

GET /public/v1/product-categories returns paginated product categories with embedded subcategories

GET /public/v1/product-categories
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDM5NTgzYzgtMTU4YS00MjcxLTg3YzEtZTI1N2E3YTdkNjVjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzI3NSIsInR5cCI6ImFjY2VzcyJ9.NRdGVndzS4eecR_i90Q_BSfwkGC67zjAbDRsbf34Ld0

Response

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

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000954",
      "inserted_datetime": "2025-01-01T00:00:00.000000Z",
      "name": "PC1",
      "official_product_category_id": "OPC_7",
      "subcategories": [
        {
          "id": "00000000-0000-0000-0000-00000000092e",
          "name": "SC1"
        }
      ],
      "updated_datetime": "2026-08-19T13:19:27.668331Z"
    },
    {
      "id": "00000000-0000-0000-0000-000000000955",
      "inserted_datetime": "2025-01-02T00:00:00.000000Z",
      "name": "PC2",
      "official_product_category_id": "OPC_7",
      "subcategories": [],
      "updated_datetime": "2026-08-19T13:19:27.668910Z"
    },
    {
      "id": "00000000-0000-0000-0000-000000000956",
      "inserted_datetime": "2025-01-03T00:00:00.000000Z",
      "name": "PC3",
      "official_product_category_id": "OPC_7",
      "subcategories": [],
      "updated_datetime": "2026-08-19T13:19:27.669505Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/product-categories?page[number]=2"
}

List product categories for the authenticated company.

Required permission: settings_permissions_product_categories.

Request

GET /public/v1/product-categories

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of product categories ProductCategories

Upsert a product category

POST /public/v1/product-categories (update) updates a product category

POST /public/v1/product-categories
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZTFiYTU4NjItNmRhYi00YmNiLTk0MzYtOGE5YTFmMTY1ZTdkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzIzOCIsInR5cCI6ImFjY2VzcyJ9.ZV29G9hRvNHQWuwfY18bK4MufrLlppFl5RWYZ7RkJuQ

{
  "id": "00000000-0000-0000-0000-00000000094b",
  "name": "New"
}

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-00000000094b",
    "inserted_datetime": "2026-08-19T13:19:27.499400Z",
    "name": "New",
    "official_product_category_id": "OTHER",
    "subcategories": [
      {
        "id": "00000000-0000-0000-0000-000000000927",
        "name": "Gummies"
      }
    ],
    "updated_datetime": "2026-08-19T13:19:27.511766Z"
  }
}

Upsert a single product category. To update an existing product category, pass its ID in the id field. If you do not pass an ID, a new product category is created. When creating, name and official_product_category_id are required. The official_product_category_id cannot be changed once set.

Required permission: settings_permissions_product_categories.

Request

POST /public/v1/product-categories

Parameters

Parameter Description In Type Required Default Example
id Product category ID. If given, the matching product category is updated; otherwise a new one is created. body string false
name The name of the product category body string true
official_product_category_id ID of the official product category this maps to. Official categories are Distru's standard, system-defined category list; use GET /public/v1/official-product-categories to find IDs. body string true

Responses

Status Description Schema
200 The updated product category ProductCategoryResponse
201 The created product category ProductCategoryResponse
400 Invalid parameters
404 Not Found

ProductGroup

Delete a product group

DELETE /public/v1/product-groups/:id deletes a product group

DELETE /public/v1/product-groups/00000000-0000-0000-0000-000000000939
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiY2I2MzkyNTItYTU1Yy00MmE0LWI4YzgtMGQyMGI2NGM2YzA4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzUyNSIsInR5cCI6ImFjY2VzcyJ9.sOgWUmS6VHDHs0bSPz1MnJhpwoa2QST6citETOzasG0

Response

204
cache-control: max-age=0, private, must-revalidate
b3: c99ae18da76c63e3e7368e6cc33952c8-3004573415ed7356-0

Permanently deletes the product group. This is a hard delete: the record is removed from the database and cannot be recovered.

Required permission: settings_permissions_product_groups.

Request

DELETE /public/v1/product-groups/{id}

Parameters

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

Responses

Status Description Schema
204 No Content
404 Not Found

Get a product group

GET /public/v1/product-groups/:id returns a single product group

GET /public/v1/product-groups/00000000-0000-0000-0000-00000000094a
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTVkNzFhYTktZTg0My00OTM3LWI5OWEtMTZhYTI3M2IxNjA5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzU5MSIsInR5cCI6ImFjY2VzcyJ9.HKUniysHs74b-FQsbtFB2kQ1IdjqHdIqYjjzivbEZ7E

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-00000000094a",
    "inserted_datetime": "2026-08-19T13:19:28.799488Z",
    "name": "Flower - Indoor",
    "updated_datetime": "2026-08-19T13:19:28.799488Z"
  }
}

Get a single product group given the ID.

Required permission: settings_permissions_product_groups.

Request

GET /public/v1/product-groups/{id}

Parameters

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

Responses

Status Description Schema
200 A single product group ProductGroupResponse
404 Not Found

Get product groups

GET /public/v1/product-groups returns paginated product groups for the company with next_page

GET /public/v1/product-groups
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMmU5M2NmMjQtMWI3Mi00ZDc1LWFhYTItYzY2N2Q0ZmNjNDdhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzU5OCIsInR5cCI6ImFjY2VzcyJ9.2-m0H7SnBywAfKxLdh-WXWJ07gYeKCSDnahtLVWcEKo

Response

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

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-00000000094c",
      "inserted_datetime": "2026-08-19T13:19:28.830283Z",
      "name": "PG1",
      "updated_datetime": "2026-08-19T13:19:28.830283Z"
    },
    {
      "id": "00000000-0000-0000-0000-00000000094d",
      "inserted_datetime": "2026-08-19T13:19:28.830497Z",
      "name": "PG2",
      "updated_datetime": "2026-08-19T13:19:28.830497Z"
    },
    {
      "id": "00000000-0000-0000-0000-00000000094e",
      "inserted_datetime": "2026-08-19T13:19:28.830695Z",
      "name": "PG3",
      "updated_datetime": "2026-08-19T13:19:28.830695Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/product-groups?page[number]=2"
}

List product groups for the authenticated company.

Required permission: settings_permissions_product_groups.

Request

GET /public/v1/product-groups

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of product groups ProductGroups

Upsert a product group

POST /public/v1/product-groups creates a product group

POST /public/v1/product-groups
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzIwMTY4MWUtMDdkZC00NzZmLTlkYjMtY2FkZTM3YmMwZjYzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzU0NCIsInR5cCI6ImFjY2VzcyJ9.9NTk-yIfvYNNQ9NTCIy2oiYH57dHupuwNByBPIWyDmA

{
  "name": "Flower - Indoor"
}

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-00000000093f",
    "inserted_datetime": "2026-08-19T13:19:28.658702Z",
    "name": "Flower - Indoor",
    "updated_datetime": "2026-08-19T13:19:28.658702Z"
  }
}

Upsert a single product group. To update an existing product group, pass its ID in the id field. If you do not pass an ID, a new product group is created.

Required permission: settings_permissions_product_groups.

Request

POST /public/v1/product-groups

Parameters

Parameter Description In Type Required Default Example
id Product group ID. If given, the matching product group is updated; otherwise a new one is created. body string false
name The name of the product group body string true

Responses

Status Description Schema
200 The updated product group ProductGroupResponse
201 The created product group ProductGroupResponse
400 Invalid parameters
404 Not Found

ProductPosMapping

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiN2IxNjE1N2YtOGZjYi00NTliLWEzZjgtNDg2MDZhYzlkNzU0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzEwNCIsInR5cCI6ImFjY2VzcyJ9.BMQBptJZzJhL5gaKip7NqwNWlrhbgOs6DMSJO7OBleo

{
  "blaze_product_id": "blaze_123",
  "blaze_retailer_id": "ad3cd4b1-aa62-4cfa-8ff8-963c973c6dcf",
  "product_id": "0e88a990-127a-4127-a84b-85fa4c60b0de"
}

Response

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

{
  "data": {
    "blaze_asset_id": null,
    "blaze_product_id": "blaze_123",
    "blaze_retailer_id": "ad3cd4b1-aa62-4cfa-8ff8-963c973c6dcf",
    "id": "00000000-0000-0000-0000-00000000001c",
    "inserted_datetime": "2026-08-19T13:19:27.040827Z",
    "pos_type": "BLAZE",
    "product_id": "0e88a990-127a-4127-a84b-85fa4c60b0de",
    "updated_datetime": "2026-08-19T13:19:27.040827Z"
  }
}

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.

Required permission: products_permissions_edit.

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

Delete a product POS mapping

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

DELETE /public/v1/product-pos-mappings/00000000-0000-0000-0000-00000000001b
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOGJjNGRhZmUtMTNkOS00M2VmLTk5NDUtOTkyM2JiZGMzMWRmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzA1MyIsInR5cCI6ImFjY2VzcyJ9.OQGYqaUVL5l1uzAKEXo74FOu0z368Mgywn74MYJIoPU

Response

204
cache-control: max-age=0, private, must-revalidate
b3: 6f879634f418fad3a74e370fa3420ca7-940e1cd375132cfe-0

Required permission: products_permissions_edit.

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

Get a product POS mapping

GET /public/v1/product-pos-mappings/:id returns a single product POS mapping

GET /public/v1/product-pos-mappings/00000000-0000-0000-0000-000000000023
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMWYzZDhlNzEtZmE0OC00Y2U0LWE1YzUtNmY2YTI4YWM1OWFmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzI2MiIsInR5cCI6ImFjY2VzcyJ9.dvdIIaFeNwKLMZxEUWwMzcqBE43X0NIoN5Z_6ZeRLbs

Response

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

{
  "data": {
    "blaze_asset_id": null,
    "blaze_product_id": "blaze_123",
    "blaze_retailer_id": "509ef1d5-7ba6-4b4b-85d4-de0511c410ca",
    "id": "00000000-0000-0000-0000-000000000023",
    "inserted_datetime": "2026-08-19T13:19:27.585825Z",
    "pos_type": "BLAZE",
    "product_id": "acf17934-06c1-44da-9a43-bd5b7571068d",
    "updated_datetime": "2026-08-19T13:19:27.585825Z"
  }
}

Get a single product POS mapping given the ID.

Required permission: products_permissions_view.

Request

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

Parameters

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

Responses

Status Description Schema
200 A single product POS mapping ProductPosMappingResponse
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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDk5MmY3NzktNTM1Yi00YmRkLWExY2ItYzdhY2UzZTczYjNmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzI4OSIsInR5cCI6ImFjY2VzcyJ9.qB4MjT1qq510v3vMXyturcqjWF7bGc1vlT_DB4BgRc8

Response

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

{
  "data": [
    {
      "blaze_asset_id": null,
      "blaze_product_id": "blaze_123",
      "blaze_retailer_id": "26907596-286a-4756-8ca4-f6b81c782f41",
      "id": "00000000-0000-0000-0000-000000000025",
      "inserted_datetime": "2026-08-19T13:19:27.794004Z",
      "pos_type": "BLAZE",
      "product_id": "e175f916-2b88-46a1-bbf6-90f5e3978c6b",
      "updated_datetime": "2026-08-19T13:19:27.794004Z"
    },
    {
      "dutchie_product_id": 456,
      "dutchie_retailer_id": "cc621b58-5d0e-41bf-acf5-94fafee410a9",
      "id": "00000000-0000-0000-0000-000000000026",
      "inserted_datetime": "2026-08-19T13:19:27.803944Z",
      "pos_type": "DUTCHIE",
      "product_id": "a40400d8-431f-4677-be57-640a2bf829cb",
      "updated_datetime": "2026-08-19T13:19:27.803944Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/product-pos-mappings?page[number]=2"
}

List the links between your Distru products and their matching products in external point-of-sale (POS) systems, optionally filtered by product or by a specific retailer. Required permission: products_permissions_view.

Request

GET /public/v1/product-pos-mappings

Parameters

Parameter Description In Type Required Default Example
blaze_retailer_id Filter by Blaze retailer ID query string false
dutchie_retailer_id Filter by Dutchie retailer ID query string false
product_id Filter by product 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

ProductSubcategory

Delete a product subcategory

DELETE /public/v1/product-subcategories/:id deletes the subcategory while leaving its siblings intact

DELETE /public/v1/product-subcategories/00000000-0000-0000-0000-00000000090b
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNmQ5NDY0ZDEtMzc4OC00NjM0LTg0NTMtMGM3MGM4NjJlNjBjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzA4MSIsInR5cCI6ImFjY2VzcyJ9.Bod7m0BtfmxS0BTpob14qV5t_8gAnBrrj_7DVpIJH_8

Response

204
cache-control: max-age=0, private, must-revalidate
b3: 6f30a3a8c8aa497cfdcd7eca8959f15c-a0e3db47eacf901a-0

Permanently deletes the product subcategory. Unlike product categories, subcategories are hard deleted: the record is removed from the database and cannot be recovered.

Required permission: settings_permissions_product_categories.

Request

DELETE /public/v1/product-subcategories/{id}

Parameters

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

Responses

Status Description Schema
204 No Content
404 Not Found

Get a product subcategory

GET /public/v1/product-subcategories/:id returns a single subcategory with embedded compact category

GET /public/v1/product-subcategories/00000000-0000-0000-0000-00000000090f
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjEyMDBmNWEtNGU5MC00OGRjLTliYmEtMGZiN2VkNGFlMTZjIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzEwMiIsInR5cCI6ImFjY2VzcyJ9._3DKzfdNZvtOxOo9CLKxBT0RYKZsKGkgUqN_zxtUKhg

Response

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

{
  "data": {
    "category": {
      "id": "00000000-0000-0000-0000-000000000931",
      "name": "Edibles",
      "official_product_category_id": "OPC_1"
    },
    "id": "00000000-0000-0000-0000-00000000090f",
    "inserted_datetime": "2026-08-19T13:19:27.007435Z",
    "name": "Gummies",
    "updated_datetime": "2026-08-19T13:19:27.007435Z"
  }
}

Get a single product subcategory given the ID.

Required permission: settings_permissions_product_categories.

Request

GET /public/v1/product-subcategories/{id}

Parameters

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

Responses

Status Description Schema
200 A single product subcategory ProductSubcategoryResponse
404 Not Found

Get product subcategories

GET /public/v1/product-subcategories returns paginated subcategories for the company with next_page and category filter

GET /public/v1/product-subcategories
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiODY3MmY0YTQtNmJhNC00MTE4LWFmZmItODYzMDlhNjFhYTc0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzEyMCIsInR5cCI6ImFjY2VzcyJ9.zj7_Ltj9qMtlDlRB97l0NXNkQ1TUL_OqV4E_zeF4t5E

Response

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

{
  "data": [
    {
      "category": {
        "id": "00000000-0000-0000-0000-000000000936",
        "name": "C1",
        "official_product_category_id": "OPC_2"
      },
      "id": "00000000-0000-0000-0000-000000000914",
      "inserted_datetime": "2025-01-01T00:00:00.000000Z",
      "name": "SC1",
      "updated_datetime": "2026-08-19T13:19:27.068981Z"
    },
    {
      "category": {
        "id": "00000000-0000-0000-0000-000000000936",
        "name": "C1",
        "official_product_category_id": "OPC_2"
      },
      "id": "00000000-0000-0000-0000-000000000916",
      "inserted_datetime": "2025-01-02T00:00:00.000000Z",
      "name": "SC2",
      "updated_datetime": "2026-08-19T13:19:27.077208Z"
    },
    {
      "category": {
        "id": "00000000-0000-0000-0000-000000000936",
        "name": "C1",
        "official_product_category_id": "OPC_2"
      },
      "id": "00000000-0000-0000-0000-000000000917",
      "inserted_datetime": "2025-01-03T00:00:00.000000Z",
      "name": "SC3",
      "updated_datetime": "2026-08-19T13:19:27.086627Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/product-subcategories?page[number]=2"
}

List product subcategories for the authenticated company.

Optionally filter by parent category with ?category_id=.

Required permission: settings_permissions_product_categories.

Request

GET /public/v1/product-subcategories

Parameters

Parameter Description In Type Required Default Example
category_id Only return subcategories belonging to this product category ID query string false
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of product subcategories ProductSubcategories

Upsert a product subcategory

POST /public/v1/product-subcategories creates a subcategory and returns the embedded compact category

POST /public/v1/product-subcategories
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGQzOGVjZTUtZjZiMi00ODFiLWI3NDYtMGY2ZDNkZDU5OTUwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzA0OSIsInR5cCI6ImFjY2VzcyJ9.E2EnUzf8laeF624Cpy-94Wbcvi2ilWXm-axtuDrH1eQ

{
  "name": "Gummies",
  "product_category_id": "00000000-0000-0000-0000-000000000928"
}

Response

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

{
  "data": {
    "category": {
      "id": "00000000-0000-0000-0000-000000000928",
      "name": "Edibles",
      "official_product_category_id": "OPC_0"
    },
    "id": "00000000-0000-0000-0000-000000000906",
    "inserted_datetime": "2026-08-19T13:19:26.699436Z",
    "name": "Gummies",
    "updated_datetime": "2026-08-19T13:19:26.699436Z"
  }
}

Upsert a single product subcategory. To update an existing product subcategory, pass its ID in the id field. If you do not pass an ID, a new product subcategory is created. When creating, name and product_category_id are required. The parent category cannot be changed once set.

Required permission: settings_permissions_product_categories.

Request

POST /public/v1/product-subcategories

Parameters

Parameter Description In Type Required Default Example
id Product subcategory ID. If given, the matching product subcategory is updated; otherwise a new one is created. body string false
name The name of the product subcategory body string true
product_category_id The ID of the product category this subcategory belongs to body string true

Responses

Status Description Schema
200 The updated product subcategory ProductSubcategoryResponse
201 The created product subcategory ProductSubcategoryResponse
400 Invalid parameters
404 Not Found

Purchase

Get a purchase

GET /public/v1/purchases/:id returns a single purchase with its active payments

GET /public/v1/purchases/00000000-0000-0000-0000-0000000000f0
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzcsImlhdCI6MTc4NzE0NTU3NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzdjODgwNGUtMjlkMS00NDYxLWI3ZWYtOGU2OGE2Yjk0ZDE5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTc3NSIsInR5cCI6ImFjY2VzcyJ9.QIgUPTaL8rEqjP7PQuopgev_tKMuTDko9PKSPmlhRTg

Response

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

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001c69",
      "id": "00000000-0000-0000-0000-0000000008fb",
      "license_id": null,
      "license_number": null,
      "name": "Place 631"
    },
    "biotrack_id": null,
    "charges": [
      {
        "id": "540248e6-d9cf-4405-a2d9-67e70c7e3c65",
        "inserted_datetime": "2026-08-19T13:19:37.864986Z",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "tax": {
          "id": "00000000-0000-0000-0000-00000000002f",
          "name": "T1"
        },
        "type": "CHARGE",
        "unit_type": "PERCENT"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-0000000011b0",
      "name": "Company 2067",
      "updated_datetime": "2026-08-19T13:19:37.772430Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-2862@example.com",
      "full_name": "FirstName5796 LastName5797",
      "id": "00000000-0000-0000-0000-000000002638",
      "inserted_datetime": "2026-08-19T13:19:37.805707Z",
      "role": {
        "id": "00000000-0000-0000-0000-00000000270a",
        "name": "Admin 2953"
      }
    },
    "custom_data": [
      {
        "id": 224,
        "name": "Custom Field 45",
        "value": "Custom Field Value 1"
      }
    ],
    "description": null,
    "due_datetime": "2026-08-19T13:19:37.808254Z",
    "id": "00000000-0000-0000-0000-0000000000f0",
    "inserted_datetime": "2026-08-19T13:19:37.808981Z",
    "items": [
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000b80",
          "name": "B2381"
        },
        "compliance_quantity": null,
        "id": "00f248b8-1232-4a2b-b8c7-e6d77d91b96b",
        "is_sample": false,
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 90210, US",
          "company_id": "00000000-0000-0000-0000-000000001c69",
          "id": "00000000-0000-0000-0000-0000000008f9",
          "license_id": null,
          "name": "Place 629"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "f542c621-e966-446a-8e54-0a927c56027e",
          "name": "Product 2373",
          "sku": "sku 2374",
          "updated_datetime": "2026-08-19T13:19:37.830031Z"
        },
        "quantity": "15.000000000",
        "received_quantity": "0.000000000"
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000b81",
          "name": "B2382"
        },
        "compliance_quantity": null,
        "id": "f04d9033-6b3e-4880-b6bc-4e4d401059e6",
        "is_sample": false,
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 90210, US",
          "company_id": "00000000-0000-0000-0000-000000001c69",
          "id": "00000000-0000-0000-0000-0000000008f9",
          "license_id": null,
          "name": "Place 629"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "2e2ffbd3-b96b-41bb-9821-7fbc372921b8",
          "name": "Product 2375",
          "sku": "sku 2376",
          "updated_datetime": "2026-08-19T13:19:37.836137Z"
        },
        "quantity": "10.000000000",
        "received_quantity": "0.000000000"
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000b82",
          "name": "B2383"
        },
        "compliance_quantity": null,
        "id": "2ebab000-8916-44f3-9b68-a41e020a409d",
        "is_sample": false,
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 90210, US",
          "company_id": "00000000-0000-0000-0000-000000001c69",
          "id": "00000000-0000-0000-0000-0000000008f9",
          "license_id": null,
          "name": "Place 629"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "9f2e24b1-fb7b-44f7-b7cd-71b62e420e6f",
          "name": "Product 2377",
          "sku": "sku 2378",
          "updated_datetime": "2026-08-19T13:19:37.841753Z"
        },
        "quantity": "5.000000000",
        "received_quantity": "0.000000000"
      },
      {
        "batch": {
          "batch_number": null,
          "id": "00000000-0000-0000-0000-000000000b83",
          "name": "B2384"
        },
        "compliance_quantity": null,
        "id": "69c2e506-9077-437a-91dd-06a032b23bb8",
        "is_sample": false,
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 90210, US",
          "company_id": "00000000-0000-0000-0000-000000001c69",
          "id": "00000000-0000-0000-0000-0000000008f9",
          "license_id": null,
          "name": "Place 629"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10",
        "product": {
          "id": "47efbaa3-bf3c-4561-a351-0e7b45688614",
          "name": "Product 2379",
          "sku": "sku 2380",
          "updated_datetime": "2026-08-19T13:19:37.847887Z"
        },
        "quantity": "2.000000000",
        "received_quantity": "0.000000000"
      }
    ],
    "location": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001c69",
      "id": "00000000-0000-0000-0000-0000000008f9",
      "license_id": null,
      "license_number": null,
      "name": "Place 629"
    },
    "metrc_transfer_id": null,
    "order_datetime": "2026-08-19T13:19:37.808253Z",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-2862@example.com",
      "full_name": "FirstName5796 LastName5797",
      "id": "00000000-0000-0000-0000-000000002638",
      "inserted_datetime": "2026-08-19T13:19:37.805707Z",
      "role": {
        "id": "00000000-0000-0000-0000-00000000270a",
        "name": "Admin 2953"
      }
    },
    "paid": "100.01",
    "payment_status": "NOT_PAID",
    "payments": [
      {
        "amount": "100.01",
        "company": {
          "id": "00000000-0000-0000-0000-0000000011b0",
          "name": "Company 2067",
          "updated_datetime": "2026-08-19T13:19:37.772430Z"
        },
        "credit_uses": null,
        "description": "Payment for purchase",
        "fully_paid_with_credits": false,
        "id": "00000000-0000-0000-0000-000000000067",
        "inserted_datetime": "2026-08-19T13:19:37.872260Z",
        "invoice": null,
        "overpayment_credits": null,
        "payment_date": "2020-01-01T00:00:00.000000Z",
        "payment_method": {
          "active": true,
          "deleted_at": null,
          "id": "00000000-0000-0000-0000-000000000088",
          "inserted_datetime": "2026-08-19T13:19:37.871289Z",
          "name": "Payment Method 43",
          "qb_payment_method_id": null,
          "type": "CREDIT_CARD",
          "updated_datetime": "2026-08-19T13:19:37.871289Z"
        },
        "payment_number": "PYT-1",
        "payment_type": "PURCHASE",
        "purchase": {
          "id": "00000000-0000-0000-0000-0000000000f0",
          "purchase_number": "Purchase #56",
          "status": "PENDING",
          "total": "32.00"
        },
        "quickbooks_deposit_account_id": null,
        "status": "POSTED",
        "updated_datetime": "2026-08-19T13:19:37.872260Z"
      }
    ],
    "purchase_number": "Purchase #56",
    "qb_bill_id": null,
    "status": "PENDING",
    "supplier_location": null,
    "total": "32.00",
    "updated_datetime": "2026-08-19T13:19:37.808981Z"
  }
}

Get a single purchase given the ID.

Required permission: purchases_permissions_view.

Request

GET /public/v1/purchases/{id}

Parameters

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

Responses

Status Description Schema
200 A single purchase PurchaseResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzksImlhdCI6MTc4NzE0NTU3OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOGRmNTNiOGYtYzkwYy00Yzg0LWFlOTktZDI5ZWQ4MmZmNWFmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6MTAwODciLCJ0eXAiOiJhY2Nlc3MifQ.8HpFXSXKPsbYM7LHHUO8DLs_CwyuJT-qu8Q8VSbq0zA

Response

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

{
  "data": [
    {
      "billing_location": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-000000001d91",
        "id": "00000000-0000-0000-0000-00000000097b",
        "license_id": null,
        "license_number": null,
        "name": "Place 758"
      },
      "biotrack_id": null,
      "charges": [],
      "company": {
        "id": "00000000-0000-0000-0000-0000000012ab",
        "name": "Company 2362",
        "updated_datetime": "2026-08-19T13:19:39.983882Z"
      },
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-3168@example.com",
        "full_name": "FirstName6410 LastName6411",
        "id": "00000000-0000-0000-0000-000000002772",
        "inserted_datetime": "2026-08-19T13:19:40.001912Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000002838",
          "name": "Admin 3255"
        }
      },
      "custom_data": [
        {
          "id": 228,
          "name": "Custom Field 49",
          "value": null
        }
      ],
      "description": null,
      "due_datetime": "2026-08-19T13:19:40.003397Z",
      "id": "00000000-0000-0000-0000-00000000010a",
      "inserted_datetime": "2026-08-19T13:19:40.003782Z",
      "items": [
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000c35",
            "name": "B2924"
          },
          "compliance_quantity": null,
          "id": "abfb670b-d12f-4036-a86b-85ad585cca44",
          "is_sample": false,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 90210, US",
            "company_id": "00000000-0000-0000-0000-000000001d91",
            "id": "00000000-0000-0000-0000-00000000097a",
            "license_id": null,
            "name": "Place 757"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "e8e91015-6548-4271-975a-f0cdad36ba3a",
            "name": "Product 2916",
            "sku": "sku 2917",
            "updated_datetime": "2026-08-19T13:19:40.008366Z"
          },
          "quantity": "15.000000000",
          "received_quantity": "0.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000c36",
            "name": "B2925"
          },
          "compliance_quantity": null,
          "id": "a0f70976-9ed7-478b-8612-c59548544c2f",
          "is_sample": false,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 90210, US",
            "company_id": "00000000-0000-0000-0000-000000001d91",
            "id": "00000000-0000-0000-0000-00000000097a",
            "license_id": null,
            "name": "Place 757"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "aaac3459-6a2c-48f0-b004-eed7c44f790b",
            "name": "Product 2918",
            "sku": "sku 2919",
            "updated_datetime": "2026-08-19T13:19:40.013630Z"
          },
          "quantity": "10.000000000",
          "received_quantity": "0.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000c37",
            "name": "B2926"
          },
          "compliance_quantity": null,
          "id": "b9f37ee5-42f1-43eb-96c3-eda73f9cc5fd",
          "is_sample": false,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 90210, US",
            "company_id": "00000000-0000-0000-0000-000000001d91",
            "id": "00000000-0000-0000-0000-00000000097a",
            "license_id": null,
            "name": "Place 757"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "e9c41ee3-2d1e-43bd-9100-f599c495d363",
            "name": "Product 2920",
            "sku": "sku 2921",
            "updated_datetime": "2026-08-19T13:19:40.018951Z"
          },
          "quantity": "5.000000000",
          "received_quantity": "0.000000000"
        },
        {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-000000000c38",
            "name": "B2927"
          },
          "compliance_quantity": null,
          "id": "18b22d52-4103-41bc-af64-2c947e23c051",
          "is_sample": false,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 90210, US",
            "company_id": "00000000-0000-0000-0000-000000001d91",
            "id": "00000000-0000-0000-0000-00000000097a",
            "license_id": null,
            "name": "Place 757"
          },
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "294e478e-1fe9-4b2c-ab0f-c2a0b9a112f2",
            "name": "Product 2922",
            "sku": "sku 2923",
            "updated_datetime": "2026-08-19T13:19:40.025161Z"
          },
          "quantity": "2.000000000",
          "received_quantity": "0.000000000"
        }
      ],
      "location": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-000000001d91",
        "id": "00000000-0000-0000-0000-00000000097a",
        "license_id": null,
        "license_number": null,
        "name": "Place 757"
      },
      "metrc_transfer_id": null,
      "order_datetime": "2026-08-19T13:19:40.003396Z",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-3168@example.com",
        "full_name": "FirstName6410 LastName6411",
        "id": "00000000-0000-0000-0000-000000002772",
        "inserted_datetime": "2026-08-19T13:19:40.001912Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000002838",
          "name": "Admin 3255"
        }
      },
      "paid": "0",
      "payment_status": "NOT_PAID",
      "payments": [],
      "purchase_number": "Purchase #77",
      "qb_bill_id": null,
      "status": "PENDING",
      "supplier_location": null,
      "total": "32.00",
      "updated_datetime": "2026-08-19T13:19:40.003782Z"
    },
    {
      "billing_location": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-000000001d91",
        "id": "00000000-0000-0000-0000-000000000979",
        "license_id": null,
        "license_number": null,
        "name": "Place 756"
      },
      "biotrack_id": null,
      "charges": [
        {
          "id": "2beafe06-bca3-42ac-b237-c4f5ec9f9870",
          "inserted_datetime": "2026-08-19T13:19:39.977530Z",
          "name": "C1",
          "percent": "10.0000",
          "price": "1.00",
          "tax": {
            "id": "00000000-0000-0000-0000-000000000031",
            "name": "T1"
          },
          "type": "CHARGE",
          "unit_type": "PERCENT"
        }
      ],
      "company": {
        "id": "00000000-0000-0000-0000-0000000012aa",
        "name": "Company 2361",
        "updated_datetime": "2030-11-01T00:00:00.000000Z"
      },
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "purchase-owner@example.com",
        "full_name": "FirstName6390 LastName6391",
        "id": "00000000-0000-0000-0000-000000002768",
        "inserted_datetime": "2026-08-19T13:19:39.928720Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000002839",
          "name": "Admin 3256"
        }
      },
      "custom_data": [
        {
          "id": 228,
          "name": "Custom Field 49",
          "value": "Custom Field Value 1"
        }
      ],
      "description": "A description of this purchase",
      "due_datetime": "2020-01-01T00:00:01.000000Z",
      "id": "00000000-0000-0000-0000-000000000109",
      "inserted_datetime": "2020-01-01T00:00:03.000000Z",
      "items": [
        {
          "batch": null,
          "compliance_quantity": "1.0000",
          "id": "bbd4d02c-df82-476f-acb7-3da4f7bc9ef6",
          "is_sample": false,
          "location": {
            "address": "123 Fake Street, Beverly Hills, CA 90210, US",
            "company_id": "00000000-0000-0000-0000-000000001d91",
            "id": "00000000-0000-0000-0000-000000000976",
            "license_id": "00000000-0000-0000-0000-00000000027d",
            "name": "Place 753"
          },
          "package": {
            "batch_number": "B1",
            "compliance_label": "ABCDEF012345670000000227",
            "id": "00000000-0000-0000-0000-000000000170",
            "metrc_label": "ABCDEF012345670000000227",
            "status": "active"
          },
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "7732d0e8-eb91-44e0-8449-6cdd2c2e4d6b",
            "name": "P1",
            "sku": "SKU1",
            "updated_datetime": "2023-11-02T00:00:00.000000Z"
          },
          "quantity": "1.000000000",
          "received_quantity": "1.000000000"
        }
      ],
      "location": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-000000001d91",
        "id": "00000000-0000-0000-0000-000000000978",
        "license_id": null,
        "license_number": null,
        "name": "Place 755"
      },
      "metrc_transfer_id": null,
      "order_datetime": "2020-01-01T00:00:02.000000Z",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "purchase-owner@example.com",
        "full_name": "FirstName6390 LastName6391",
        "id": "00000000-0000-0000-0000-000000002768",
        "inserted_datetime": "2026-08-19T13:19:39.928720Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000002839",
          "name": "Admin 3256"
        }
      },
      "paid": "0",
      "payment_status": "NOT_PAID",
      "payments": [],
      "purchase_number": "SO-123",
      "qb_bill_id": null,
      "status": "COMPLETED",
      "supplier_location": null,
      "total": "10.00",
      "updated_datetime": "2020-01-01T00:00:04.000000Z"
    }
  ],
  "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.

Required permission: purchases_permissions_view. Results are filtered to only include purchases the authenticated user can access under their team restrictions.

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 query number false ?page[number]=1
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-0000000000ee/payments
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzcsImlhdCI6MTc4NzE0NTU3NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZWQwM2VmYjktODZmOC00MzZjLWJlN2QtNmM1ZmUyMWJkMTNmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTczMSIsInR5cCI6ImFjY2VzcyJ9.ZpEEkFOTEuKZonBr2vcIOgXuU_Rb6R_mNZj-0EOfWA0

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

Response

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

{
  "data": {
    "amount": "100.01",
    "company": {
      "id": "00000000-0000-0000-0000-000000001196",
      "name": "Company 2033",
      "updated_datetime": "2026-08-19T13:19:37.374575Z"
    },
    "credit_uses": null,
    "description": "Payment for purchase",
    "fully_paid_with_credits": false,
    "id": "00000000-0000-0000-0000-000000000065",
    "inserted_datetime": "2026-08-19T13:19:37.386974Z",
    "invoice": null,
    "overpayment_credits": null,
    "payment_date": "2020-01-01T00:00:00.000000Z",
    "payment_method": {
      "active": true,
      "deleted_at": null,
      "id": "00000000-0000-0000-0000-000000000087",
      "inserted_datetime": "2026-08-19T13:19:37.380143Z",
      "name": "Payment Method 0",
      "qb_payment_method_id": null,
      "type": "CREDIT_CARD",
      "updated_datetime": "2026-08-19T13:19:37.380143Z"
    },
    "payment_number": "PYT-0000001",
    "payment_type": "PURCHASE",
    "purchase": {
      "id": "00000000-0000-0000-0000-0000000000ee",
      "purchase_number": "Purchase #55",
      "status": "PENDING",
      "total": "32.00"
    },
    "quickbooks_deposit_account_id": "QBD-123",
    "quickbooks_deposit_account_name": "QBD-NAME",
    "status": "POSTED",
    "updated_datetime": "2026-08-19T13:19:37.386974Z"
  }
}

Required permission: purchases_permissions_make_payments. The authenticated user must also be allowed to view purchases under their team restrictions.

Request

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

Parameters

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

Responses

Status Description Schema
200 A single payment PaymentResponse

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzgsImlhdCI6MTc4NzE0NTU3OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzdmZTVkNjctODkwYi00NWRjLTllY2UtZDM5YjlmOGUwMzdlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTc3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6OTg4OSIsInR5cCI6ImFjY2VzcyJ9.5yVhJgijRenApx401SWyJiNq-GD8246-dBDk0R5K9t8

{
  "billing_location_id": "00000000-0000-0000-0000-00000000092c",
  "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-0000000011ff",
  "custom_data": {
    "226": [
      "A",
      "B"
    ]
  },
  "description": "A description of this purchase",
  "due_datetime": "2020-01-30T00:00:00.000000Z",
  "items": [
    {
      "location_id": "00000000-0000-0000-0000-00000000092b",
      "price": "10.000000000",
      "product_id": "aacfd7e4-1a54-4ea5-89c2-ea64b4c949c3",
      "quantity": "1.000000000"
    }
  ],
  "location_id": "00000000-0000-0000-0000-00000000092b",
  "order_datetime": "2020-01-01T00:00:00.000000Z",
  "owner_id": "00000000-0000-0000-0000-0000000026a1"
}

Response

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

{
  "data": {
    "billing_location": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001ccb",
      "id": "00000000-0000-0000-0000-00000000092c",
      "license_id": null,
      "license_number": null,
      "name": "Place 679"
    },
    "biotrack_id": null,
    "charges": [
      {
        "id": "aa6385a0-6866-4f1b-8bde-1bc056f26a75",
        "inserted_datetime": "2026-08-19T13:19:38.678017Z",
        "name": "C1",
        "percent": "10.0000",
        "price": "1.00",
        "type": "CHARGE",
        "unit_type": "PERCENT"
      },
      {
        "id": "874936da-a454-4bbf-80ed-a436590211d3",
        "inserted_datetime": "2026-08-19T13:19:38.678779Z",
        "name": "C2",
        "percent": null,
        "price": "-5.00",
        "type": "DISCOUNT",
        "unit_type": "PRICE"
      }
    ],
    "company": {
      "id": "00000000-0000-0000-0000-0000000011ff",
      "name": "Company 2163",
      "updated_datetime": "2026-08-19T13:19:38.635892Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-0000000026a1",
      "inserted_datetime": "2026-08-19T13:19:38.651004Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000002777",
        "name": "Admin 3062"
      }
    },
    "custom_data": [
      {
        "id": 226,
        "name": "Custom Field 47",
        "value": "A,B"
      }
    ],
    "description": "A description of this purchase",
    "due_datetime": "2020-01-30T00:00:00.000000Z",
    "id": "00000000-0000-0000-0000-0000000000fb",
    "inserted_datetime": "2026-08-19T13:19:38.677050Z",
    "items": [
      {
        "batch": null,
        "compliance_quantity": null,
        "id": "dbb29af8-f0db-448e-bb07-29a8ac41d293",
        "is_sample": false,
        "location": {
          "address": "123 Fake Street, Beverly Hills, CA 90210, US",
          "company_id": "00000000-0000-0000-0000-000000001ccb",
          "id": "00000000-0000-0000-0000-00000000092b",
          "license_id": "00000000-0000-0000-0000-000000000264",
          "name": "Place 678"
        },
        "package": null,
        "price": "10.000000000",
        "price_base": "10.000000000",
        "product": {
          "id": "aacfd7e4-1a54-4ea5-89c2-ea64b4c949c3",
          "name": "P1",
          "sku": "SKU1",
          "updated_datetime": "2026-08-19T13:19:38.662404Z"
        },
        "quantity": "1.000000000",
        "received_quantity": "0.000000000"
      }
    ],
    "location": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001ccb",
      "id": "00000000-0000-0000-0000-00000000092b",
      "license_id": "00000000-0000-0000-0000-000000000264",
      "license_number": "CDPH-00000172",
      "name": "Place 678"
    },
    "metrc_transfer_id": null,
    "order_datetime": "2020-01-01T00:00:00.000000Z",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "user1@a.com",
      "full_name": "John Foo",
      "id": "00000000-0000-0000-0000-0000000026a1",
      "inserted_datetime": "2026-08-19T13:19:38.651004Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000002777",
        "name": "Admin 3062"
      }
    },
    "paid": "0",
    "payment_status": "NOT_PAID",
    "payments": [],
    "purchase_number": "PO-0000001",
    "qb_bill_id": null,
    "status": "PENDING",
    "supplier_location": null,
    "total": "6.00",
    "updated_datetime": "2026-08-19T13:19:38.683761Z"
  }
}

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. The order's line items must be either all package-tracked or all not package-tracked — a mix of the two is rejected.

See the status field on the purchase response for what each value means. Allowed transitions: PENDING, PROCESSING, and DELIVERING may move freely between one another and forward to PARTIALLY_RECEIVED or COMPLETED. Once a purchase reaches PARTIALLY_RECEIVED or COMPLETED it has received inventory and can no longer move back to PENDING, PROCESSING, or DELIVERING (it may still move between PARTIALLY_RECEIVED and COMPLETED). PARTIALLY_RECEIVED is not allowed for purchases that contain package-tracked items.

For a PARTIALLY_RECEIVED purchase, set each line's received_quantity to the amount received so far. In a subsequent call you may decrease a line's received_quantity, or delete a line that has a positive received_quantity, as long as the previously-received quantity has not yet been consumed elsewhere in Distru (e.g. sold, transferred, or adjusted); otherwise the change is rejected.

To match the purchase with an incoming compliance transfer, pass a top-level metrc_transfer_id or biotrack_id. This is only valid with status = COMPLETED, and requires the purchase's location_id to be on the license that received the transfer; the referenced incoming transfer must exist or the request is rejected. On each line item, identify the package it maps to with metrc_package_id (Metrc) or biotrack_id (BioTrack) and give its compliance_quantity. Once matched, a purchase is locked at COMPLETED and its transfer association cannot be changed.

Required permission: purchases_permissions_create to create a new purchase order, purchases_permissions_edit (and access to the purchase under team restrictions) to update an existing purchase order.

Request

POST /public/v1/purchases

Parameters

Parameter Description In Type Required Default Example
billing_location_id The billing address for this purchase order body string true
biotrack_id The ID of the incoming BioTrack transfer to match this purchase with. When provided, status must be COMPLETED and each line item must identify its package via biotrack_id and compliance_quantity. body string false
charges The extra lines added on top of the purchase order's items — fees, discounts, or taxes. Each entry follows the PurchaseChargeRequest shape. body array false
company_id The company that is the supplier for this purchase order body string true
custom_data A map of custom field IDs to their values. Use GET /public/v1/custom-fields?parent_object=purchase to retrieve available custom fields, their IDs, and their types. The value format depends on the field's type: a text field takes a string, a date field takes a full ISO8601 datetime, and a checkbox field takes an array of its selected options. body object false {"101":"Some text value","102":"2026-08-18T00:00:00.000-07:00","103":["Option A","Option B"]}
description A description of the purchase order body string false
due_datetime The datetime by which the purchase order should be paid body string true
id Unique ID for this purchase order. Omit it to create a new purchase order — Distru assigns the ID. Provide an existing purchase order's ID to update it; an ID that doesn't exist returns a not-found error. body string false
items The products being purchased, one entry per line. Each entry follows the PurchaseItemRequest shape. body array true
location_id The location into which the inventory in this purchase will be received body string true
metrc_transfer_id The ID of the incoming Metrc transfer to match this purchase with. When provided, status must be COMPLETED and each line item must identify its package via metrc_package_id and compliance_quantity. body integer false
order_datetime The datetime on which the purchase order was placed body string true
owner_id The ID of the Distru user that owns this purchase order body string false
status Where this purchase order sits in its lifecycle, which also governs when inventory is received. See the endpoint description for the allowed transitions and the status field on the purchase response for what each value means. body string true

Responses

Status Description Schema
200 A single purchase orders PurchaseResponse

Reports

Get the Cost of Goods Sold report

GET /public/v1/reports/cogs returns one Final row per completed order line item as {data, meta}, narrowed by order date

GET /public/v1/reports/cogs?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjc0Mzk1NTMtMDFhOS00ZTJlLTgxMWEtMWUzMTg4MTU5YzMwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzQyMiIsInR5cCI6ImFjY2VzcyJ9.jq4b0OEVMkgdMNVwlZJVAVhIyreOKpXGewtQ1-QRp24

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 11f6c948fa3fe5ffa7137b18abfef0ae-64cc7d1e1926ca4c-0

{
  "data": [
    {
      "batch": "",
      "cost_origin": "",
      "final_input": "Final",
      "margin_actual": "",
      "margin_default": "",
      "metrc_production_batch_number": "",
      "order_number": "SO-1",
      "package": "",
      "product_brand": "",
      "product_category": "Some category 90",
      "product_name": "Alpha",
      "profit_unit_actual": "",
      "profit_unit_default": "",
      "quantity": 4,
      "sku": "SKU-A",
      "total_cost_actual": "",
      "total_cost_default": "",
      "total_price": 40,
      "total_profits_actual": "",
      "total_profits_default": "",
      "unit_cost_actual": "",
      "unit_cost_default": "",
      "unit_price": 10,
      "unit_type": "Gram"
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "order_number",
        "label": "Order Number"
      },
      {
        "key": "final_input",
        "label": "Final/Input"
      },
      {
        "key": "cost_origin",
        "label": "Cost Origin"
      },
      {
        "key": "product_name",
        "label": "Product Name"
      },
      {
        "key": "sku",
        "label": "SKU"
      },
      {
        "key": "product_brand",
        "label": "Product Brand"
      },
      {
        "key": "product_category",
        "label": "Product Category"
      },
      {
        "key": "package",
        "label": "Package"
      },
      {
        "key": "metrc_production_batch_number",
        "label": "Metrc Production Batch Number"
      },
      {
        "key": "batch",
        "label": "Batch"
      },
      {
        "key": "quantity",
        "label": "Quantity"
      },
      {
        "key": "unit_type",
        "label": "Unit Type"
      },
      {
        "key": "unit_price",
        "label": "Unit Price"
      },
      {
        "key": "total_price",
        "label": "Total Price"
      },
      {
        "key": "unit_cost_actual",
        "label": "Unit Cost (Actual)"
      },
      {
        "key": "unit_cost_default",
        "label": "Unit Cost (Default)"
      },
      {
        "key": "total_cost_actual",
        "label": "Total Cost (Actual)"
      },
      {
        "key": "total_cost_default",
        "label": "Total Cost (Default)"
      },
      {
        "key": "total_profits_actual",
        "label": "Total Profits (Actual)"
      },
      {
        "key": "total_profits_default",
        "label": "Total Profits (Default)"
      },
      {
        "key": "profit_unit_actual",
        "label": "Profit/Unit (Actual)"
      },
      {
        "key": "profit_unit_default",
        "label": "Profit/Unit (Default)"
      },
      {
        "key": "margin_actual",
        "label": "Margin (Actual)"
      },
      {
        "key": "margin_default",
        "label": "Margin (Default)"
      }
    ],
    "date_range": "Aug 19, 2026",
    "report": "cogs"
  }
}

Returns one row per completed sales order line item over the reported date range, with the product's descriptive attributes (name, SKU, brand, category), its package, batch, and Metrc production batch, plus the item's quantity, unit type, unit and total price, and both actual and default cost figures (unit cost, total cost, total profit, profit per unit, and margin). Only line items on Completed orders that have not been fully returned are included. When neither order_datetime nor delivery_datetime is provided, the report defaults to orders from the last 30 days (by order date) to avoid scanning your entire order history.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Companies on the BioTrack compliance integration do not get the metrc_production_batch_number column. Report-level information (the resolved date and column definitions) is returned under meta.

Required permission: reports_permissions_cogs.

Request

GET /public/v1/reports/cogs

Parameters

Parameter Description In Type Required Default Example
delivery_datetime Filter by delivery date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
order_datetime Filter by order date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z

Responses

Status Description Schema
200 The Cost of Goods Sold report CogsReport

Get the Cultivation Transaction History report

GET /public/v1/reports/cultivation-transaction-history returns one row per cultivation transaction as {data, meta}, filtered by strain and type

GET /public/v1/reports/cultivation-transaction-history?datetime=2000-01-01T00%3A00%3A00Z%2C2999-01-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTNiYjFlMzEtOWNiYS00NjE1LTg0ZTYtNGU4ODYxYmEzMTg3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzgzNyIsInR5cCI6ImFjY2VzcyJ9.gmi7Z_DFObX-nYEeRA5RiJX6tNiBMUGSrKT936KYoHY

Response

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

{
  "data": [
    {
      "amount": 1,
      "batch_name": "Plant Group 8518",
      "date": "08/19/2026",
      "description": null,
      "package_label_s": null,
      "plant_tag_s": null,
      "product_name": null,
      "related_entity": null,
      "related_entity_status": null,
      "strain": "Blue Dream",
      "type": "Plant Batch Creation",
      "unit": "Unit"
    },
    {
      "amount": 1,
      "batch_name": "Plant Group 7043",
      "date": "08/19/2026",
      "description": null,
      "package_label_s": null,
      "plant_tag_s": null,
      "product_name": null,
      "related_entity": null,
      "related_entity_status": null,
      "strain": "OG Kush",
      "type": "Plant Batch Creation",
      "unit": "Unit"
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "date",
        "label": "Date"
      },
      {
        "key": "strain",
        "label": "Strain"
      },
      {
        "key": "batch_name",
        "label": "Batch Name"
      },
      {
        "key": "plant_tag_s",
        "label": "Plant Tag(s)"
      },
      {
        "key": "product_name",
        "label": "Product Name"
      },
      {
        "key": "package_label_s",
        "label": "Package Label(s)"
      },
      {
        "key": "type",
        "label": "Type"
      },
      {
        "key": "related_entity",
        "label": "Related Entity"
      },
      {
        "key": "related_entity_status",
        "label": "Related Entity Status"
      },
      {
        "key": "amount",
        "label": "Amount"
      },
      {
        "key": "unit",
        "label": "Unit"
      },
      {
        "key": "description",
        "label": "Description"
      }
    ],
    "date_range": "Dec 31, 1999 to Dec 31, 2998",
    "report": "cultivation_transaction_history"
  }
}

Returns one row per cultivation transaction over the reported date range, covering the full plant lifecycle: plant batch creations, adjustments and splits, growth phase changes, plant moves, destructions, additive applications, teardowns, harvests, waste, and packaging. Each row carries the transaction's date, strain, batch name, plant tag(s), product name, package label(s), type, the related entity (teardown or harvest) and its status, the signed amount and unit, and the transaction's description. When no date filter is provided, the report defaults to the last 30 days.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. The total_cost column is omitted for users without permission to view costs. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_cultivation_transaction_history.

Request

GET /public/v1/reports/cultivation-transaction-history

Parameters

Parameter Description In Type Required Default Example
datetime Filter by transaction date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
license_ids Filter by license IDs query array false
plant_batch_ids Filter by plant batch (plant group) IDs query array false
strain Filter by an exact strain name query string false
transaction_type Filter by a single transaction type query string false Move Plant(s)

Responses

Status Description Schema
200 The Cultivation Transaction History report CultivationTransactionHistoryReport

Get the Harvest Outputs report

GET /public/v1/reports/harvest-outputs returns one row per assembly line item as {data, meta}, filtered by status

GET /public/v1/reports/harvest-outputs
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNmJhNDUwODktYWJmYy00ZGEyLTkxODMtNDMwOWI0MmRhMjkyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzYwOCIsInR5cCI6ImFjY2VzcyJ9.FRAg7xT_MbnbmtoyCitM9qCnXgTR37i1Qing3EKsb_I

Response

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

{
  "data": [
    {
      "cost_input_output": "Output",
      "distru_product": "Product 237",
      "harvest_assembly_date": "08/19/2026",
      "harvest_assembly_number": "HAS-0000001",
      "harvest_name": "Spring-Hill-Kush-#5-08/19/2026",
      "line_item_id": "9f4f72c3-a921-43f7-8e5e-a26b1c91e91f",
      "location": "Place 135",
      "output_batch_number": null,
      "output_package_number": "1A4010200001234000000013",
      "output_reference_id": null,
      "product_category": "Some category 120",
      "quantity": 10,
      "status": "PENDING",
      "strain": "Spring Hill Kush #5",
      "unit_type": "Gram"
    },
    {
      "cost_input_output": "Input",
      "distru_product": "Spring-Hill-Kush-#5-08/19/2026",
      "harvest_assembly_date": "08/19/2026",
      "harvest_assembly_number": "HAS-0000001",
      "harvest_name": "Spring-Hill-Kush-#5-08/19/2026",
      "line_item_id": "09428960-1695-4f9e-b5df-fd5e9bbd0885",
      "location": "Place 127",
      "output_batch_number": null,
      "output_package_number": null,
      "output_reference_id": null,
      "product_category": null,
      "quantity": 10,
      "status": "PENDING",
      "strain": "Spring Hill Kush #5",
      "unit_type": "Gram"
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "harvest_assembly_date",
        "label": "Harvest Assembly Date"
      },
      {
        "key": "harvest_assembly_number",
        "label": "Harvest Assembly Number"
      },
      {
        "key": "status",
        "label": "Status"
      },
      {
        "key": "harvest_name",
        "label": "Harvest Name"
      },
      {
        "key": "output_batch_number",
        "label": "Output Batch Number"
      },
      {
        "key": "output_package_number",
        "label": "Output Package Number"
      },
      {
        "key": "strain",
        "label": "Strain"
      },
      {
        "key": "location",
        "label": "Location"
      },
      {
        "key": "cost_input_output",
        "label": "Cost/Input/Output"
      },
      {
        "key": "distru_product",
        "label": "Distru Product"
      },
      {
        "key": "product_category",
        "label": "Product Category"
      },
      {
        "key": "quantity",
        "label": "Quantity"
      },
      {
        "key": "unit_type",
        "label": "Unit Type"
      },
      {
        "key": "line_item_id",
        "label": "Line Item ID"
      },
      {
        "key": "output_reference_id",
        "label": "Output Reference ID"
      }
    ],
    "date_range": "Aug 12, 2026 to Aug 19, 2026",
    "report": "harvest_outputs"
  }
}

Returns one row per line item of every harvest assembly over the reported date range. Each assembly expands into its inputs (the harvested material consumed), its outputs (the products produced, with their batch and package numbers), and its cost line items — the cost_input_output column identifies which. Every row carries the assembly's date, number, and status, plus the harvest name, strain, location, product, product category, quantity, and unit type. When no date filter is provided, the report defaults to the last 7 days.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. The cost columns (unit_cost_actual, unit_cost_default, total_cost_actual, total_cost_default, cost_type, cost_type_description) are omitted for users without permission to view costs. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_harvest_outputs.

Request

GET /public/v1/reports/harvest-outputs

Parameters

Parameter Description In Type Required Default Example
datetime Filter by harvest assembly date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
harvest_name Filter by harvest name (partial match) query string false
location_id Filter by a single input location ID query string false
output_product_category_id Filter by a single output product category ID query string false
output_product_name Filter by output product name (partial match) query string false
status Filter by harvest assembly status query string false COMPLETED
strain Filter by strain (partial match) query string false

Responses

Status Description Schema
200 The Harvest Outputs report HarvestOutputsReport

Get the Inventory Assets report

GET /public/v1/reports/inventory-assets returns one row per on-hand asset as {data, meta}, filtered by location

GET /public/v1/reports/inventory-assets
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZTJkNWE5OTktMjZjZS00NDZiLWFkYTktNzg0YjFlMTYwNDNiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzM2MyIsInR5cCI6ImFjY2VzcyJ9.ITa4x9TILfUpV9BRNvi84lbsQMH6jkTrPGbYnBKgkmY

Response

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

{
  "data": [
    {
      "active_quantity": 100,
      "assembling_quantity": 0,
      "batch_number": "B1",
      "category": "Some category 79",
      "expiration_date": null,
      "harvest_date": null,
      "license": null,
      "location": "L1",
      "owner": "FirstName932 LastName933",
      "package_number": null,
      "product": "Widget",
      "selling_quantity": 0,
      "sku": "sku 132",
      "subcategory": "Some subcategory 70",
      "tracking_method": "BATCH",
      "unit_price": 1.0,
      "unit_type": "Gram",
      "vendor": "Company 397"
    },
    {
      "active_quantity": 50,
      "assembling_quantity": 0,
      "batch_number": "B1",
      "category": "Some category 79",
      "expiration_date": null,
      "harvest_date": null,
      "license": null,
      "location": "L2",
      "owner": "FirstName932 LastName933",
      "package_number": null,
      "product": "Widget",
      "selling_quantity": 0,
      "sku": "sku 132",
      "subcategory": "Some subcategory 70",
      "tracking_method": "BATCH",
      "unit_price": 1.0,
      "unit_type": "Gram",
      "vendor": "Company 397"
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "product",
        "label": "Product"
      },
      {
        "key": "license",
        "label": "License"
      },
      {
        "key": "location",
        "label": "Location"
      },
      {
        "key": "package_number",
        "label": "Package Number"
      },
      {
        "key": "batch_number",
        "label": "Batch Number"
      },
      {
        "key": "sku",
        "label": "SKU"
      },
      {
        "key": "vendor",
        "label": "Vendor"
      },
      {
        "key": "owner",
        "label": "Owner"
      },
      {
        "key": "unit_type",
        "label": "Unit Type"
      },
      {
        "key": "active_quantity",
        "label": "Active Quantity"
      },
      {
        "key": "assembling_quantity",
        "label": "Assembling Quantity"
      },
      {
        "key": "selling_quantity",
        "label": "Selling Quantity"
      },
      {
        "key": "category",
        "label": "Category"
      },
      {
        "key": "subcategory",
        "label": "Subcategory"
      },
      {
        "key": "unit_price",
        "label": "Unit Price"
      },
      {
        "key": "expiration_date",
        "label": "Expiration Date"
      },
      {
        "key": "tracking_method",
        "label": "Tracking Method"
      },
      {
        "key": "harvest_date",
        "label": "Harvest Date"
      }
    ],
    "date_range": "Aug 19, 2026 - 6:19AM",
    "report": "inventory_assets"
  }
}

Returns one row per on-hand inventory asset (a product at a location, batch, or package) with its descriptive attributes (product, SKU, vendor, owner, unit type, category, subcategory, license, location, package number, batch number), its active, assembling, and selling quantities, its unit price, and its actual and default unit and total costs. Quantities and costs are point-in-time: pass datetime to snapshot the position at a past moment (defaults to now).

Pass style=granular to expand each asset into its underlying cost inputs — this adds the final_input, cost_origin, and cost_quantity columns and requires permission to view cost details. Cost columns are omitted for users without permission to view costs.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Report-level information (the resolved date and column definitions) is returned under meta.

Required permission: reports_permissions_inventory_assets.

Request

GET /public/v1/reports/inventory-assets

Parameters

Parameter Description In Type Required Default Example
datetime Point-in-time snapshot as an ISO8601 datetime (defaults to now) query string false 2026-07-01T00:00:00Z
location_id Filter by a single location ID query string false
style Row granularity (defaults to collapsed) query string false granular

Responses

Status Description Schema
200 The Inventory Assets report InventoryAssetsReport

Get the Inventory Transaction History report

GET /public/v1/reports/inventory-transaction-history returns one row per inventory transaction as {data, meta}, honoring the date filter

GET /public/v1/reports/inventory-transaction-history
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDk2ZGUwYjItZTlmOC00YzE0LTg2NWYtOTY2NGU1YmFmNzg1IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzMzMyIsInR5cCI6ImFjY2VzcyJ9.DhEifPhoUa7lyHTJrlkz7otd-0VRa5ToIYmmuwqZubs

Response

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

{
  "data": [
    {
      "amount": 100,
      "batch_id": "00000000-0000-0000-0000-000000000891",
      "batch_number": null,
      "cbd": null,
      "cbd_mg_g": null,
      "cbd_mg_ml": null,
      "company_relationship_id": null,
      "date": "2026-08-19T13:19:27.981843Z",
      "description": "FirstName882 LastName883 moved 100 g of Batch B1 of Widget from gain to active in Place 78 with reason 'revaluation'",
      "metrc_production_batch_number": null,
      "metrc_unit_name": null,
      "package_batch_number_or_batch_name": "B1",
      "package_label": null,
      "product": "Widget",
      "product_id": "65c59f5d-e949-4b19-86e2-cefca246bf4f",
      "related_entity": "Stock Adjustment",
      "related_entity_customer_vendor": null,
      "related_entity_status": null,
      "thc": null,
      "thc_mg_g": null,
      "thc_mg_ml": null,
      "total_cbd": null,
      "total_cbd_mg_g": null,
      "total_cbd_mg_ml": null,
      "total_cost": null,
      "total_thc": null,
      "total_thc_mg_g": null,
      "total_thc_mg_ml": null,
      "type": "adjustment",
      "unit_type": "Gram"
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "date",
        "label": "Date"
      },
      {
        "key": "product",
        "label": "Product"
      },
      {
        "key": "package_batch_number_or_batch_name",
        "label": "Package Batch Number or Batch Name"
      },
      {
        "key": "batch_number",
        "label": "Batch Number"
      },
      {
        "key": "package_label",
        "label": "Package Label"
      },
      {
        "key": "metrc_production_batch_number",
        "label": "Metrc Production Batch Number"
      },
      {
        "key": "type",
        "label": "Type"
      },
      {
        "key": "related_entity",
        "label": "Related Entity"
      },
      {
        "key": "related_entity_status",
        "label": "Related Entity Status"
      },
      {
        "key": "related_entity_customer_vendor",
        "label": "Related Entity Customer/Vendor"
      },
      {
        "key": "amount",
        "label": "Amount"
      },
      {
        "key": "unit_type",
        "label": "Unit Type"
      },
      {
        "key": "metrc_unit_name",
        "label": "Metrc Unit Name"
      },
      {
        "key": "product_id",
        "label": "Product Id"
      },
      {
        "key": "batch_id",
        "label": "Batch Id"
      },
      {
        "key": "company_relationship_id",
        "label": "Company Relationship Id"
      },
      {
        "key": "description",
        "label": "Description"
      },
      {
        "key": "thc",
        "label": "THC %"
      },
      {
        "key": "total_thc",
        "label": "Total THC %"
      },
      {
        "key": "thc_mg_g",
        "label": "THC mg/g"
      },
      {
        "key": "thc_mg_ml",
        "label": "THC mg/mL"
      },
      {
        "key": "total_thc_mg_g",
        "label": "Total THC mg/g"
      },
      {
        "key": "total_thc_mg_ml",
        "label": "Total THC mg/mL"
      },
      {
        "key": "cbd",
        "label": "CBD %"
      },
      {
        "key": "total_cbd",
        "label": "Total CBD %"
      },
      {
        "key": "cbd_mg_g",
        "label": "CBD mg/g"
      },
      {
        "key": "cbd_mg_ml",
        "label": "CBD mg/mL"
      },
      {
        "key": "total_cbd_mg_g",
        "label": "Total CBD mg/g"
      },
      {
        "key": "total_cbd_mg_ml",
        "label": "Total CBD mg/mL"
      },
      {
        "key": "total_cost",
        "label": "Total Cost"
      }
    ],
    "date_range": "Jul 20, 2026 to Aug 19, 2026",
    "report": "inventory_transaction_history"
  }
}

Returns one row per inventory transaction over the reported date range, with the transaction's date, product, package and batch identifiers, Metrc production batch number, type, related entity (order, return, assembly, stock adjustment, etc.) and its status and customer/vendor, the amount and unit type, package potency figures (THC/CBD), and the transaction's total cost. When no date filter is provided, the report defaults to the last 30 days.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Companies on the BioTrack compliance integration do not get the metrc_unit_name and metrc_production_batch_number columns. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_inventory_transaction_history.

Request

GET /public/v1/reports/inventory-transaction-history

Parameters

Parameter Description In Type Required Default Example
batch_ids Filter by batch IDs query array false
datetime Filter by transaction date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
package_id Filter by a single package ID query string false
product_ids Filter by product IDs query array false

Responses

Status Description Schema
200 The Inventory Transaction History report InventoryTransactionHistoryReport

Get the Inventory Valuation report

GET /public/v1/reports/inventory-valuation returns one row per product as {data, meta}, valued and filtered per params

GET /public/v1/reports/inventory-valuation
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjUsImlhdCI6MTc4NzE0NTU2NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMjk1YTVmMGYtYjBjZS00ZThlLWFmZjQtYzhiMGI1MTE0NDU3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NjkwNCIsInR5cCI6ImFjY2VzcyJ9.3TE7bz33RZIAzMWceZE_IQe9BFi4aQHOodZ1jV4Xihg

Response

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

{
  "data": [
    {
      "active_quantity": 5.0,
      "active_value_price": 50.0,
      "assembling_quantity": 0.0,
      "available_quantity": 5.0,
      "brand": null,
      "category": "Some category 0",
      "group": "Product Group 0",
      "image_url": null,
      "incoming_quantity": 0.0,
      "inventory_threshold_max": null,
      "inventory_threshold_min": null,
      "name": "Alpha",
      "owner": "FirstName14 LastName15",
      "pending_output_quantity": 0.0,
      "reserved_quantity": 0.0,
      "sku": "sku 1",
      "subcategory": "Some subcategory 0",
      "unit_cost": 4.0,
      "unit_price": 10.0,
      "unit_type": "Gram",
      "vendor": "Company 10"
    },
    {
      "active_quantity": 0.0,
      "active_value_price": 0.0,
      "assembling_quantity": 0.0,
      "available_quantity": 0.0,
      "brand": null,
      "category": "Some category 1",
      "group": "Product Group 1",
      "image_url": null,
      "incoming_quantity": 0.0,
      "inventory_threshold_max": null,
      "inventory_threshold_min": null,
      "name": "Beta",
      "owner": "FirstName14 LastName15",
      "pending_output_quantity": 0.0,
      "reserved_quantity": 0.0,
      "sku": "sku 3",
      "subcategory": "Some subcategory 1",
      "unit_cost": 4.0,
      "unit_price": 10.0,
      "unit_type": "Gram",
      "vendor": "Company 11"
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "name",
        "label": "Name"
      },
      {
        "key": "sku",
        "label": "SKU"
      },
      {
        "key": "vendor",
        "label": "Vendor"
      },
      {
        "key": "unit_type",
        "label": "Unit Type"
      },
      {
        "key": "category",
        "label": "Category"
      },
      {
        "key": "subcategory",
        "label": "Subcategory"
      },
      {
        "key": "group",
        "label": "Group"
      },
      {
        "key": "owner",
        "label": "Owner"
      },
      {
        "key": "active_quantity",
        "label": "Active Quantity"
      },
      {
        "key": "assembling_quantity",
        "label": "Assembling Quantity"
      },
      {
        "key": "reserved_quantity",
        "label": "Reserved Quantity"
      },
      {
        "key": "available_quantity",
        "label": "Available Quantity"
      },
      {
        "key": "incoming_quantity",
        "label": "Incoming Quantity"
      },
      {
        "key": "pending_output_quantity",
        "label": "Pending Output Quantity"
      },
      {
        "key": "unit_cost",
        "label": "Unit Cost"
      },
      {
        "key": "unit_price",
        "label": "Unit Price"
      },
      {
        "key": "inventory_threshold_max",
        "label": "Inventory Threshold Max"
      },
      {
        "key": "inventory_threshold_min",
        "label": "Inventory Threshold Min"
      },
      {
        "key": "active_value_price",
        "label": "Active Value (Price)"
      },
      {
        "key": "image_url",
        "label": "Image URL"
      },
      {
        "key": "brand",
        "label": "Brand"
      }
    ],
    "date_range": "Aug 19, 2026",
    "report": "inventory_valuation"
  }
}

Returns one row per product with its current on-hand position — active, assembling, reserved, available, incoming, and pending-output quantities — alongside the product's descriptive attributes (SKU, vendor, brand, unit type, category, subcategory, group, owner), its unit cost and price, its inventory alert thresholds, and its active inventory value. The active value is priced by unit price by default; pass calculation_method=cost to value it by unit cost instead, which also renames the value column (active_value_price becomes active_value_cost).

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Any Product custom fields configured for the company are appended as extra columns. Report-level information (the resolved date and column definitions) is returned under meta.

Required permission: reports_permissions_inventory_valuation.

Request

GET /public/v1/reports/inventory-valuation

Parameters

Parameter Description In Type Required Default Example
brand_ids Filter by brand (company relationship) IDs query array false
calculation_method How to value active inventory (defaults to price) query string false cost
location_ids Filter by location IDs query array false
search Search by product name or SKU query string false
user_ids Filter by user IDs query array false
vendor_ids Filter by vendor (company relationship) IDs query array false

Responses

Status Description Schema
200 The Inventory Valuation report InventoryValuationReport

Get the Invoice History report

GET /public/v1/reports/invoice-history returns one row per invoice as {data, meta}, narrowed by the applied filters

GET /public/v1/reports/invoice-history?invoice_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjA0MGVmNzctNzM4NS00NzA4LTgxODgtMmE4MzcxYWNiOTRhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzMzMiIsInR5cCI6ImFjY2VzcyJ9.G9-4SiKgzQEGJAh0dMZhX59BEp6BlMi6R1Dr3bGjMdg

Response

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

{
  "data": [
    {
      "charge_summary": null,
      "customer": "Company 387",
      "discount_summary": null,
      "due_date": "2026-08-19",
      "invoice_date": "2026-07-01",
      "invoice_number": "INV-2",
      "line_item_subtotal": 0.0,
      "outstanding": 500.0,
      "owner": "FirstName884 LastName885",
      "paid": 0.0,
      "sales_order": "SO-25",
      "status": "NOT_PAID",
      "tax_summary": null,
      "total": "500.00",
      "total_charges": 0.0,
      "total_discounts": 0.0,
      "total_taxes": 0.0
    },
    {
      "charge_summary": null,
      "customer": "Company 381",
      "discount_summary": null,
      "due_date": "2026-08-19",
      "invoice_date": "2026-07-01",
      "invoice_number": "INV-1",
      "line_item_subtotal": 0.0,
      "outstanding": 1.0e3,
      "owner": "FirstName860 LastName861",
      "paid": 0.0,
      "sales_order": "SO-23",
      "status": "FULLY_PAID",
      "tax_summary": null,
      "total": "1000.00",
      "total_charges": 0.0,
      "total_discounts": 0.0,
      "total_taxes": 0.0
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "invoice_date",
        "label": "Invoice Date"
      },
      {
        "key": "invoice_number",
        "label": "Invoice Number"
      },
      {
        "key": "due_date",
        "label": "Due Date"
      },
      {
        "key": "sales_order",
        "label": "Sales Order"
      },
      {
        "key": "customer",
        "label": "Customer"
      },
      {
        "key": "status",
        "label": "Status"
      },
      {
        "key": "paid",
        "label": "Paid"
      },
      {
        "key": "outstanding",
        "label": "Outstanding"
      },
      {
        "key": "line_item_subtotal",
        "label": "Line Item Subtotal"
      },
      {
        "key": "total_taxes",
        "label": "Total Taxes"
      },
      {
        "key": "tax_summary",
        "label": "Tax Summary"
      },
      {
        "key": "total_charges",
        "label": "Total Charges"
      },
      {
        "key": "charge_summary",
        "label": "Charge Summary"
      },
      {
        "key": "total_discounts",
        "label": "Total Discounts"
      },
      {
        "key": "discount_summary",
        "label": "Discount Summary"
      },
      {
        "key": "total",
        "label": "Total"
      },
      {
        "key": "owner",
        "label": "Owner"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "invoice_history"
  }
}

Returns one row per invoice with its dates, sales order, customer, status, and monetary totals (paid, outstanding, line item subtotal, taxes, charges, discounts, total) along with the tax, charge, and discount summaries. When no date filter is provided, the report defaults to the last 30 days.

Every value is returned as it appears in the report's CSV export, with numeric cells (monetary amounts) parsed into numbers. Companies on a compliance integration (Metrc or BioTrack) get additional manifest and shipped-from-license columns, and any Invoice custom fields configured for the company are appended as extra columns. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_invoice_history.

Request

GET /public/v1/reports/invoice-history

Parameters

Parameter Description In Type Required Default Example
batch_ids Filter by batch IDs query array false
company_relationship_ids Filter by customer (company relationship) IDs query array false
due_datetime Filter by due date range (comma-separated ISO8601 range) query string false
invoice_datetime Filter by invoice date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
order_status Filter by the invoice's sales order status query array false ["COMPLETED"]
paid Filter by paid amount range (comma-separated min,max) query string false
product_ids Filter by product IDs query array false
search Search by invoice number query string false
shipped_from_license_ids Filter by the shipped-from license IDs query array false
status Filter by invoice payment status query array false ["FULLY_PAID"]
total Filter by invoice total range (comma-separated min,max) query string false 100,500

Responses

Status Description Schema
200 The Invoice History report InvoiceHistoryReport

Get the Order Fulfillment report

GET /public/v1/reports/order-fulfillment returns one row per product pivoted across orders as {data, meta}, narrowed by filters

GET /public/v1/reports/order-fulfillment?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjUsImlhdCI6MTc4NzE0NTU2NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOGVhNjMzMjAtMWMxMC00YzQ4LTg4YmYtODJkOWIwYjI1YmY4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NjkwNiIsInR5cCI6ImFjY2VzcyJ9.z0gmZ8mc0KNBA2QPolUkLVzYZbe-dohCldWI8v5tl8Q

Response

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

{
  "data": [
    {
      "category": "Some category 2",
      "group": "Product Group 2",
      "product": "A1",
      "so_1": 3,
      "so_2": "",
      "subcategory": "Some subcategory 2",
      "total_units": 3,
      "total_value": 30.0,
      "unit_price": 10.0
    },
    {
      "category": "Some category 4",
      "group": "Product Group 4",
      "product": "B2",
      "so_1": 1,
      "so_2": 4,
      "subcategory": "Some subcategory 4",
      "total_units": 5,
      "total_value": 100.0,
      "unit_price": 20.0
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "product",
        "label": "Product"
      },
      {
        "key": "group",
        "label": "Group"
      },
      {
        "key": "category",
        "label": "Category"
      },
      {
        "key": "subcategory",
        "label": "Subcategory"
      },
      {
        "key": "so_1",
        "label": "SO-1"
      },
      {
        "key": "so_2",
        "label": "SO-2"
      },
      {
        "key": "total_units",
        "label": "Total Units"
      },
      {
        "key": "unit_price",
        "label": "Unit Price"
      },
      {
        "key": "total_value",
        "label": "Total Value"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "order_fulfillment"
  }
}

Returns one row per product sold over the reported date range, pivoted across the matching sales orders: alongside the product's group, category, and subcategory, each row carries one dynamic column per order (keyed by the slugified order number, e.g. so_1042) holding the quantity of that product on that order, plus the product's total units, unit price, and total value. When no date filter is provided, the report defaults to the last 30 days. Canceled and merged orders are always excluded.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Because the per-order columns are dynamic, the exact set of keys on each row and in meta.columns depends on which orders match the filters. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_order_fulfillment.

Request

GET /public/v1/reports/order-fulfillment

Parameters

Parameter Description In Type Required Default Example
company_relationship_ids Filter by customer (company relationship) IDs query array false
location_ids Filter by the order item location IDs query array false
order_datetime Filter by order date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
owner_ids Filter by order owner (sales rep) IDs query array false
product_ids Filter by product IDs query array false
search Search by order number, customer name, or LeafLink short ID query string false
status Filter by sales order status query array false ["COMPLETED","DELIVERED"]
user_ids Filter by the order item user IDs query array false

Responses

Status Description Schema
200 The Order Fulfillment report OrderFulfillmentReport

Get the Plant Lifecycle report

GET /public/v1/reports/plant-lifecycle returns one row per plant batch as {data, meta}, filtered by strain

GET /public/v1/reports/plant-lifecycle?datetime=2000-01-01T00%3A00%3A00Z%2C2999-01-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTcxYmIwMWUtYzJkYS00ZTdkLWEyMTItMDE3Y2RjMDlmODM3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzc1MyIsInR5cCI6ImFjY2VzcyJ9.rTLYgANdirPQzJtPXSFSNlbcZz2ivlNEdJ-cn8-waB8

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 94e500bcaa4494ff53a34e03723ad4c1-32f4f1d844682861-0

{
  "data": [
    {
      "batch_creation_date": "08/19/2026",
      "days_as_batch": 0,
      "days_veg_to_last_harvest": null,
      "first_harvest_date": null,
      "harvest_name_s": null,
      "last_harvest_date": null,
      "plant_batch_name": "Plant Group 24324",
      "plants_destroyed": 0,
      "plants_harvested": 0,
      "plants_promoted_to_veg": 0,
      "plants_started": 3,
      "promoted_to_veg_date": null,
      "strain": "OG Kush",
      "total_lifecycle_days": 0
    },
    {
      "batch_creation_date": "08/19/2026",
      "days_as_batch": 0,
      "days_veg_to_last_harvest": null,
      "first_harvest_date": null,
      "harvest_name_s": null,
      "last_harvest_date": null,
      "plant_batch_name": "Plant Group 24388",
      "plants_destroyed": 0,
      "plants_harvested": 0,
      "plants_promoted_to_veg": 0,
      "plants_started": 2,
      "promoted_to_veg_date": null,
      "strain": "Blue Dream",
      "total_lifecycle_days": 0
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "plant_batch_name",
        "label": "Plant Batch Name"
      },
      {
        "key": "batch_creation_date",
        "label": "Batch Creation Date"
      },
      {
        "key": "strain",
        "label": "Strain"
      },
      {
        "key": "plants_started",
        "label": "Plants Started"
      },
      {
        "key": "plants_promoted_to_veg",
        "label": "Plants Promoted to Veg"
      },
      {
        "key": "plants_destroyed",
        "label": "Plants Destroyed"
      },
      {
        "key": "plants_harvested",
        "label": "Plants Harvested"
      },
      {
        "key": "promoted_to_veg_date",
        "label": "Promoted to Veg Date"
      },
      {
        "key": "first_harvest_date",
        "label": "First Harvest Date"
      },
      {
        "key": "last_harvest_date",
        "label": "Last Harvest Date"
      },
      {
        "key": "days_as_batch",
        "label": "Days as Batch"
      },
      {
        "key": "days_veg_to_last_harvest",
        "label": "Days Veg to Last Harvest"
      },
      {
        "key": "total_lifecycle_days",
        "label": "Total Lifecycle Days"
      },
      {
        "key": "harvest_name_s",
        "label": "Harvest Name(s)"
      }
    ],
    "date_range": "Dec 31, 1999 to Dec 31, 2998",
    "report": "plant_lifecycle"
  }
}

Returns one row per plant batch (plant group) whose creation date falls in the reported range, summarizing its lifecycle: the batch name, creation date, strain, and the counts of plants started, promoted to vegetative, destroyed, and harvested. Each row also carries the promotion-to-veg date, first and last harvest dates, the durations spent as a batch, from veg to last harvest, and over the total lifecycle (in days), and the names of the harvests the batch produced.

Only plant batches on active Metrc licenses that can track vegetative plants are included. When no date filter is provided, the report defaults to the last 30 days (by batch creation date). Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. The cost columns (total_cost_batch_stage, total_cost_veg_to_last_harvest, destroyed_plant_cost, total_lifecycle_cost) are omitted for users without permission to view costs. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_plant_lifecycle.

Request

GET /public/v1/reports/plant-lifecycle

Parameters

Parameter Description In Type Required Default Example
datetime Filter by plant batch creation date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
strain Filter by strain (partial match) query string false

Responses

Status Description Schema
200 The Plant Lifecycle report PlantLifecycleReport

Get the Purchase Order History report

GET /public/v1/reports/purchase-order-history returns one row per purchase as {data, meta}, narrowed by the applied filters

GET /public/v1/reports/purchase-order-history?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzk0N2E0MmQtY2MyMS00MjFhLWJhMjItY2E3ZTVlOGI5YzhmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzgxOSIsInR5cCI6ImFjY2VzcyJ9.pvWW8ZgdtGWYOl0DmMHB2bVCd71f0O9JkNF536dJUew

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 065fbce1f55a5f2ecb8d559d3fad821e-36adbde6a648701c-0

{
  "data": [
    {
      "amount": "500.00",
      "due_date": "2026-08-19T06:19:29.691023",
      "owner": "FirstName1848 LastName1849",
      "paid": "0.0",
      "purchase_date": "2026-07-01T05:00:00.000000",
      "purchase_number": "PO-2",
      "status": "PENDING",
      "vendor": "Company 737"
    },
    {
      "amount": "1000.00",
      "due_date": "2026-08-19T06:19:29.676957",
      "owner": "FirstName1838 LastName1839",
      "paid": "0.0",
      "purchase_date": "2026-07-01T05:00:00.000000",
      "purchase_number": "PO-1",
      "status": "COMPLETED",
      "vendor": "Company 734"
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "purchase_date",
        "label": "Purchase Date"
      },
      {
        "key": "due_date",
        "label": "Due Date"
      },
      {
        "key": "purchase_number",
        "label": "Purchase Number"
      },
      {
        "key": "vendor",
        "label": "Vendor"
      },
      {
        "key": "status",
        "label": "Status"
      },
      {
        "key": "paid",
        "label": "Paid"
      },
      {
        "key": "amount",
        "label": "Amount"
      },
      {
        "key": "owner",
        "label": "Owner"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "purchase_order_history"
  }
}

Returns one row per purchase with its dates, vendor, status, and monetary totals (paid, amount). When no date filter is provided, the report defaults to the last 30 days.

Every value is returned as it appears in the report's CSV export, with numeric cells (monetary amounts) parsed into numbers. Companies on a compliance integration (Metrc or BioTrack) get an additional manifest number column, and any Purchase custom fields configured for the company are appended as extra columns. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_purchase_order_history.

Request

GET /public/v1/reports/purchase-order-history

Parameters

Parameter Description In Type Required Default Example
batch_ids Filter by batch IDs query array false
company_relationship_ids Filter by vendor (company relationship) IDs query array false
created_datetime Filter by purchase creation date range (comma-separated ISO8601 range) query string false
creator_ids Filter by purchase creator (user) IDs query array false
due_datetime Filter by due date range (comma-separated ISO8601 range) query string false
location_ids Filter by receiving warehouse (location) IDs query array false
order_datetime Filter by purchase date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
owner_ids Filter by purchase owner (user) IDs query array false
paid Filter by paid amount range (comma-separated min,max) query string false
product_ids Filter by product IDs query array false
search Search by purchase number query string false
status Filter by purchase status query array false ["COMPLETED","DELIVERING"]
total Filter by purchase total range (comma-separated min,max) query string false 100,500
updated_datetime Filter by purchase last-modified date range (comma-separated ISO8601 range) query string false

Responses

Status Description Schema
200 The Purchase Order History report PurchaseOrderHistoryReport

Get the Purchases By Company report

GET /public/v1/reports/purchases-by-company returns one row per vendor as {data, meta}, narrowed by the applied filters

GET /public/v1/reports/purchases-by-company?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjgsImlhdCI6MTc4NzE0NTU2OCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOWEwMGI4NjEtMWRkMi00MGFkLWFiZjMtNDgwODhkZDc2ZDYyIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY3LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzQ1MSIsInR5cCI6ImFjY2VzcyJ9.o50x5cXMkFeSBBvNB74Yk8C_65Y_gUMYMM1T28jhAv4

Response

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

{
  "data": [
    {
      "category": "Retail",
      "last_purchase_date": "7/15/2026",
      "name": "Alpha",
      "product_owner": "FirstName1104 LastName1105",
      "purchase_order_count": 2,
      "relationship_type": null,
      "total_purchases": 1.5e3
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "name",
        "label": "Name"
      },
      {
        "key": "last_purchase_date",
        "label": "Last Purchase Date"
      },
      {
        "key": "purchase_order_count",
        "label": "Purchase Order Count"
      },
      {
        "key": "total_purchases",
        "label": "Total Purchases"
      },
      {
        "key": "product_owner",
        "label": "Product Owner"
      },
      {
        "key": "category",
        "label": "Category"
      },
      {
        "key": "relationship_type",
        "label": "Relationship Type"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "purchases_by_company"
  }
}

Returns one row per vendor (company relationship) with its last purchase date, purchase order count, and total purchases over the reported date range. When no date filter is provided, the report defaults to the last 30 days. Draft purchases are excluded.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Any CompanyRelationship custom fields configured for the company are appended as extra columns. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_purchases_by_company.

Request

GET /public/v1/reports/purchases-by-company

Parameters

Parameter Description In Type Required Default Example
company_relationship_group_ids Filter by vendor group IDs query array false
order_datetime Filter by purchase date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
owner_ids Filter by purchase owner (sales rep) IDs query array false
search Search by vendor (related company) name query string false

Responses

Status Description Schema
200 The Purchases By Company report PurchasesByCompanyReport

Get the Purchases By Product report

GET /public/v1/reports/purchases-by-product returns one row per purchased product as {data, meta}, narrowed by the applied filters

GET /public/v1/reports/purchases-by-product?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYmQ0YzY2ZTEtYTc5OS00ZWExLTllZDUtZWRlZmI3MTdjMWQ5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzg0MSIsInR5cCI6ImFjY2VzcyJ9.ifbMAcs4axWAU_P2WBALpY_wd_H4ngRrik7yGvReJPM

Response

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

{
  "data": [
    {
      "category": "Some category 149",
      "group": "Product Group 137",
      "name": "Alpha",
      "owner": "FirstName1886 LastName1887",
      "quantity_purchased": 4,
      "sale_price": 1.0,
      "sku": "sku 323",
      "subcategory": "Some subcategory 140",
      "total_purchased": 40.0,
      "unit_cost": null,
      "unit_type": "Gram",
      "vendor": "Company 750",
      "wholesale_price": null
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "name",
        "label": "Name"
      },
      {
        "key": "sku",
        "label": "SKU"
      },
      {
        "key": "quantity_purchased",
        "label": "Quantity Purchased"
      },
      {
        "key": "total_purchased",
        "label": "Total Purchased"
      },
      {
        "key": "unit_type",
        "label": "Unit Type"
      },
      {
        "key": "category",
        "label": "Category"
      },
      {
        "key": "subcategory",
        "label": "Subcategory"
      },
      {
        "key": "group",
        "label": "Group"
      },
      {
        "key": "vendor",
        "label": "Vendor"
      },
      {
        "key": "owner",
        "label": "Owner"
      },
      {
        "key": "unit_cost",
        "label": "Unit Cost"
      },
      {
        "key": "sale_price",
        "label": "Sale Price"
      },
      {
        "key": "wholesale_price",
        "label": "Wholesale Price"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "purchases_by_product"
  }
}

Returns one row per purchased product with its quantity purchased and total purchased (purchase item quantities times price) over the reported date range, alongside the product's descriptive attributes (SKU, unit type, category, subcategory, group, vendor, owner, unit cost, sale price, and wholesale price). When no date filter is provided, the report defaults to the last 30 days. Draft purchases are excluded.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Any Product custom fields configured for the company are appended as extra columns. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_purchases_by_product.

Request

GET /public/v1/reports/purchases-by-product

Parameters

Parameter Description In Type Required Default Example
location_ids Filter by the purchase location IDs query array false
order_datetime Filter by purchase date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
owner_ids Filter by purchase owner (sales rep) IDs query array false
search Search by product name or SKU query string false

Responses

Status Description Schema
200 The Purchases By Product report PurchasesByProductReport

Get the Sales By Company report

GET /public/v1/reports/sales-by-company returns one row per customer as {data, meta}, narrowed by the applied filters

GET /public/v1/reports/sales-by-company?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMGY2NTk2ZGYtOWY4OS00NGM0LWIyZTQtZmZhNDRiMjFkMTM3IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzIxNyIsInR5cCI6ImFjY2VzcyJ9.D9nC8yNPQjsbE0okf8ykn2psng_dUQsqygghQ6zpAu4

Response

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

{
  "data": [
    {
      "category": "Manufacturer",
      "last_order_date": "7/15/2026",
      "name": "Alpha",
      "order_count": 3,
      "owner": "FirstName634 LastName635",
      "relationship_type": null,
      "total_received": 0.0,
      "total_sales": 1.8e3
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "name",
        "label": "Name"
      },
      {
        "key": "last_order_date",
        "label": "Last Order Date"
      },
      {
        "key": "order_count",
        "label": "Order Count"
      },
      {
        "key": "total_received",
        "label": "Total Received"
      },
      {
        "key": "total_sales",
        "label": "Total Sales"
      },
      {
        "key": "owner",
        "label": "Owner"
      },
      {
        "key": "category",
        "label": "Category"
      },
      {
        "key": "relationship_type",
        "label": "Relationship Type"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "sales_by_company"
  }
}

Returns one row per customer (company relationship) with its last order date, order count, total received (payments), and total sales (order totals net of returns) over the reported date range. When no date filter is provided, the report defaults to the last 30 days. Canceled orders are excluded unless the status filter explicitly requests them.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Any CompanyRelationship custom fields configured for the company are appended as extra columns. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_sales_by_company.

Request

GET /public/v1/reports/sales-by-company

Parameters

Parameter Description In Type Required Default Example
company_relationship_group_ids Filter by customer group IDs query array false
order_datetime Filter by order date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
owner_ids Filter by order owner (sales rep) IDs query array false
search Search by customer (related company) name query string false
status Filter by sales order status query array false ["COMPLETED","DELIVERED"]

Responses

Status Description Schema
200 The Sales By Company report SalesByCompanyReport

Get the Sales By Product report

GET /public/v1/reports/sales-by-product returns one row per product as {data, meta}, narrowed by the applied filters

GET /public/v1/reports/sales-by-product?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjZjOTdiNmEtMmZhNi00YjhiLTkzNmUtNDhkMTczYzhkY2VkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk3MiIsInR5cCI6ImFjY2VzcyJ9.03nPuiXN2RCf-Z7GOuBOaKqZivFzhTDcjGNFVcCQtUs

Response

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

{
  "data": [
    {
      "category": "Some category 8",
      "group": "Product Group 9",
      "name": "Beta",
      "product_owner": "FirstName160 LastName161",
      "quantity_sold": 3,
      "sale_price": 1.0,
      "shipped_from_license": null,
      "sku": "sku 25",
      "subcategory": "Some subcategory 9",
      "total_sales": 60.0,
      "unit_cost": null,
      "unit_type": "Gram",
      "upc": null,
      "vendor": "Company 88",
      "wholesale_price": null
    },
    {
      "category": "Some category 6",
      "group": "Product Group 8",
      "name": "Alpha",
      "product_owner": "FirstName148 LastName149",
      "quantity_sold": 4,
      "sale_price": 1.0,
      "shipped_from_license": null,
      "sku": "sku 19",
      "subcategory": "Some subcategory 6",
      "total_sales": 40.0,
      "unit_cost": null,
      "unit_type": "Gram",
      "upc": null,
      "vendor": "Company 86",
      "wholesale_price": null
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "name",
        "label": "Name"
      },
      {
        "key": "sku",
        "label": "SKU"
      },
      {
        "key": "quantity_sold",
        "label": "Quantity Sold"
      },
      {
        "key": "total_sales",
        "label": "Total Sales"
      },
      {
        "key": "unit_type",
        "label": "Unit Type"
      },
      {
        "key": "category",
        "label": "Category"
      },
      {
        "key": "subcategory",
        "label": "Subcategory"
      },
      {
        "key": "group",
        "label": "Group"
      },
      {
        "key": "vendor",
        "label": "Vendor"
      },
      {
        "key": "product_owner",
        "label": "Product Owner"
      },
      {
        "key": "unit_cost",
        "label": "Unit Cost"
      },
      {
        "key": "sale_price",
        "label": "Sale Price"
      },
      {
        "key": "wholesale_price",
        "label": "Wholesale Price"
      },
      {
        "key": "shipped_from_license",
        "label": "Shipped From License"
      },
      {
        "key": "upc",
        "label": "UPC"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "sales_by_product"
  }
}

Returns one row per product with its quantity sold and total sales (order item quantities times price, net of returns) over the reported date range, alongside the product's descriptive attributes (SKU, unit type, category, subcategory, group, vendor, owner, unit cost, sale price, wholesale price, shipped-from license, and UPC). When no date filter is provided, the report defaults to the last 30 days. Canceled orders are excluded unless the status filter explicitly requests them.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Any Product custom fields configured for the company are appended as extra columns. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_sales_by_product.

Request

GET /public/v1/reports/sales-by-product

Parameters

Parameter Description In Type Required Default Example
customer_ids Filter by customer (company relationship) IDs query array false
exclude_customer_ids Exclude sales to these customer (company relationship) IDs query array false
location_ids Filter by the order item location IDs query array false
order_datetime Filter by order date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
owner_ids Filter by order owner (sales rep) IDs query array false
search Search by product name or SKU query string false
shipped_from_license_ids Filter by the shipped-from license IDs query array false
status Filter by sales order status query array false ["COMPLETED","DELIVERED"]
user_ids Filter by the order item user IDs query array false

Responses

Status Description Schema
200 The Sales By Product report SalesByProductReport

Get the Sales By User report

GET /public/v1/reports/sales-by-user returns one row per user as {data, meta}, ranked by sales and narrowed by filters

GET /public/v1/reports/sales-by-user?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z&user_ids[]=00000000-0000-0000-0000-000000001afd&user_ids[]=00000000-0000-0000-0000-000000001b00
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjUsImlhdCI6MTc4NzE0NTU2NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjVmZjY5ZmItMjAxNC00MGJiLWJkOWUtY2M4OWFlMThhMGFkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NjkwMiIsInR5cCI6ImFjY2VzcyJ9.BZ5XKI8jrr_dI95aMsnVHW9d8vDOeuuKpOmYaR0pfiw

Response

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

{
  "data": [
    {
      "leaderboard_rank": 1,
      "order_count": 2,
      "sales_pre_tax": 50.0,
      "total_sales": 150.0,
      "user": "Alice Rep"
    },
    {
      "leaderboard_rank": 2,
      "order_count": 1,
      "sales_pre_tax": 30.0,
      "total_sales": 30.0,
      "user": "Bob Rep"
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "leaderboard_rank",
        "label": "Leaderboard Rank"
      },
      {
        "key": "user",
        "label": "User"
      },
      {
        "key": "order_count",
        "label": "Order Count"
      },
      {
        "key": "sales_pre_tax",
        "label": "Sales (Pre-Tax)"
      },
      {
        "key": "total_sales",
        "label": "Total Sales"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "sales_by_user"
  }
}

Returns one row per user (sales rep) with its leaderboard rank, order count, pre-tax sales, and total sales (order totals net of returns) over the reported date range. Users are ranked by total sales, with the top seller at rank 1. When no date filter is provided, the report defaults to the last 30 days. Canceled orders are excluded unless the status filter explicitly requests them.

Every value is returned as it appears in the report's CSV export, with numeric cells parsed into numbers. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_sales_by_user.

Request

GET /public/v1/reports/sales-by-user

Parameters

Parameter Description In Type Required Default Example
order_datetime Filter by order date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
search Search by order number or customer name query string false
status Filter by sales order status query array false ["COMPLETED","DELIVERED"]
user_ids Filter by user (sales rep) IDs query array false

Responses

Status Description Schema
200 The Sales By User report SalesByUserReport

Get the Sales Order History report

GET /public/v1/reports/sales-order-history returns one row per order as {data, meta}, narrowed by the applied filters

GET /public/v1/reports/sales-order-history?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjUsImlhdCI6MTc4NzE0NTU2NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZjg5YTQzN2ItOGI0OS00YTBmLWEwOTktOTU4ODg3NDM2MjFhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NjkxOSIsInR5cCI6ImFjY2VzcyJ9.8z3ovyPTeeImXjp-lZQ375QaWpdOHhPE_4dqxG6WDsI

Response

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

{
  "data": [
    {
      "charges_taxes_not_included": 0.0,
      "customer": "Company 18",
      "delivery_date": null,
      "delivery_date_utc": null,
      "discounts_taxes_not_included": 0.0,
      "due_date": "2026-08-19T06:19:25.921089",
      "due_date_utc": "2026-08-19T13:19:25.921089Z",
      "order_date": "2026-07-01T05:00:00.000000",
      "order_date_utc": "2026-07-01T12:00:00.000000Z",
      "order_number": "SO-1",
      "outstanding": 1.0e3,
      "owner": null,
      "paid": 0.0,
      "returns": 0.0,
      "status": "COMPLETED",
      "subtotal": 0.0,
      "taxes": 0.0,
      "total": 1.0e3
    },
    {
      "charges_taxes_not_included": 0.0,
      "customer": "Company 21",
      "delivery_date": null,
      "delivery_date_utc": null,
      "discounts_taxes_not_included": 0.0,
      "due_date": "2026-08-19T06:19:25.937598",
      "due_date_utc": "2026-08-19T13:19:25.937598Z",
      "order_date": "2026-07-01T05:00:00.000000",
      "order_date_utc": "2026-07-01T12:00:00.000000Z",
      "order_number": "SO-2",
      "outstanding": 500.0,
      "owner": null,
      "paid": 0.0,
      "returns": 0.0,
      "status": "PENDING",
      "subtotal": 0.0,
      "taxes": 0.0,
      "total": 500.0
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "order_date",
        "label": "Order Date"
      },
      {
        "key": "order_date_utc",
        "label": "Order Date (UTC)"
      },
      {
        "key": "delivery_date",
        "label": "Delivery Date"
      },
      {
        "key": "delivery_date_utc",
        "label": "Delivery Date (UTC)"
      },
      {
        "key": "due_date",
        "label": "Due Date"
      },
      {
        "key": "due_date_utc",
        "label": "Due Date (UTC)"
      },
      {
        "key": "order_number",
        "label": "Order Number"
      },
      {
        "key": "customer",
        "label": "Customer"
      },
      {
        "key": "status",
        "label": "Status"
      },
      {
        "key": "paid",
        "label": "Paid"
      },
      {
        "key": "outstanding",
        "label": "Outstanding"
      },
      {
        "key": "subtotal",
        "label": "Subtotal"
      },
      {
        "key": "taxes",
        "label": "Taxes"
      },
      {
        "key": "discounts_taxes_not_included",
        "label": "Discounts (taxes not included)"
      },
      {
        "key": "charges_taxes_not_included",
        "label": "Charges (taxes not included)"
      },
      {
        "key": "returns",
        "label": "Returns"
      },
      {
        "key": "total",
        "label": "Total"
      },
      {
        "key": "owner",
        "label": "Owner"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "sales_order_history"
  }
}

Returns one row per sales order with its dates, customer, status, and monetary totals (paid, outstanding, subtotal, taxes, discounts, charges, returns, total). When no date filter is provided, the report defaults to the last 30 days.

Every value is returned as it appears in the report's CSV export, with numeric cells (monetary amounts) parsed into numbers. Companies on a compliance integration (Metrc or BioTrack) get additional manifest and shipped-from-license columns, and any Order custom fields configured for the company are appended as extra columns. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_sales_order_history.

Request

GET /public/v1/reports/sales-order-history

Parameters

Parameter Description In Type Required Default Example
batch_ids Filter by batch IDs query array false
brand_ids Filter by brand IDs query array false
company_relationship_group_ids Filter by customer group IDs query array false
company_relationship_ids Filter by customer (company relationship) IDs query array false
created_datetime Filter by order creation date range (comma-separated ISO8601 range) query string false
creator_ids Filter by order creator (user) IDs query array false
delivery_datetime Filter by delivery date range (comma-separated ISO8601 range) query string false
due_datetime Filter by due date range (comma-separated ISO8601 range) query string false
matched_with_compliance_transfer Filter by whether the order is matched with a compliance transfer query boolean false
menu_ids Filter by menu IDs query array false
order_datetime Filter by order date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
order_source Filter by the source that created the order query array false
owner_ids Filter by order owner (user) IDs query array false
payment_status Filter by payment status query array false ["FULLY_PAID"]
product_ids Filter by product IDs query array false
search Search by order number, customer name, or LeafLink short ID query string false
shipped_from_license_ids Filter by the shipped-from license IDs query array false
status Filter by sales order status query array false ["COMPLETED","DELIVERED"]
total Filter by order total range (comma-separated min,max) query string false 100,500
updated_datetime Filter by order last-modified date range (comma-separated ISO8601 range) query string false

Responses

Status Description Schema
200 The Sales Order History report SalesOrderHistoryReport

Get the Sales Order Item History report

GET /public/v1/reports/sales-order-item-history returns one row per line item as {data, meta}, narrowed by the applied filters

GET /public/v1/reports/sales-order-item-history?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMmIzOTU0YWUtYzQ3MC00YmIyLWIyMDItNTVlNTA4MDM2YWEzIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk3NSIsInR5cCI6ImFjY2VzcyJ9.-mLo95vIFAe8BQiOMSftvH5HcH1NGOwelEmBo0jKkQQ

Response

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

{
  "data": [
    {
      "batch_number": null,
      "brand": null,
      "brand_id": null,
      "category": "Some category 7",
      "customer": "Company 93",
      "customer_id": "00000000-0000-0000-0000-0000000014b4",
      "default_unit_cost": null,
      "default_unit_price": 1.0,
      "default_wholesale_price": null,
      "delivery_date": null,
      "delivery_date_utc": null,
      "due_date": "2026-08-19T06:19:26.428474",
      "due_date_utc": "2026-08-19T13:19:26.428474Z",
      "group": "Product Group 6",
      "invoice_numbers": null,
      "line_item_id": "9e543401-7f69-419b-ac69-f5fb1b31a2aa",
      "order_date": "2026-07-01T05:00:00.000000",
      "order_date_utc": "2026-07-01T12:00:00.000000Z",
      "order_id": "9ef263d5-657c-4af4-80b5-ac32b5be827c",
      "order_item_price": 10.0,
      "order_number": "SO-1",
      "product": "P1",
      "product_id": "f0e55ebf-66bb-4fbb-a0c3-c267c29074a4",
      "product_sku": "sku 21",
      "quantity": 3,
      "returned_quantity": 0,
      "sales_rep": null,
      "source_package": null,
      "status": "COMPLETED",
      "subcategory": "Some subcategory 7",
      "upc": null,
      "vendor": "Acme Vendor",
      "vendor_id": "00000000-0000-0000-0000-000000000d00"
    },
    {
      "batch_number": null,
      "brand": null,
      "brand_id": null,
      "category": "Some category 7",
      "customer": "Company 96",
      "customer_id": "00000000-0000-0000-0000-0000000014b7",
      "default_unit_cost": null,
      "default_unit_price": 1.0,
      "default_wholesale_price": null,
      "delivery_date": null,
      "delivery_date_utc": null,
      "due_date": "2026-08-19T06:19:26.440221",
      "due_date_utc": "2026-08-19T13:19:26.440221Z",
      "group": "Product Group 6",
      "invoice_numbers": null,
      "line_item_id": "dec064b2-c75a-44e9-8235-053b6916c22b",
      "order_date": "2026-07-01T05:00:00.000000",
      "order_date_utc": "2026-07-01T12:00:00.000000Z",
      "order_id": "33cfc830-1d50-4985-b6f6-2cce5cadaeed",
      "order_item_price": 10.0,
      "order_number": "SO-2",
      "product": "P1",
      "product_id": "f0e55ebf-66bb-4fbb-a0c3-c267c29074a4",
      "product_sku": "sku 21",
      "quantity": 2,
      "returned_quantity": 0,
      "sales_rep": null,
      "source_package": null,
      "status": "PENDING",
      "subcategory": "Some subcategory 7",
      "upc": null,
      "vendor": "Acme Vendor",
      "vendor_id": "00000000-0000-0000-0000-000000000d00"
    },
    {
      "batch_number": null,
      "brand": null,
      "brand_id": null,
      "category": "Some category 9",
      "customer": "Company 93",
      "customer_id": "00000000-0000-0000-0000-0000000014b4",
      "default_unit_cost": null,
      "default_unit_price": 1.0,
      "default_wholesale_price": null,
      "delivery_date": null,
      "delivery_date_utc": null,
      "due_date": "2026-08-19T06:19:26.428474",
      "due_date_utc": "2026-08-19T13:19:26.428474Z",
      "group": "Product Group 7",
      "invoice_numbers": null,
      "line_item_id": "eb76993b-114b-409e-8b63-ff04f84a73c0",
      "order_date": "2026-07-01T05:00:00.000000",
      "order_date_utc": "2026-07-01T12:00:00.000000Z",
      "order_id": "9ef263d5-657c-4af4-80b5-ac32b5be827c",
      "order_item_price": 10.0,
      "order_number": "SO-1",
      "product": "P2",
      "product_id": "9ce4345c-eb32-4704-95ba-685aae299aa3",
      "product_sku": "sku 23",
      "quantity": 5,
      "returned_quantity": 0,
      "sales_rep": null,
      "source_package": null,
      "status": "COMPLETED",
      "subcategory": "Some subcategory 8",
      "upc": null,
      "vendor": "Acme Vendor",
      "vendor_id": "00000000-0000-0000-0000-000000000d00"
    },
    {
      "batch_number": null,
      "brand": null,
      "brand_id": null,
      "category": "Some category 9",
      "customer": "Company 96",
      "customer_id": "00000000-0000-0000-0000-0000000014b7",
      "default_unit_cost": null,
      "default_unit_price": 1.0,
      "default_wholesale_price": null,
      "delivery_date": null,
      "delivery_date_utc": null,
      "due_date": "2026-08-19T06:19:26.440221",
      "due_date_utc": "2026-08-19T13:19:26.440221Z",
      "group": "Product Group 7",
      "invoice_numbers": null,
      "line_item_id": "9b506f88-9321-47cd-8e52-1b112fffb8f6",
      "order_date": "2026-07-01T05:00:00.000000",
      "order_date_utc": "2026-07-01T12:00:00.000000Z",
      "order_id": "33cfc830-1d50-4985-b6f6-2cce5cadaeed",
      "order_item_price": 10.0,
      "order_number": "SO-2",
      "product": "P2",
      "product_id": "9ce4345c-eb32-4704-95ba-685aae299aa3",
      "product_sku": "sku 23",
      "quantity": 1,
      "returned_quantity": 0,
      "sales_rep": null,
      "source_package": null,
      "status": "PENDING",
      "subcategory": "Some subcategory 8",
      "upc": null,
      "vendor": "Acme Vendor",
      "vendor_id": "00000000-0000-0000-0000-000000000d00"
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "line_item_id",
        "label": "Line Item Id"
      },
      {
        "key": "order_id",
        "label": "Order Id"
      },
      {
        "key": "order_date",
        "label": "Order Date"
      },
      {
        "key": "order_date_utc",
        "label": "Order Date (UTC)"
      },
      {
        "key": "delivery_date",
        "label": "Delivery Date"
      },
      {
        "key": "delivery_date_utc",
        "label": "Delivery Date (UTC)"
      },
      {
        "key": "due_date",
        "label": "Due Date"
      },
      {
        "key": "due_date_utc",
        "label": "Due Date (UTC)"
      },
      {
        "key": "order_number",
        "label": "Order Number"
      },
      {
        "key": "status",
        "label": "Status"
      },
      {
        "key": "product",
        "label": "Product"
      },
      {
        "key": "product_id",
        "label": "Product Id"
      },
      {
        "key": "product_sku",
        "label": "Product SKU"
      },
      {
        "key": "default_unit_cost",
        "label": "Default Unit Cost"
      },
      {
        "key": "default_unit_price",
        "label": "Default Unit Price"
      },
      {
        "key": "default_wholesale_price",
        "label": "Default Wholesale Price"
      },
      {
        "key": "brand",
        "label": "Brand"
      },
      {
        "key": "brand_id",
        "label": "Brand Id"
      },
      {
        "key": "vendor",
        "label": "Vendor"
      },
      {
        "key": "vendor_id",
        "label": "Vendor Id"
      },
      {
        "key": "order_item_price",
        "label": "Order Item Price"
      },
      {
        "key": "returned_quantity",
        "label": "Returned Quantity"
      },
      {
        "key": "quantity",
        "label": "Quantity"
      },
      {
        "key": "category",
        "label": "Category"
      },
      {
        "key": "subcategory",
        "label": "Subcategory"
      },
      {
        "key": "group",
        "label": "Group"
      },
      {
        "key": "customer",
        "label": "Customer"
      },
      {
        "key": "customer_id",
        "label": "Customer Id"
      },
      {
        "key": "sales_rep",
        "label": "Sales Rep"
      },
      {
        "key": "invoice_numbers",
        "label": "Invoice Numbers"
      },
      {
        "key": "upc",
        "label": "UPC"
      },
      {
        "key": "batch_number",
        "label": "Batch Number"
      },
      {
        "key": "source_package",
        "label": "Source Package"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "sales_order_item_history"
  }
}

Returns one row per sales order line item with its order dates, product, brand, vendor, customer, status, quantities, and prices. When no date filter is provided, the report defaults to the last 30 days.

Every value is returned as it appears in the report's CSV export, with numeric cells (quantities, prices) parsed into numbers. Companies on a compliance integration (Metrc or BioTrack) get additional package, potency, manifest, and shipped-from-license columns, and any Order custom fields configured for the company are appended as extra columns. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_sales_order_item_history.

Request

GET /public/v1/reports/sales-order-item-history

Parameters

Parameter Description In Type Required Default Example
batch_ids Filter by batch IDs query array false
brand_ids Filter by brand IDs query array false
company_relationship_group_ids Filter by customer group IDs query array false
company_relationship_ids Filter by customer (company relationship) IDs query array false
created_datetime Filter by order creation date range (comma-separated ISO8601 range) query string false
creator_ids Filter by order creator (user) IDs query array false
delivery_datetime Filter by delivery date range (comma-separated ISO8601 range) query string false
due_datetime Filter by due date range (comma-separated ISO8601 range) query string false
matched_with_compliance_transfer Filter by whether the order is matched with a compliance transfer query boolean false
menu_ids Filter by menu IDs query array false
order_datetime Filter by order date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
order_source Filter by the source that created the order query array false
owner_ids Filter by order owner (user) IDs query array false
payment_status Filter by payment status query array false ["FULLY_PAID"]
product_group_ids Filter line items by product group IDs query array false
product_ids Filter by product IDs query array false
sample Filter line items by whether they are samples query string false
search Search by order number, customer name, or LeafLink short ID query string false
shipped_from_license_ids Filter by the shipped-from license IDs query array false
status Filter by sales order status query array false ["COMPLETED","DELIVERED"]
total Filter by order total range (comma-separated min,max) query string false 100,500
trade_sample_packages Filter line items by whether their package is a trade sample query string false
updated_datetime Filter by order last-modified date range (comma-separated ISO8601 range) query string false

Responses

Status Description Schema
200 The Sales Order Item History report SalesOrderItemHistoryReport

Get the Sales Order Tax report

GET /public/v1/reports/sales-order-tax returns tax totals as {data, meta}, narrowed by the applied filters

GET /public/v1/reports/sales-order-tax?order_datetime=2026-06-01T00%3A00%3A00Z%2C2026-08-01T00%3A00%3A00Z
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYTM3YWRlNzctYjYwYy00YzU0LTk1ZDUtMDQxYmMxN2FlNDRkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzcyMSIsInR5cCI6ImFjY2VzcyJ9.j4nNLkhp7qkKB-lrzg4RcOyBAGyKP5Q_YgSRQJG-9zE

Response

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

{
  "data": [
    {
      "tax_rate": 5.0,
      "tax_type": "City Tax",
      "total_tax": 20.0
    },
    {
      "tax_rate": 27.0,
      "tax_type": "Excise Tax",
      "total_tax": 1099.0
    }
  ],
  "meta": {
    "columns": [
      {
        "key": "tax_type",
        "label": "Tax Type"
      },
      {
        "key": "tax_rate",
        "label": "Tax Rate"
      },
      {
        "key": "total_tax",
        "label": "Total Tax"
      }
    ],
    "date_range": "May 31, 2026 to Jul 31, 2026",
    "report": "sales_order_tax"
  }
}

Returns total tax collected on sales orders, grouped by tax type and rate. When no date filter is provided, the report defaults to the last 30 days.

Every value is returned as it appears in the report's CSV export, with numeric cells (rates, amounts) parsed into numbers. Report-level information (the resolved date range and column definitions) is returned under meta.

Required permission: reports_permissions_sales_order_tax.

Request

GET /public/v1/reports/sales-order-tax

Parameters

Parameter Description In Type Required Default Example
batch_ids Filter by batch IDs query array false
brand_ids Filter by brand IDs query array false
company_relationship_group_ids Filter by customer group IDs query array false
company_relationship_ids Filter by customer (company relationship) IDs query array false
created_datetime Filter by order creation date range (comma-separated ISO8601 range) query string false
creator_ids Filter by order creator (user) IDs query array false
delivery_datetime Filter by delivery date range (comma-separated ISO8601 range) query string false
due_datetime Filter by due date range (comma-separated ISO8601 range) query string false
matched_with_compliance_transfer Filter by whether the order is matched with a compliance transfer query boolean false
menu_ids Filter by menu IDs query array false
order_datetime Filter by order date range (comma-separated ISO8601 range) query string false 2026-01-01T00:00:00Z,2026-02-01T00:00:00Z
order_source Filter by the source that created the order query array false
owner_ids Filter by order owner (user) IDs query array false
payment_status Filter by payment status query array false ["FULLY_PAID"]
product_ids Filter by product IDs query array false
search Search by order number, customer name, or LeafLink short ID query string false
shipped_from_license_ids Filter by the shipped-from license IDs query array false
status Filter by sales order status query array false ["COMPLETED","DELIVERED"]
tax_ids Filter by tax IDs query array false
total Filter by order total range (comma-separated min,max) query string false 100,500
updated_datetime Filter by order last-modified date range (comma-separated ISO8601 range) query string false

Responses

Status Description Schema
200 The Sales Order Tax report SalesOrderTaxReport

Return

Get a return

GET /public/v1/returns/:id returns a single return

GET /public/v1/returns/00000000-0000-0000-0000-000000000040
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjksImlhdCI6MTc4NzE0NTU2OSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMTcwMWYxMDItNDM1NS00MTk0LWI1MDAtOTliMjY4MTZmYTY0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY4LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzg0MCIsInR5cCI6ImFjY2VzcyJ9.-DlYwobOgSoFpEJDt82DCtyVP_8pf5luuos8gQBaTow

Response

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

{
  "data": {
    "company": {
      "id": "00000000-0000-0000-0000-000000000e34",
      "name": "Company 749",
      "updated_datetime": "2026-08-19T13:19:29.780420Z"
    },
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-940@example.com",
      "full_name": "FirstName1878 LastName1879",
      "id": "00000000-0000-0000-0000-000000001ea2",
      "inserted_datetime": "2026-08-19T13:19:29.762059Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001f6a",
        "name": "Admin 1001"
      }
    },
    "credits": [
      {
        "amount": "100",
        "credit_number": "CRT-RET",
        "id": "4516513d-d2b8-4985-a34d-eb203f4a4d11",
        "source": "RETURN"
      }
    ],
    "custom_data": {},
    "description": null,
    "id": "00000000-0000-0000-0000-000000000040",
    "inserted_datetime": "2026-08-19T13:19:29.812355Z",
    "invoice_numbers": [
      "INV-001",
      "INV-002"
    ],
    "items": [
      {
        "id": "00000000-0000-0000-0000-00000000003d",
        "order_item": {
          "batch": {
            "batch_number": null,
            "id": "00000000-0000-0000-0000-0000000008cb",
            "name": "B321"
          },
          "compliance_quantity": null,
          "id": "2a4ad292-1836-4b01-ab87-170badf625be",
          "is_sample": false,
          "location": null,
          "package": null,
          "price": "10.000000000",
          "price_base": "10",
          "product": {
            "id": "793e2774-ffb1-4c32-af54-0c6955681bb5",
            "name": "Product 319",
            "sku": "sku 320",
            "updated_datetime": "2026-08-19T13:19:29.775593Z"
          },
          "quantity": "5.000000000"
        },
        "quantity": 5.0,
        "waste": false
      }
    ],
    "location": {
      "address": "123 Fake Street, Beverly Hills, CA 90210, US",
      "company_id": "00000000-0000-0000-0000-000000001743",
      "id": "00000000-0000-0000-0000-00000000071b",
      "license_id": null,
      "name": "Place 151"
    },
    "order": {
      "id": "b44c09af-ba16-49f4-a6ef-b90d49216c3c",
      "order_number": "SO-100",
      "status": "PROCESSING",
      "total": "0.00"
    },
    "order_quantity": "5",
    "owner": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-940@example.com",
      "full_name": "FirstName1878 LastName1879",
      "id": "00000000-0000-0000-0000-000000001ea2",
      "inserted_datetime": "2026-08-19T13:19:29.762059Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001f6a",
        "name": "Admin 1001"
      }
    },
    "qb_credit_memo_id": "QB-CM-1",
    "return_datetime": "2026-08-19T13:19:29.812093Z",
    "return_number": "RN-1",
    "return_quantity": "5",
    "return_type": "Full Return",
    "status": "PROCESSING",
    "total": 32.0,
    "updated_datetime": "2026-08-19T13:19:29.812355Z"
  }
}

Get a single return given the ID.

Required permission: returns_permissions_view.

Request

GET /public/v1/returns/{id}

Parameters

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

Responses

Status Description Schema
200 A single return ReturnResponse
404 Not Found

Get returns

GET /public/v1/returns renders invoice_numbers and credits for a return linked to an order

GET /public/v1/returns
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYjgwZDA0NzEtMzNlMi00NzJjLTliOTEtMWM3YzVkNTNiMTQxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Nzk5MyIsInR5cCI6ImFjY2VzcyJ9.76eKkxHyFtp6m07AIqiWnxYUlrBHifltsXIFcZy4rW0

Response

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

{
  "data": [
    {
      "company": {
        "id": "00000000-0000-0000-0000-000000000e6e",
        "name": "Company 856",
        "updated_datetime": "2026-08-19T13:19:30.408534Z"
      },
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-1093@example.com",
        "full_name": "FirstName2208 LastName2209",
        "id": "00000000-0000-0000-0000-000000001f3b",
        "inserted_datetime": "2026-08-19T13:19:30.385560Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000002002",
          "name": "Admin 1153"
        }
      },
      "credits": [
        {
          "amount": "100",
          "credit_number": "CRT-RET",
          "id": "8b8387c1-fced-446d-a6f7-b848ba3d05ec",
          "source": "RETURN"
        }
      ],
      "custom_data": {},
      "description": null,
      "id": "00000000-0000-0000-0000-00000000004a",
      "inserted_datetime": "2026-08-19T13:19:30.442801Z",
      "invoice_numbers": [
        "INV-001",
        "INV-002"
      ],
      "items": [
        {
          "id": "00000000-0000-0000-0000-000000000047",
          "order_item": {
            "batch": {
              "batch_number": null,
              "id": "00000000-0000-0000-0000-0000000008eb",
              "name": "B415"
            },
            "compliance_quantity": null,
            "id": "1dd82f4d-281a-40e3-b632-2b17c3937c7d",
            "is_sample": false,
            "location": null,
            "package": null,
            "price": "10.000000000",
            "price_base": "10",
            "product": {
              "id": "015a9a88-a327-4034-a0f2-959047521072",
              "name": "Product 413",
              "sku": "sku 414",
              "updated_datetime": "2026-08-19T13:19:30.402100Z"
            },
            "quantity": "10.000000000"
          },
          "quantity": 10.0,
          "waste": false
        }
      ],
      "location": {
        "address": "123 Fake Street, Beverly Hills, CA 90210, US",
        "company_id": "00000000-0000-0000-0000-0000000017aa",
        "id": "00000000-0000-0000-0000-000000000750",
        "license_id": null,
        "name": "Place 204"
      },
      "order": {
        "id": "7e82da76-34e5-47d9-9501-a208a222b9c3",
        "order_number": "SO-100",
        "status": "PROCESSING",
        "total": "0.00"
      },
      "order_quantity": "10",
      "owner": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-1093@example.com",
        "full_name": "FirstName2208 LastName2209",
        "id": "00000000-0000-0000-0000-000000001f3b",
        "inserted_datetime": "2026-08-19T13:19:30.385560Z",
        "role": {
          "id": "00000000-0000-0000-0000-000000002002",
          "name": "Admin 1153"
        }
      },
      "qb_credit_memo_id": null,
      "return_datetime": "2026-08-19T13:19:30.442636Z",
      "return_number": "RN-11",
      "return_quantity": "10",
      "return_type": "Full Return",
      "status": "PROCESSING",
      "total": 32.0,
      "updated_datetime": "2026-08-19T13:19:30.442801Z"
    }
  ],
  "next_page": null
}

List returns, most recent first, with optional filters.

A return is product a customer sends back, which reverses the related inventory and financials (often generating a credit). Returns are usually tied to the original order.

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

Required permission: returns_permissions_view.

Request

GET /public/v1/returns

Parameters

Parameter Description In Type Required Default Example
inserted_datetime Filter returns by their creation datetime query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1
return_datetime Filter returns by their return datetime query string false 2022-07-10T00:00:00Z,
updated_datetime Filter returns by the datetime they were most recently modified query string false ,2022-07-10T00:00:00Z

Responses

Status Description Schema
200 A list of returns Returns

StockAdjustment

Get a stock adjustment

GET /public/v1/adjustments/:id returns a single stock adjustment

GET /public/v1/adjustments/00000000-0000-0000-0000-0000000001cb
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzIsImlhdCI6MTc4NzE0NTU3MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZGZiNGI5MDQtODNjZC00YjM3LWIxMGYtMzI1OThlMjYwMTFiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODUzMyIsInR5cCI6ImFjY2VzcyJ9.LCcuo7Tk8WpgRDawZwF5YAZKBd3Y10-Tb7R5Q1z7lIc

Response

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

{
  "data": {
    "batch_id": "00000000-0000-0000-0000-00000000095c",
    "completion_datetime": "2026-08-19T13:19:32.414455Z",
    "compliance_quantity": null,
    "compliance_unit_type": null,
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-1637@example.com",
      "full_name": "FirstName3340 LastName3341",
      "id": "00000000-0000-0000-0000-00000000215d",
      "inserted_datetime": "2026-08-19T13:19:32.413025Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000002233",
        "name": "Admin 1714"
      }
    },
    "description": null,
    "id": "00000000-0000-0000-0000-0000000001cb",
    "inserted_datetime": "2026-08-19T13:19:32.415388Z",
    "license_id": null,
    "location_id": "00000000-0000-0000-0000-0000000007b3",
    "owner_id": null,
    "package_id": null,
    "product_id": "2786b432-cb5a-45f8-95e7-fc70619eb1a7",
    "quantity": "10",
    "reason": "revaluation",
    "total_cost": null,
    "unit_cost": null,
    "unit_type": {
      "id": "00000000-0000-0000-0000-000000013da3",
      "name": "Gram"
    },
    "updated_datetime": "2026-08-19T13:19:32.415388Z"
  }
}

Get a single stock adjustment given the ID.

Required permission: products_permissions_view.

Request

GET /public/v1/adjustments/{id}

Parameters

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

Responses

Status Description Schema
200 A single stock adjustment StockAdjustmentResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzIsImlhdCI6MTc4NzE0NTU3MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYzc3MmNhODEtYWMzMi00NmFkLWFkZTAtN2UzNGU1OWRhMjlhIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODY0NyIsInR5cCI6ImFjY2VzcyJ9.8TY-wMI8vFAFIiO44QEQ7mt2evGSe5RsElzhnzbjU8A

Response

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

{
  "data": [
    {
      "batch_id": null,
      "completion_datetime": "2026-08-19T13:19:32.869634Z",
      "compliance_quantity": null,
      "compliance_unit_type": null,
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-1751@example.com",
        "full_name": "FirstName3568 LastName3569",
        "id": "00000000-0000-0000-0000-0000000021d0",
        "inserted_datetime": "2026-08-19T13:19:32.867818Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000022ad",
          "name": "Admin 1836"
        }
      },
      "description": null,
      "id": "00000000-0000-0000-0000-0000000001dc",
      "inserted_datetime": "2026-08-19T13:19:32.870662Z",
      "license_id": null,
      "location_id": null,
      "owner_id": "00000000-0000-0000-0000-0000000021c7",
      "package_id": null,
      "product_id": "3734627e-5ce9-462d-b89a-153019f01cc6",
      "quantity": "10",
      "reason": "revaluation",
      "total_cost": "10000",
      "unit_cost": "1000",
      "unit_type": {
        "id": "00000000-0000-0000-0000-00000001417c",
        "name": "Gram"
      },
      "updated_datetime": "2026-08-19T13:19:32.870662Z"
    },
    {
      "batch_id": null,
      "completion_datetime": "2026-08-19T13:19:32.997925Z",
      "compliance_quantity": "1",
      "compliance_unit_type": {
        "id": "00000000-0000-0000-0000-00000001417e",
        "name": "Ounce"
      },
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-1742@example.com",
        "full_name": "FirstName3550 LastName3551",
        "id": "00000000-0000-0000-0000-0000000021c7",
        "inserted_datetime": "2026-08-19T13:19:32.833416Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000022a4",
          "name": "Admin 1827"
        }
      },
      "description": "A default note describing this transaction",
      "id": "00000000-0000-0000-0000-0000000001e6",
      "inserted_datetime": "2026-08-19T13:19:33.003560Z",
      "license_id": "00000000-0000-0000-0000-0000000001fe",
      "location_id": "00000000-0000-0000-0000-0000000007d0",
      "owner_id": null,
      "package_id": "00000000-0000-0000-0000-000000000131",
      "product_id": "5a0e488d-efaf-48e8-8f1a-fa7e2048a5a3",
      "quantity": "1",
      "reason": "Voluntary Surrender",
      "total_cost": "900",
      "unit_cost": "900",
      "unit_type": {
        "id": "00000000-0000-0000-0000-00000001417e",
        "name": "Ounce"
      },
      "updated_datetime": "2026-08-19T13:19:33.003560Z"
    },
    {
      "batch_id": "00000000-0000-0000-0000-000000000988",
      "completion_datetime": "2026-08-19T13:19:33.080548Z",
      "compliance_quantity": null,
      "compliance_unit_type": null,
      "creator": {
        "banned": false,
        "deleted_at": null,
        "email": "owner-1797@example.com",
        "full_name": "FirstName3660 LastName3661",
        "id": "00000000-0000-0000-0000-0000000021fe",
        "inserted_datetime": "2026-08-19T13:19:33.079223Z",
        "role": {
          "id": "00000000-0000-0000-0000-0000000022dc",
          "name": "Admin 1883"
        }
      },
      "description": null,
      "id": "00000000-0000-0000-0000-0000000001ed",
      "inserted_datetime": "2026-08-19T13:19:33.081608Z",
      "license_id": null,
      "location_id": "00000000-0000-0000-0000-0000000007cd",
      "owner_id": null,
      "package_id": null,
      "product_id": "16858f29-f215-41b1-8d50-1cd595c10987",
      "quantity": "1",
      "reason": "revaluation",
      "total_cost": "-800",
      "unit_cost": "-800",
      "unit_type": {
        "id": "00000000-0000-0000-0000-00000001417c",
        "name": "Gram"
      },
      "updated_datetime": "2026-08-19T13:19:33.081608Z"
    }
  ],
  "next_page": null
}

List stock adjustments, oldest first, with optional filters.

A stock adjustment is a manual change to on-hand inventory that isn't a sale, purchase, or transfer — for example recording waste, theft, damage, a physical recount, or a reconciliation with the state compliance system.

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.

Required permission: products_permissions_view.

Request

GET /public/v1/adjustments

Parameters

Parameter Description In Type Required Default Example
completion_datetime Filter stock adjustments by their completion datetime (adjustment date) query string false 2022-07-10T00:00:00Z,
inserted_datetime Filter stock adjustments by their creation datetime query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzIsImlhdCI6MTc4NzE0NTU3MiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMWU4ODA3YjQtZDQ5ZC00MWUwLWI0NjMtYmRmZTUwZmYwOTRiIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcxLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODYwMiIsInR5cCI6ImFjY2VzcyJ9.cV3_Krl4Cgh3lmMJcU2em-cl-JULal6ev1whnMV0ckM

{
  "completion_datetime": "2020-01-03T12:20:00.000000Z",
  "description": "test",
  "location_id": "00000000-0000-0000-0000-0000000007c3",
  "product_id": "a6ced06a-52ff-43b4-93eb-68efcb6a5887",
  "quantity": 10,
  "reason": "expired"
}

Response

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

{
  "data": {
    "batch_id": null,
    "completion_datetime": "2020-01-03T12:20:00.000000Z",
    "compliance_quantity": null,
    "compliance_unit_type": null,
    "creator": {
      "banned": false,
      "deleted_at": null,
      "email": "owner-1697@example.com",
      "full_name": "FirstName3460 LastName3461",
      "id": "00000000-0000-0000-0000-00000000219a",
      "inserted_datetime": "2026-08-19T13:19:32.637519Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000002275",
        "name": "Admin 1780"
      }
    },
    "description": "test",
    "id": "00000000-0000-0000-0000-0000000001cf",
    "inserted_datetime": "2026-08-19T13:19:32.667679Z",
    "license_id": null,
    "location_id": "00000000-0000-0000-0000-0000000007c3",
    "owner_id": null,
    "package_id": null,
    "product_id": "a6ced06a-52ff-43b4-93eb-68efcb6a5887",
    "quantity": "10",
    "reason": "expired",
    "total_cost": null,
    "unit_cost": null,
    "unit_type": {
      "id": "00000000-0000-0000-0000-000000014007",
      "name": "Gram"
    },
    "updated_datetime": "2026-08-19T13:19:32.667679Z"
  }
}

Record a stock adjustment — a manual change to on-hand inventory that isn't a sale, purchase, or transfer (for example waste, theft, damage, a recount, or a compliance reconciliation).

Identify what to adjust with exactly one of product_id, batch_id, or package_id, matching how the product's inventory is tracked (product-, batch-, or package-tracked). Non-compliance adjustments use quantity (negative removes inventory, positive adds it) and a location_id; compliance adjustments (package-tracked) use compliance_quantity and a completion_datetime.

Required permission: products_permissions_adjust_inventory.

Request

POST /public/v1/adjustments

Parameters

Parameter Description In Type Required Default Example
batch_id The ID of the batch to adjust. Must only be provided if the batch's associated product is batch-tracked. body string false
completion_datetime The datetime of the stock adjustment. Must only be provided for compliance adjustments. body string false
compliance_quantity The amount to adjust stock by, expressed in the package's unit type. Use this for package (compliance) adjustments: it is required when package_id is set, and must be null when package_id is not set (use quantity instead). body number false
description The description of the stock adjustment. Required for compliance adjustments. Has a max length of 800 characters for non-compliance adjustments, and 250 characters for compliance adjustments. body string false
location_id The ID of the source location of the stock adjustment. Must only be provided for non-compliance adjustments. body string false
package_id The ID of the package to adjust. Must only be provided if the package's associated product is package-tracked. body string false
product_id The ID of the product to adjust. Must only be provided if the product is product-tracked. body string false
quantity The amount to adjust stock by, expressed in the product's unit type. Use this for non-package adjustments: it is required when package_id is not set, and must be null when package_id is set (use compliance_quantity instead). Must be negative if the adjustment reason is 'waste'. body number 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 compliance API body 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. body number false

Responses

Status Description Schema
200 The stock adjustment was inserted successfully StockAdjustmentResponse

Strain

Create or update a strain

POST /public/v1/strains creates a strain

POST /public/v1/strains
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDczYjE2NmItY2ZiZS00NTZkLWEwOWYtZGI0OTA4YzlhZmI4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzA1NiIsInR5cCI6ImFjY2VzcyJ9.9ZKJpCoAkzfK5My_tXcSaFOplcNV2Eg_f2lhWArgM4g

{
  "name": "Blue Dream",
  "strain_type": "HYBRID"
}

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-00000000006f",
    "inserted_datetime": "2026-08-19T13:19:26.727075Z",
    "name": "Blue Dream",
    "strain_type": "HYBRID",
    "updated_datetime": "2026-08-19T13:19:26.727075Z"
  }
}

Create or update a strain. Omit id to create a new strain (name is then required); pass the id of an existing strain to update it in place.

Required permission: settings_permissions_strains.

Request

POST /public/v1/strains

Parameters

Parameter Description In Type Required Default Example
id The ID of the strain to update. Omit to create a new strain. body string false
name Name of the strain. Required when creating. body string false
strain_type The strain's genetic classification: pure indica or sativa, an indica- or sativa-dominant hybrid, a balanced hybrid, or a high-CBD variety. body string false

Responses

Status Description Schema
200 The created or updated strain StrainResponse
400 Invalid parameters
404 Not Found

Get a strain

GET /public/v1/strains/:id returns a single strain

GET /public/v1/strains/00000000-0000-0000-0000-000000000055
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGJmOGQ4YmItODIzOS00ODVlLTg0MDUtODI4ZDQ3MzY4ODIwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NjkyOCIsInR5cCI6ImFjY2VzcyJ9.eusjME0I996KzHdO1LUOMf21scgUIhxhik_lewWgc6I

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000055",
    "inserted_datetime": "2026-08-19T13:19:26.108603Z",
    "name": "Blue Dream",
    "strain_type": "HYBRID",
    "updated_datetime": "2026-08-19T13:19:26.108603Z"
  }
}

Get a single strain given the ID.

Required permission: settings_permissions_strains.

Request

GET /public/v1/strains/{id}

Parameters

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

Responses

Status Description Schema
200 A single strain StrainResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZDgyYjhjZTQtOWFhYy00MWY2LTlhMzItN2E2N2MxY2Q3YmRkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzA3MyIsInR5cCI6ImFjY2VzcyJ9.Nw1Qeo42cCqzQYMKGQG3MgzazKdggYRNp6nQxlGFvK4

Response

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

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000072",
      "inserted_datetime": "2026-08-19T13:19:26.865180Z",
      "name": "Strain 26",
      "strain_type": "INDICA",
      "updated_datetime": "2026-08-19T13:19:26.865180Z"
    },
    {
      "id": "00000000-0000-0000-0000-000000000073",
      "inserted_datetime": "2026-08-19T13:19:26.867178Z",
      "name": "Strain 27",
      "strain_type": null,
      "updated_datetime": "2026-08-19T13:19:26.867178Z"
    }
  ],
  "next_page": null
}

Get strains filtered by various attributes

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

Required permission: settings_permissions_strains.

Request

GET /public/v1/strains

Parameters

Parameter Description In Type Required Default Example
inserted_datetime Filter by creation datetime. Accepts a comma-separated from,to range (ISO-8601 UTC); either side may be omitted, e.g. 2022-07-10T00:00:00Z, returns strains created on or after that time. query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1
updated_datetime Filter by last-modified datetime. Accepts a comma-separated from,to range (ISO-8601 UTC); either side may be omitted, e.g. ,2022-07-10T00:00:00Z returns strains last modified on or before that time. query string false ,2022-07-10T00:00:00Z

Responses

Status Description Schema
200 A list of strains Strains

Tag

Delete a tag

DELETE /public/v1/tags/:id deletes a tag

DELETE /public/v1/tags/00000000-0000-0000-0000-000000000036
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNWNkZGUyNmUtMDMyYy00MDI1LTllZmQtMjlmNjg3NjBjMzZmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk0NSIsInR5cCI6ImFjY2VzcyJ9.EZMVx3kEVSpfkuiXtrCm5g9rz37OXHxq1zYa0h7MMJ8

Response

204
cache-control: max-age=0, private, must-revalidate
b3: 223b00f828bd200a815a205cc7830fd4-f038f7341f89393f-0

Permanently deletes the tag. This is a hard delete: the record is removed from the database and cannot be recovered.

Any authenticated API key for the company may manage tags; no additional settings permission is required.

Request

DELETE /public/v1/tags/{id}

Parameters

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

Responses

Status Description Schema
204 No Content
404 Not Found

Get a tag

GET /public/v1/tags/:id returns a single tag

GET /public/v1/tags/00000000-0000-0000-0000-000000000035
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNWM1YTNhMTAtNjA5Zi00OGRlLWJiNzctNmZjYzdkZGZiZmM4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk0MCIsInR5cCI6ImFjY2VzcyJ9.Nw5paB9-FTwZ8GCQVo-jT4WaPnkwnIVHStbzb_Ciufk

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000035",
    "inserted_datetime": "2026-08-19T13:19:26.189211Z",
    "name": "Top Shelf",
    "updated_datetime": "2026-08-19T13:19:26.189211Z"
  }
}

Get a single tag given the ID.

Any authenticated API key for the company may manage tags; no additional settings permission is required.

Request

GET /public/v1/tags/{id}

Parameters

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

Responses

Status Description Schema
200 A single tag TagResponse
404 Not Found

Get tags

GET /public/v1/tags returns paginated tags for the company with next_page

GET /public/v1/tags
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzMyYWVlNmYtNTI2Yi00NjliLWJjMDMtNmQyMjJhMTZmZmYwIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6Njk2MyIsInR5cCI6ImFjY2VzcyJ9.DRiAJ7Jd4qqLdozwvfwREe_4dTSLT5BJgR8t0tw9eE0

Response

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

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000039",
      "inserted_datetime": "2026-08-19T13:19:26.307562Z",
      "name": "T1",
      "updated_datetime": "2026-08-19T13:19:26.307562Z"
    },
    {
      "id": "00000000-0000-0000-0000-00000000003a",
      "inserted_datetime": "2026-08-19T13:19:26.308096Z",
      "name": "T2",
      "updated_datetime": "2026-08-19T13:19:26.308096Z"
    },
    {
      "id": "00000000-0000-0000-0000-00000000003b",
      "inserted_datetime": "2026-08-19T13:19:26.308323Z",
      "name": "T3",
      "updated_datetime": "2026-08-19T13:19:26.308323Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/tags?page[number]=2"
}

List tags for the authenticated company.

Any authenticated API key for the company may manage tags; no additional settings permission is required.

Request

GET /public/v1/tags

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of tags Tags

Upsert a tag

POST /public/v1/tags creates a tag

POST /public/v1/tags
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjUsImlhdCI6MTc4NzE0NTU2NSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiOTJlN2QyNTItYWM2MS00OWZkLWFmNjgtNjg4Y2Y0YjdmYTQxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY0LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NjkyMyIsInR5cCI6ImFjY2VzcyJ9.qXa1X9i6SKGomIQ3qB8M_BbGEHIyf7he3GI2t11lzCc

{
  "name": "Top Shelf"
}

Response

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

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000032",
    "inserted_datetime": "2026-08-19T13:19:26.001172Z",
    "name": "Top Shelf",
    "updated_datetime": "2026-08-19T13:19:26.001172Z"
  }
}

Upsert a single tag. To update an existing tag, pass its ID in the id field. If you do not pass an ID, a new tag is created.

Any authenticated API key for the company may manage tags; no additional settings permission is required.

Request

POST /public/v1/tags

Parameters

Parameter Description In Type Required Default Example
id Tag ID. If given, the matching tag is updated; otherwise a new one is created. body string false
name The name of the tag body string true

Responses

Status Description Schema
200 The updated tag TagResponse
201 The created tag TagResponse
400 Invalid parameters
404 Not Found

Tax

Get a tax

GET /public/v1/taxes renders the full tax fields without michigan fields

GET /public/v1/taxes/00000000-0000-0000-0000-000000000024
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiNGM0NzhjOTctMDI1NC00YmU0LThiYmMtYjE5NWJmYmE5MjQ4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzIyOSIsInR5cCI6ImFjY2VzcyJ9.Gz5jMVxK2jyiAwSK9edv5QwTS3NReWt4aIMmFKRtpPo

Response

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

{
  "data": {
    "description": null,
    "id": "00000000-0000-0000-0000-000000000024",
    "inserted_datetime": "2026-08-19T13:19:27.460702Z",
    "name": "CA Excise",
    "qb_account_id": "84",
    "qb_product_id": "12",
    "tags": [
      {
        "id": "00000000-0000-0000-0000-00000000003e",
        "name": "Cannabis"
      }
    ],
    "tax_applied_after_charges": true,
    "tax_applied_after_price_tiers": true,
    "tax_code": "EXCISE",
    "tax_rate_percent": 15.0,
    "updated_datetime": "2026-08-19T13:19:27.461349Z"
  }
}

Get a single tax given the ID.

Required permission: settings_permissions_taxes.

Request

GET /public/v1/taxes/{id}

Parameters

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

Responses

Status Description Schema
200 A single tax TaxResponse
404 Not Found

Get taxes

GET /public/v1/taxes returns paginated taxes for the company with tags and next_page

GET /public/v1/taxes
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiMjJlYjVjZWEtNDA3NS00MmEyLWE3MzgtYzZhMWRjZGNhNTc2IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzI0NCIsInR5cCI6ImFjY2VzcyJ9.Me7dj8YWpeh2TrORtv6PEm-b-luRzduCzZz-v_4aQOU

Response

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

{
  "data": [
    {
      "description": null,
      "id": "00000000-0000-0000-0000-000000000026",
      "inserted_datetime": "2026-08-19T13:19:27.522395Z",
      "name": "T1",
      "qb_account_id": null,
      "qb_product_id": null,
      "tags": [
        {
          "id": "00000000-0000-0000-0000-00000000003f",
          "name": "Cannabis"
        }
      ],
      "tax_applied_after_charges": false,
      "tax_applied_after_price_tiers": true,
      "tax_code": "Tax Code 7",
      "tax_rate_percent": 15.0,
      "updated_datetime": "2026-08-19T13:19:27.522395Z"
    },
    {
      "description": null,
      "id": "00000000-0000-0000-0000-000000000027",
      "inserted_datetime": "2026-08-19T13:19:27.528792Z",
      "name": "T2",
      "qb_account_id": null,
      "qb_product_id": null,
      "tags": [],
      "tax_applied_after_charges": false,
      "tax_applied_after_price_tiers": true,
      "tax_code": "Tax Code 9",
      "tax_rate_percent": 15.0,
      "updated_datetime": "2026-08-19T13:19:27.528792Z"
    },
    {
      "description": null,
      "id": "00000000-0000-0000-0000-000000000028",
      "inserted_datetime": "2026-08-19T13:19:27.532786Z",
      "name": "T3",
      "qb_account_id": null,
      "qb_product_id": null,
      "tags": [],
      "tax_applied_after_charges": false,
      "tax_applied_after_price_tiers": true,
      "tax_code": "Tax Code 11",
      "tax_rate_percent": 15.0,
      "updated_datetime": "2026-08-19T13:19:27.532786Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/taxes?page[number]=2"
}

List taxes for the authenticated company. A tax is a named tax rate that can be applied to orders and invoices.

Required permission: settings_permissions_taxes.

Request

GET /public/v1/taxes

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of taxes Taxes

TestResult

Get a test result

GET /public/v1/test-results/:id returns a single test result

GET /public/v1/test-results/00000000-0000-0000-0000-000000000053
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNjYxMTQwOTUtYTNiNS00YjM5LWJmZWUtYWNiMzliN2NlMGZkIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODA0MCIsInR5cCI6ImFjY2VzcyJ9.iKJVJ8kTJgit1pDaIwj5Xa_bv30jzoJaH84ei0wdWyU

Response

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

{
  "data": {
    "additional_test_results": {},
    "batch_id": "00000000-0000-0000-0000-0000000008f2",
    "biotrack_id": null,
    "cbd_mg_per_unit": null,
    "cbd_percentage": null,
    "coa_url": null,
    "id": "00000000-0000-0000-0000-000000000053",
    "inserted_datetime": "2026-08-19T13:19:30.566859Z",
    "is_primary": false,
    "lab_license_number": null,
    "lab_name": null,
    "metrc_id": null,
    "mg_per_unit_type": "mg/g",
    "name": "TR001",
    "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": "2026-08-19T13:19:30.566859Z"
  }
}

Get a single test result given the ID.

Required permission: products_permissions_view.

Request

GET /public/v1/test-results/{id}

Parameters

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

Responses

Status Description Schema
200 A single test result TestResultResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMmRkNjFlN2QtOTU2YS00M2RkLWI0NDktZjFmNTk4NDE1Njc0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODExMSIsInR5cCI6ImFjY2VzcyJ9.bMKB4U2ovqmNOmi8sDK5c9pvhU6qHtdSEUPzEOAFKVw

Response

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

{
  "data": [
    {
      "additional_test_results": {
        "thca_percentage": "12"
      },
      "batch_id": null,
      "biotrack_id": null,
      "cbd_mg_per_unit": "1.12345",
      "cbd_percentage": "60.1234",
      "coa_url": null,
      "id": "00000000-0000-0000-0000-000000000059",
      "inserted_datetime": "2026-08-19T13:19:30.896626Z",
      "is_primary": false,
      "lab_license_number": "1234567890",
      "lab_name": "Test Lab",
      "metrc_id": 1234567890,
      "mg_per_unit_type": "mg/g",
      "name": "Test result 1",
      "package_id": "00000000-0000-0000-0000-000000000106",
      "release_date": "2026-08-19",
      "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": "2026-08-19T13:19:30.896626Z"
    },
    {
      "additional_test_results": {
        "thca_percentage": "12"
      },
      "batch_id": "00000000-0000-0000-0000-000000000907",
      "biotrack_id": null,
      "cbd_mg_per_unit": null,
      "cbd_percentage": null,
      "coa_url": null,
      "id": "00000000-0000-0000-0000-00000000005a",
      "inserted_datetime": "2026-08-19T13:19:30.906321Z",
      "is_primary": false,
      "lab_license_number": null,
      "lab_name": null,
      "metrc_id": 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": "2026-08-19T13:19:30.906321Z"
    },
    {
      "additional_test_results": {},
      "batch_id": null,
      "biotrack_id": null,
      "cbd_mg_per_unit": null,
      "cbd_percentage": null,
      "coa_url": null,
      "id": "00000000-0000-0000-0000-00000000005b",
      "inserted_datetime": "2026-08-19T13:19:30.973440Z",
      "is_primary": false,
      "lab_license_number": null,
      "lab_name": null,
      "metrc_id": null,
      "mg_per_unit_type": "mg/g",
      "name": "File.pdf",
      "package_id": "00000000-0000-0000-0000-000000000109",
      "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": "2026-08-19T13:19:30.973440Z"
    }
  ],
  "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.

Required permission: products_permissions_view.

Request

GET /public/v1/test-results

Parameters

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

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzAsImlhdCI6MTc4NzE0NTU3MCwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNTk5YTQ4YzMtNjgzNS00M2E4LWIwZTYtZTE1M2VkMzEzZGFlIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY5LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODA1NSIsInR5cCI6ImFjY2VzcyJ9.esXGzF_e3Ksj5CfyOxVt5e7AA7wxUxeU1jzCy5yJXlU

{
  "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-0000000008f4",
  "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: 5a557256eedd64a2f57ed38ca2506a83-23be7fcf8b586cd1-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-0000000008f4",
    "biotrack_id": null,
    "cbd_mg_per_unit": "1.1",
    "cbd_percentage": "2.2",
    "coa_url": null,
    "id": "00000000-0000-0000-0000-000000000054",
    "inserted_datetime": "2026-08-19T13:19:30.629360Z",
    "is_primary": true,
    "lab_license_number": "1234567890",
    "lab_name": "Test Lab",
    "metrc_id": null,
    "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": "2026-08-19T13:19:30.629360Z"
  }
}

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. Required permission: products_permissions_edit.

Request

POST /public/v1/test-results

Parameters

Parameter Description In Type Required Default Example
additional_test_results The additional tests results for this test result. Check here for the valid options. body object false
batch_id The ID of the batch this test result belongs to. Cannot be provided if either id or package_id is provided. body string false 123e4567-e89b-12d3-a456-426614174000
cbd_mg_per_unit The CBD mg per unit for this test result. body decimal false 1.5
cbd_percentage The CBD percentage for this test result. Max precision is 4 decimal places. body decimal false 1.5
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. body string false
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. body boolean false true
lab_license_number The license number of this test result's lab body string false 1234567890
lab_name The name of this test result's lab body string false Lab Name
mg_per_unit_type The unit type for the mg per unit fields body string false mg/g
name The name of this test result body string false Test Result Name
package_id The ID of the package this test result belongs to. Cannot be provided if either id or batch_id is provided. body string false 123e4567-e89b-12d3-a456-426614174000
release_date The release date for this test result body string false 2022-07-10
thc_mg_per_unit The THC mg per unit for this test result. body decimal false 1.5
thc_percentage The THC percentage for this test result. Max precision is 4 decimal places. body decimal false 1.5
total_cbd_mg_per_unit The total CBD mg per unit for this test result. body decimal false 1.5
total_cbd_percentage The total CBD percentage for this test result. Max precision is 4 decimal places. body decimal false 1.5
total_thc_mg_per_unit The total THC mg per unit for this test result. body decimal false 1.5
total_thc_percentage The total THC percentage for this test result. Max precision is 4 decimal places. body decimal false 1.5

Responses

Status Description Schema
200 A single test result TestResultResponse

UnitType

Get a unit type

GET /public/v1/unit-types/:id returns the full unit type fields

GET /public/v1/unit-types/00000000-0000-0000-0000-000000010916
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiMzI5MmZkOTEtZGFlNi00YTU4LWExMzItZTgxMDYzYzFiZDljIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzAxMSIsInR5cCI6ImFjY2VzcyJ9.0UieBWFtHJYSbP29igceD6nwH7IjpsN0DmPyC4ogs7w

Response

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

{
  "data": {
    "active": true,
    "category": "WEIGHT",
    "id": "00000000-0000-0000-0000-000000010916",
    "inserted_datetime": "2026-08-19T13:19:26.517173Z",
    "locked": true,
    "name": "Big Bag",
    "qty_per_si_unit": "453.592",
    "updated_datetime": "2026-08-19T13:19:26.517173Z"
  }
}

Get a single unit type given the ID.

Request

GET /public/v1/unit-types/{id}

Parameters

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

Responses

Status Description Schema
200 A single unit type UnitTypeFullResponse
404 Not Found

Get unit types

GET /public/v1/unit-types returns paginated unit types with next_page

GET /public/v1/unit-types
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjYsImlhdCI6MTc4NzE0NTU2NiwiaXNzIjoiRGlzdHJ1IiwianRpIjoiYmUyNGE4ZjEtMjkyZC00ZTM0LWEwZmEtZmZhN2I1MzhlNzdmIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY1LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzAyMSIsInR5cCI6ImFjY2VzcyJ9.t3RS_s3FznpcSpsKiAtZTaUnpj0SM8ZYdk9E0VlrmJI

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 22ffd8c1481eaea2c3b0cfd05a4f0d96-6276d2db8b355f1a-0

{
  "data": [
    {
      "active": false,
      "category": "WEIGHT",
      "id": "00000000-0000-0000-0000-000000010985",
      "inserted_datetime": "2026-08-19T13:19:26.560926Z",
      "locked": true,
      "name": "Kilogram",
      "qty_per_si_unit": "1",
      "updated_datetime": "2026-08-19T13:19:26.560926Z"
    },
    {
      "active": true,
      "category": "WEIGHT",
      "id": "00000000-0000-0000-0000-000000010986",
      "inserted_datetime": "2026-08-19T13:19:26.560926Z",
      "locked": true,
      "name": "Gram",
      "qty_per_si_unit": "1000",
      "updated_datetime": "2026-08-19T13:19:26.560926Z"
    },
    {
      "active": false,
      "category": "WEIGHT",
      "id": "00000000-0000-0000-0000-000000010987",
      "inserted_datetime": "2026-08-19T13:19:26.560926Z",
      "locked": true,
      "name": "Milligram",
      "qty_per_si_unit": "1000000",
      "updated_datetime": "2026-08-19T13:19:26.560926Z"
    }
  ],
  "next_page": "https://www.example.com/public/v1/unit-types?page[number]=2"
}

List unit types for the authenticated company.

Request

GET /public/v1/unit-types

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of unit types UnitTypes

User

Get a user

GET /public/v1/users/:id returns a single user

GET /public/v1/users/00000000-0000-0000-0000-000000001be0
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiZTc3MTBmYzktZTIzYi00ZjM5LTk5YjUtYzQ2Yzk5YTIzZTMxIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzEzNSIsInR5cCI6ImFjY2VzcyJ9.A99zpL-p_sUojrIUzFtpB7AJMrdppa4gCHGD5uCwPrs

Response

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

{
  "data": {
    "banned": false,
    "deleted_at": null,
    "email": "owner-235@example.com",
    "full_name": "FirstName464 LastName465",
    "id": "00000000-0000-0000-0000-000000001be0",
    "inserted_datetime": "2026-08-19T13:19:27.106136Z",
    "role": {
      "id": "00000000-0000-0000-0000-000000001c85",
      "name": "Admin 260"
    }
  }
}

Get a single user given the ID.

Required permission: settings_permissions_manage_team.

Request

GET /public/v1/users/{id}

Parameters

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

Responses

Status Description Schema
200 A single user UserResponse
404 Not Found

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.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNjcsImlhdCI6MTc4NzE0NTU2NywiaXNzIjoiRGlzdHJ1IiwianRpIjoiOGZiNzVhZjYtNzJjMi00ODY4LWE4YzItMjI3NmYwNzAwMDc5IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTY2LCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6NzIwMSIsInR5cCI6ImFjY2VzcyJ9.W47-OmKxHgF4qJHA5ny9PzMRX4O_UivLN_rTqa1MZxQ

Response

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

{
  "data": [
    {
      "banned": false,
      "deleted_at": null,
      "email": "owner-301@example.com",
      "full_name": "FirstName596 LastName597",
      "id": "00000000-0000-0000-0000-000000001c21",
      "inserted_datetime": "2026-08-19T13:19:27.349325Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001cd0",
        "name": "Admin 335"
      }
    },
    {
      "banned": false,
      "deleted_at": null,
      "email": "owner-303@example.com",
      "full_name": "FirstName600 LastName601",
      "id": "00000000-0000-0000-0000-000000001c24",
      "inserted_datetime": "2026-08-19T13:19:27.354318Z",
      "role": {
        "id": "00000000-0000-0000-0000-000000001cd2",
        "name": "Admin 337"
      }
    }
  ],
  "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.

Required permission: settings_permissions_manage_team.

Request

GET /public/v1/users

Parameters

Parameter Description In Type Required Default Example
deleted Filter deleted users. no returns non-deleted, only returns deleted, include returns both. query string false no
inserted_datetime Filter users by their creation datetime query string false 2022-07-10T00:00:00Z,
page Pagination information query number false ?page[number]=1
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

Vehicle

Create or update a vehicle

POST /public/v1/vehicles creates a vehicle

POST /public/v1/vehicles
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiZmY4OTllNTMtMjY0Yy00NTliLTkxNzgtMDgyYmFiYmNjNzI4IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODI5OCIsInR5cCI6ImFjY2VzcyJ9.7Bt59hKrq0sA9z-xVB2rnyKpSbu7ftSaJt29bmppBTs

{
  "color": "Red",
  "description": "Delivery truck",
  "license_plate_number": "XYZ789",
  "license_plate_state": "TX",
  "make": "Ford",
  "model": "F-150",
  "vin": "ABCDEFGHIJ1234567",
  "year": "2024"
}

Response

200
content-type: application/json; charset=utf-8
cache-control: max-age=0, private, must-revalidate
b3: 216f116aa9b5000964319179a4c1ba31-339f6639fa2dfa12-0

{
  "data": {
    "color": "Red",
    "description": "Delivery truck",
    "id": "00000000-0000-0000-0000-00000000002d",
    "inserted_datetime": "2026-08-19T13:19:31.409922Z",
    "license_plate_number": "XYZ789",
    "license_plate_state": "TX",
    "make": "Ford",
    "model": "F-150",
    "updated_datetime": "2026-08-19T13:19:31.409922Z",
    "vin": "ABCDEFGHIJ1234567",
    "year": "2024"
  }
}

Create or update a vehicle. Omit id to create a new vehicle (make, model and license_plate_number are then required); pass the id of an existing vehicle to update it in place.

Required permission: settings_permissions_vehicles.

Request

POST /public/v1/vehicles

Parameters

Parameter Description In Type Required Default Example
color The color of the vehicle body string false
description A description or name for the vehicle body string false
id The ID of the vehicle to update. Omit to create a new vehicle. body string false
license_plate_number The license plate number. Required when creating. body string false
license_plate_state The license plate state body string false
make The make of the vehicle. Required when creating. body string false
model The model of the vehicle. Required when creating. body string false
vin The vehicle identification number (VIN) body string false
year The year of the vehicle body string false

Responses

Status Description Schema
200 The created or updated vehicle VehicleResponse
400 Invalid parameters
404 Not Found

Get a vehicle

GET /public/v1/vehicles/:id returns a single vehicle

GET /public/v1/vehicles/00000000-0000-0000-0000-000000000025
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNzEyODliYTgtNzBhYi00MjU4LWEzNGUtNjI4NjBhODE4Mjc0IiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODIyNSIsInR5cCI6ImFjY2VzcyJ9.s8J6XrjRvaWlCDVA5lO6a0dGf8okYQeqAukz44rWPHk

Response

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

{
  "data": {
    "color": "Blue",
    "description": "Company car",
    "id": "00000000-0000-0000-0000-000000000025",
    "inserted_datetime": "2026-08-19T13:19:31.173927Z",
    "license_plate_number": "ABC123",
    "license_plate_state": "CA",
    "make": "Toyota",
    "model": "Camry",
    "updated_datetime": "2026-08-19T13:19:31.173927Z",
    "vin": "1234567890",
    "year": "2023"
  }
}

Get a single vehicle given the ID.

Required permission: settings_permissions_vehicles.

Request

GET /public/v1/vehicles/{id}

Parameters

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

Responses

Status Description Schema
200 A single vehicle VehicleResponse
404 Not Found

Get vehicles

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

GET /public/v1/vehicles
content-type: application/json
accept: application/json
authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJEaXN0cnUiLCJleHAiOjE4MTg1OTUxNzEsImlhdCI6MTc4NzE0NTU3MSwiaXNzIjoiRGlzdHJ1IiwianRpIjoiNDFiNzAzNWEtOGM4YS00ZGE4LTllZjgtODM2MWUwN2Q5MzllIiwibW9iaWxlIjpmYWxzZSwibmJmIjoxNzg3MTQ1NTcwLCJwbGF0Zm9ybSI6IkFQSSIsInN1YiI6IlVzZXI6ODMyOSIsInR5cCI6ImFjY2VzcyJ9.GpV6D7vK8aDTamEt9IdmP56Lt2AUrDQpdUFtBwjEqqU

Response

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

{
  "data": [
    {
      "color": "Red",
      "description": "Test Vehicle",
      "id": "00000000-0000-0000-0000-000000000030",
      "inserted_datetime": "2026-08-19T13:19:31.485538Z",
      "license_plate_number": "1234567890ABCDEFG",
      "license_plate_state": "CA",
      "make": "Toyota",
      "model": "Camry",
      "updated_datetime": "2026-08-19T13:19:31.485538Z",
      "vin": "1234567890ABCDEFG",
      "year": "2020"
    },
    {
      "color": "Red",
      "description": "Test Vehicle",
      "id": "00000000-0000-0000-0000-000000000031",
      "inserted_datetime": "2026-08-19T13:19:31.489234Z",
      "license_plate_number": "1234567890ABCDEFG",
      "license_plate_state": "CA",
      "make": "Honda",
      "model": "Civic",
      "updated_datetime": "2026-08-19T13:19:31.489234Z",
      "vin": "1234567890ABCDEFG",
      "year": "2020"
    }
  ],
  "next_page": null
}

List vehicles for the authenticated company.

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

Required permission: settings_permissions_vehicles.

Request

GET /public/v1/vehicles

Parameters

Parameter Description In Type Required Default Example
page Pagination information query number false ?page[number]=1

Responses

Status Description Schema
200 A list of vehicles Vehicles

Models

AddBatchCostsRequest

Property Description Type Required
batch_ids Non-empty list of batch UUIDs array(any) true
costs Non-empty list of costs to apply array(CostEntryInput) true
distribute_by_quantity Split each cost across the batches in proportion to their active quantity boolean false
location_ids Optional list of location UUIDs to scope the stock the cost applies to array(any) false

AddPackageCostsRequest

Property Description Type Required
costs Non-empty list of costs to apply array(CostEntryInput) true
distribute_by_quantity Split each cost across the packages in proportion to their active quantity boolean false
package_ids Non-empty list of package UUIDs array(any) true

AddProductCostsRequest

Property Description Type Required
costs Non-empty list of costs to apply array(CostEntryInput) true
distribute_by_quantity Split each cost across the products in proportion to their active quantity boolean false
location_ids Optional list of location UUIDs to scope the stock the cost applies to array(any) false
product_ids Non-empty list of product-tracked product UUIDs array(any) true

AdditionalTestResult

The full breakdown of individual analytes measured on a lab test, grouped by category (cannabinoids, terpenes, pesticides, heavy metals, microbials, mycotoxins, residual solvents, and more). Each value is a string. The unit is encoded in the field-name suffix: _percentage is percent by weight, _mg_per_unit is milligrams per unit, _ug_per_g is micrograms per gram, _ug_per_kg is micrograms per kilogram, and _cfu_per_g is colony-forming units per gram. A null or empty value means the analyte was not measured.

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

Assemblies

A collection of Assemblies

Property Description Type Required
data Assemblies array(Assembly) false
next_page URL for the next page of results; null when there is no next page string false

Assembly

A production job that turns input inventory (ingredients/components) into one or more finished output products — for example packaging bulk flower into units or producing pre-rolls.

Property Description Type Required
assembly_number Human-readable reference number for this assembly, shown in Distru (e.g. "AS-0000001") string false
completion_datetime The datetime this assembly was completed at string false
compliance_type Which state compliance system, if any, this assembly reports to. One of METRC, BIOTRACK, or NONE. string false
creation_source How this assembly was created. MANUALLY_CREATED: created by a user in Distru or via the API. SALES_ORDER: created automatically to repackage inventory while fulfilling a sales order. SPLIT_PACKAGE: created by splitting an existing package into smaller packages. LAB_TESTING: created to pull a test sample for lab testing. string false
creator Information about a user in Distru User false
custom_data The custom data for this assembly array(CustomField) false
description The description for this assembly string false
estimated_start_date The datetime this assembly is expected to start 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
inserted_datetime The datetime this assembly was created at string false
is_metrc_processing_job True if this assembly is associated with a Metrc processing job, false otherwise boolean false
license A cannabis license held by a company or tied to a location, identifying it to the state and its compliance system. License false
metrc_processing_job_id The Metrc processing job ID for this assembly, or null integer false
metrc_processing_job_name The Metrc processing job name for this assembly, or null string false
metrc_processing_job_notes The Metrc processing job notes for this assembly, or null 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 Where this assembly is in its lifecycle. PENDING: still in progress — its ingredient inventory is already claimed (each ingredient's active quantity is decreased to hold it for this assembly), but its output products have not been produced into inventory yet. COMPLETED: the assembly has been finished, consuming its claimed ingredient inventory and creating its output products; a completed assembly can no longer be deleted and only a limited set of its fields can be edited. string false
updated_datetime The datetime this assembly was last updated at string false
waste_count_quantity The count-based waste recorded when finishing this assembly's Metrc processing job. Only set for assemblies that are Metrc processing jobs; null otherwise. Reported to Metrc as TotalCountWaste. string false
waste_count_unit_name The Metrc unit-of-measure name for waste_count_quantity (e.g. "Each"). Only set for Metrc processing jobs; null otherwise. string false
waste_volume_quantity The volume-based waste recorded when finishing this assembly's Metrc processing job. Only set for assemblies that are Metrc processing jobs; null otherwise. Reported to Metrc as TotalVolumeWaste. string false
waste_volume_unit_name The Metrc unit-of-measure name for waste_volume_quantity (e.g. "Milliliters"). Only set for Metrc processing jobs; null otherwise. string false
waste_weight_quantity The weight-based waste recorded when finishing this assembly's Metrc processing job. Only set for assemblies that are Metrc processing jobs; null otherwise. Reported to Metrc as TotalWeightWaste. string false
waste_weight_unit_name The Metrc unit-of-measure name for waste_weight_quantity (e.g. "Grams"). Only set for Metrc processing jobs; null otherwise. string false

AssemblyCost

A cost added directly to an assembly output (e.g. labor or packaging), as shown in Distru

Property Description Type Required
cost_per_unit The per-unit rate applied to this assembly cost number false
description The description of the assembly cost string false
name The name of the assembly cost string false
quantity The quantity of the assembly cost number false
unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false

AssemblyInput

An ingredient consumed by an assembly — the inventory used up to produce an output, and its cost.

Property Description Type Required
batch A lot of a product — a group of inventory that shares traits such as a harvest/production run, expiration date, and lab results. Used for batch-tracked products. This is the compact reference; see BatchFull for all fields. Batch false
compliance_quantity The quantity of this input expressed in the package's unit type. Null if this input is not package-tracked. string false
cost_per_unit Actual cost per unit — total_cost_actual divided by this input's quantity (in its product's unit). string false
cost_per_unit_default Default (standard) cost per unit — total_cost_default divided by this input's quantity (in its product's unit). string false
location A location as nested inside another entity in Distru LocationCompact false
package A specific, compliance-tracked quantity of a product identified by a unique tag (e.g. a Metrc package). This is the physical unit of inventory for package-tracked products. This is the compact reference; see PackageFull for all fields. Package false
product A sellable or trackable item in your catalog — its name, pricing, category, unit of measure, and how its inventory is tracked (see inventory_tracking_method). Product false
quantity The quantity of this input in its product's unit string false
total_cost_actual Total actual cost of the inventory consumed by this input. Distru traces the components that produced the consumed inventory and sums the real costs incurred along that chain — for example the price paid when a component was purchased, assembly costs, and costs added by stock adjustments, among others. This cost propagates to the output the input feeds. string false
total_cost_default Total default (standard) cost of this input. Traced the same way as total_cost_actual, but each component is valued at its product's configured unit cost (the product's unit_cost) instead of its real cost. string false

AssemblyOutput

A finished product produced by an assembly, along with the quantity made and its cost.

Property Description Type Required
batch A lot of a product — a group of inventory that shares traits such as a harvest/production run, expiration date, and lab results. Used for batch-tracked products. This is the compact reference; see BatchFull for all fields. Batch false
batch_number The batch number for this assembly output string false
compliance_label The unique tag assigned by the state compliance system (e.g. the Metrc package tag), when applicable string false
compliance_quantity The quantity of this output expressed in the package's unit type. Null if this input is not package-tracked. string false
copy_custom_data_from_input True if this output copied its custom field values from the input boolean false
cost_per_unit Actual cost per unit — total_cost_actual divided by this output's quantity (in its product's unit). string false
cost_per_unit_default Default (standard) cost per unit — total_cost_default divided by this output's quantity (in its product's unit). string false
costs The costs added directly to this assembly output (e.g. labor or packaging), on top of the material cost carried over from its inputs array(AssemblyCost) false
expiration_date The expiration date for this assembly output string false
inputs The inputs (source inventory) consumed to produce this output. Their cost propagates to this output and is reflected in its actual cost fields (total_cost_actual and cost_per_unit). array(AssemblyInput) false
is_donation True if this output is a donation boolean false
is_finished_good True if this output is a finished, sellable product (rather than an intermediate/work-in-progress item). Only applies to Metrc-tracked outputs. boolean false
is_production_batch True if this output is a new production lot created by the assembly (rather than adding to existing inventory). Only applies to Metrc-tracked outputs. boolean false
is_test_sample True if this output is a test sample boolean false
is_trade_sample True if this output is a trade sample boolean false
location A location as nested inside another entity in Distru LocationCompact false
metrc_item_id The Metrc item id for this output, when applicable integer false
metrc_location_id The Metrc location id for this output, when applicable integer false
metrc_notes Notes recorded on this output that Distru sends to Metrc as the package's note when it creates the package string false
metrc_production_batch_number The Metrc production batch number, set when this output is a production batch string false
package A specific, compliance-tracked quantity of a product identified by a unique tag (e.g. a Metrc package). This is the physical unit of inventory for package-tracked products. This is the compact reference; see PackageFull for all fields. Package false
package_date The date that this package was created at string false
package_unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false
product A sellable or trackable item in your catalog — its name, pricing, category, unit of measure, and how its inventory is tracked (see inventory_tracking_method). Product false
quantity The quantity of this output in its product's unit string false
status The status of this output: PENDING or COMPLETED string false
total_cost_actual Total actual cost of this output. Distru traces the inputs and components consumed to produce it and sums the real costs incurred along that chain — for example the price paid when a component was purchased, assembly costs, and costs added by stock adjustments, among others — plus the costs added directly on this output (see costs). string false
total_cost_default Total default (standard) cost of this output. Traced the same way as total_cost_actual, but each input/component is valued at its product's configured unit cost (the product's unit_cost) instead of its real cost. string false
use_same_item True if this output reuses the source package's Metrc item boolean false

AssemblyResponse

A single assembly

Property Description Type Required
data A production job that turns input inventory (ingredients/components) into one or more finished output products — for example packaging bulk flower into units or producing pre-rolls. Assembly false

Batch

A lot of a product — a group of inventory that shares traits such as a harvest/production run, expiration date, and lab results. Used for batch-tracked products. This is the compact reference; see BatchFull for all fields.

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

BatchFull

A lot of a product with all its details — a group of inventory sharing a harvest/production run, expiration date, potency, lab results, and cost. Used for batch-tracked products.

Property Description Type Required
batch_number The batch number for this batch string false
bins The bins this batch is stored in. Only present when bin inventory tracking is enabled for the company. array(BinCompact) false
cbd A free-form CBD value set directly on the batch record. This is a static label, independent of any lab result — the batch's primary_test_result may report different potency values (e.g. cbd_percentage). Null if unset. string false
cost_per_unit_actual Actual cost per unit — total_cost_actual divided by the batch quantity. string false
cost_per_unit_default Default (standard) cost per unit — total_cost_default divided by the batch quantity. string false
creator Information about a user in Distru User false
custom_data The custom data for this batch array(CustomField) false
deleted_at The date and time when this batch was deleted string false
description The description for this batch string false
expiration_date The expiration date for this batch string false
harvest_datetime The harvest datetime for this batch (ISO 8601 format) string false
id Unique ID for this batch string false
inserted_datetime The datetime this batch was created (ISO 8601) string false
manufactured_datetime The manufactured datetime for this batch (ISO 8601 format) string false
name Human readable name for this batch string false
owner_id The ID of the user that owns this batch string false
primary_test_result The compact primary test result nested on a package or batch PrimaryTestResult false
product_id The ID of the batch's product string false
thc A free-form THC value set directly on the batch record. This is a static label, independent of any lab result — the batch's primary_test_result may report different potency values (e.g. thc_percentage). Null if unset. string false
total_cost_actual Total actual cost of this batch. Distru traces the inputs and components that produced the batch and sums the real costs incurred along that chain — for example the price paid when a component was purchased, assembly costs, and costs added by stock adjustments, among others. string false
total_cost_default Total default (standard) cost of this batch. Traced the same way as total_cost_actual, but each input/component is valued at its product's configured unit cost (the product's unit_cost) instead of its real cost. string false
updated_datetime The datetime this batch was last modified (ISO 8601) string false

BatchFullResponse

A single batch

Property Description Type Required
data A lot of a product with all its details — a group of inventory sharing a harvest/production run, expiration date, potency, lab results, and cost. Used for batch-tracked products. BatchFull false

Batches

A collection of Batches

Property Description Type Required
data Batches array(BatchFull) false
next_page URL for the next page of results; null when there is no next page string false

BillOfMaterials

A product's bill of materials (recipe of inputs and additional costs)

Property Description Type Required
costs The additional costs applied by this bill of materials array(BillOfMaterialsCost) false
description The description of this bill of materials string false
id Unique ID for this bill of materials string false
inputs The inputs consumed by this bill of materials array(BillOfMaterialsInput) false
name Human readable name for this bill of materials string false

BillOfMaterialsCost

An additional cost applied by a bill of materials

Property Description Type Required
cost_type The cost type applied by a bill-of-materials cost BillOfMaterialsCostType false
description The description of this cost string false
id Unique ID for this cost string false
quantity The quantity of the cost type applied string false

BillOfMaterialsCostType

The cost type applied by a bill-of-materials cost

Property Description Type Required
cost_per_unit The cost per unit. Null unless the caller has the costs_permissions_view_cost_types_cost_per_unit permission. string false
id Unique ID for this cost type string false
name Human readable name for this cost type string false
unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false

BillOfMaterialsFilter

A dynamic filter that selects products as a bill-of-materials input

Property Description Type Required
criteria The filter criteria, each a type (category, subcategory, group, strain, unit_type, tags) and its matched values (each an id and name) array(any) false
id Unique ID for this filter string false
name Human readable name for this filter string false

BillOfMaterialsInput

A single input of a bill of materials

Property Description Type Required
filter A dynamic filter that selects products as a bill-of-materials input BillOfMaterialsFilter false
id Unique ID for this input string false
product A sellable or trackable item in your catalog — its name, pricing, category, unit of measure, and how its inventory is tracked (see inventory_tracking_method). Product false
quantity The quantity of this input required by the bill of materials string false
type The kind of input: product or filter string false

Bin

A bin used to track where inventory is physically stored

Property Description Type Required
id Unique ID for this bin string false
inserted_datetime When the bin was created (UTC ISO-8601) string false
name The name of the bin string false
updated_datetime When the bin was last updated (UTC ISO-8601) string false

BinCompact

Minimal details about a bin, as nested on other records

Property Description Type Required
id Unique ID for this bin string false
name The name of the bin string false

BinResponse

A single bin

Property Description Type Required
data A bin used to track where inventory is physically stored Bin false

Bins

A collection of bins

Property Description Type Required
data Bins array(Bin) false
next_page URL for the next page of results; null when there is no next page string false

CancelCredit

Options for canceling a credit

Property Description Type Required
should_delete_credit_uses When true, also removes this credit's applications to invoices (its credit uses), returning the used amounts to those invoices. Defaults to false. boolean false

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
inserted_datetime The datetime this charge was created at string false
name The name for this charge string false
percent The percent to charge for this line if it is a percentage string false
price The price of this line if it is a flat charge string false
tax.id Unique ID for this Tax string false
tax.name The name of this tax string false
type What type of additional line is this. Tax lines are returned as CHARGE with a populated tax object. array(any) false
unit_type Determines if this line is tracked as a percentage or a flat charge array(any) false

CogsReport

The Cost of Goods Sold report

Property Description Type Required
data The report rows array(CogsReportRow) true
meta Report-level metadata CogsReportMeta true

CogsReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

CogsReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(CogsReportColumn) false
date_range The human-readable date the report was generated string false
report The report identifier string true

CogsReportRow

A single row of the Cost of Goods Sold report (one sales order line item). Companies on the BioTrack compliance integration do not get the metrc_production_batch_number key.

Property Description Type Required
batch The Distru batch number string false
cost_origin The origin of the cost string false
final_input Whether the row is the sold item (Final) string false
margin_actual The actual margin number false
margin_default The default margin number false
metrc_production_batch_number The Metrc production batch number string false
order_number The sales order number string false
package The package compliance label string false
product_brand The product's brand string false
product_category The product's category string false
product_name The product name string false
profit_unit_actual The actual profit per unit number false
profit_unit_default The default profit per unit number false
quantity The quantity sold, net of returns number false
sku The product SKU string false
total_cost_actual Actual total cost — unit_cost_actual multiplied by the row's quantity. number false
total_cost_default Default (standard) total cost — unit_cost_default multiplied by the row's quantity. number false
total_price The total price (unit price times quantity) number false
total_profits_actual The actual total profit number false
total_profits_default The default total profit number false
unit_cost_actual Actual cost per unit — the real cost Distru traces to the inputs and components that produced this inventory (purchase prices, assembly costs, stock-adjustment costs, and so on), per unit. number false
unit_cost_default Default (standard) cost per unit — traced the same way as unit_cost_actual, but each input/component is valued at its product's configured unit cost (unit_cost) instead of its real cost. number false
unit_price The price per unit number false
unit_type The item's unit type string false

CompactCredit

A compact representation of a credit

Property Description Type Required
amount The current amount of this credit string false
credit_number The credit number as shown in the Distru UI string false
id Unique ID for this credit string false
source How this credit was created string false

CompactInvoice

A compact view of an invoice as nested inside another entity in Distru

Property Description Type Required
id Unique ID for this invoice string false
invoice_number The invoice number as shown in the Distru UI string false
status The payment status of this invoice string false
total The total for this invoice string false

CompactMenu

A compact reference to a menu, nested inside another entity in Distru

Property Description Type Required
menu_id Public ID of the menu string false
menu_name Display name of the menu string false

CompactOrder

A compact view of an order as nested inside another entity in Distru

Property Description Type Required
id Unique ID for this order string false
order_number The order number as shown in the Distru UI string false
status The status of this order string false
total The total on this order string false

CompactOrderItem

A compact view of an order line item as nested inside another entity in Distru — what was sold, how much, at what price, and which inventory (batch/package) fulfills it.

Property Description Type Required
batch A lot of a product — a group of inventory that shares traits such as a harvest/production run, expiration date, and lab results. Used for batch-tracked products. This is the compact reference; see BatchFull for all fields. Batch false
compliance_quantity The quantity of this order item expressed in its package's unit type. Null if not package-tracked. string false
id Unique ID for this order item string false
is_sample True if this order item is a sample boolean false
location A location as nested inside another entity in Distru LocationCompact false
package A specific, compliance-tracked quantity of a product identified by a unique tag (e.g. a Metrc package). This is the physical unit of inventory for package-tracked products. This is the compact reference; see PackageFull for all fields. Package false
price Price per unit of this order item (with discounts applied) string false
price_base Price per unit before any discounts string false
product A sellable or trackable item in your catalog — its name, pricing, category, unit of measure, and how its inventory is tracked (see inventory_tracking_method). Product false
quantity Quantity sold on this order item, expressed in the product's unit type string false

CompactReturn

A compact representation of a return

Property Description Type Required
company A company as nested inside another entity in Distru CompanyCompact false
id Unique ID for this return string false
return_datetime The datetime of this return string false
return_number The return number as shown in the Distru UI string false
status The status of this return string false
total The total value of this return number false

Companies

A collection of companies

Property Description Type Required
data Companies array(Company) false
next_page URL for the next page of results; null when there is no next page string false

Company

A business in your network — a customer, a vendor, or both. Holds contact details, locations, licenses, and the terms you deal on.

Property Description Type Required
category The kind of cannabis business this company is — one of Dispensary, Delivery, Cultivator, Manufacturer, Distributor, Microbusiness, Lab, Retail, or Other string false
custom_data The custom data for this company array(CustomField) false
default_email The default email for this company string false
default_payment_term The agreed timeframe a customer has to pay — for example "Net 30" means payment is due 30 days after the invoice. PaymentTerm 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
deleted_at The datetime this company relationship was deleted at string false
group A label used to group companies together (for example by territory or account tier) for organizing and reporting. CompanyGroup false
id Unique ID for this company string false
inserted_datetime The datetime this company was created at string false
invoice_email The email address where sales order invoices are delivered string false
leaflink_brand_id The LeafLink brand ID mapped to this company; only set on self-relationships, otherwise null integer false
leaflink_customer_id The LeafLink customer ID mapped to this company, or null integer 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(LocationCompact) 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 The current outstanding (unpaid) balance for this company, as a decimal string (e.g. "150.50"). "0" when nothing is outstanding. 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 Information about a user in Distru User false
owner_id The ID of the Distru user who is the account owner (main point of contact) for 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
qb_customer_id The QuickBooks Online customer ID mapped to this company, or null string false
qb_vendor_id The QuickBooks Online vendor ID mapped to this company, or null string false
relationship_type How a company relates to your business — whether they are a customer you sell to, a vendor you buy from, or both. 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

CompanyCompact

A company as nested inside another entity in Distru

Property Description Type Required
id Unique ID for this company string false
name Human readable name for this company string false
updated_datetime The datetime this company was last updated at string false

CompanyGroup

A label used to group companies together (for example by territory or account tier) for organizing and reporting.

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

CompanyGroupFull

A company group

Property Description Type Required
id Unique ID for this company group string false
inserted_datetime When the company group was created (UTC ISO-8601) string false
name The name of the company group string false
updated_datetime When the company group was last updated (UTC ISO-8601) string false

CompanyGroupFullResponse

A single company group

Property Description Type Required
data A company group CompanyGroupFull false

CompanyGroups

A collection of company groups

Property Description Type Required
data Company Groups array(CompanyGroupFull) false
next_page URL for the next page of results; null when there is no next page string false

CompanyResponse

A single company relationship

Property Description Type Required
data A business in your network — a customer, a vendor, or both. Holds contact details, locations, licenses, and the terms you deal on. Company false

Contact

Information about a contact in Distru's CRM

Property Description Type Required
company.id Unique ID for this company string false
custom_data The custom data for this contact array(CustomField) false
deleted_at The datetime of deletion if the contact was deleted string false
description The description of this contact string false
driver_license_issuing_state Driver license issuing state for shipping manifests string false
driver_license_number Driver license number for shipping manifests string false
email The email address of this contact string false
first_name The first name of this contact string false
full_name The full name of this contact string false
id Unique ID for this contact string false
inserted_datetime The datetime this contact was created at string false
last_name The last name of 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
updated_datetime The datetime this contact was last updated at string false
work_phone_number The work phone number of this contact string false

ContactResponse

A single contact

Property Description Type Required
data Information about a contact in Distru's CRM Contact false

Contacts

A collection of Contacts

Property Description Type Required
data Contacts array(Contact) false
next_page URL for the next page of results; null when there is no next page string false

CostEntryInput

A single cost to apply to a record

Property Description Type Required
cost_per_unit Per-unit amount. When omitted, the cost type's own cost per unit is used. Must be omitted for cost types with a locked cost per unit; only required when an inline-editable cost type has no cost per unit of its own number false
cost_type_id The cost type UUID from GET /public/v1/cost-types (required) string true
description Free-form text stored on the cost string false
quantity Units of the cost type to apply, must be > 0 (required) number true

CostType

A cost type

Property Description Type Required
active Whether the cost type is active boolean false
allow_inline_edits Controls whether the per-unit cost amount can be overridden when a cost of this type is applied to a record (a plant cost, an assembly or breakdown output cost, or an order/invoice cost line). When true, the user may enter or override cost_per_unit at apply time; when false, the applied amount is locked to this cost type's configured cost_per_unit and cannot be changed. boolean false
cost_per_unit The cost per unit as a decimal string string false
deleted_at When the cost type was soft-deleted (UTC ISO-8601), or null if it has not been deleted string false
description A description of the cost type string false
id Unique ID for this cost type string false
inserted_datetime When the cost type was created (UTC ISO-8601) string false
name The name of the cost type string false
unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false
updated_datetime When the cost type was last updated (UTC ISO-8601) string false

CostTypeResponse

A single cost type

Property Description Type Required
data A cost type CostType false

CostTypes

A collection of cost types

Property Description Type Required
data Cost Types array(CostType) false
next_page URL for the next page of results; null when there is no next page string false

Credit

Store credit held by a customer that can be applied toward what they owe. Credits can be issued manually or generated automatically (for example from a return or an invoice overpayment).

Property Description Type Required
amount The current amount of this credit string false
canceled_datetime The datetime at which the credit was canceled. Only set for CANCELED credits. string false
company A company as nested inside another entity in Distru CompanyCompact false
creator Information about a user in Distru User false
credit_number The credit number as shown in the Distru UI string false
credit_uses This credit's applications to invoices. Each use has the applied amount, the compact credit, and the invoice payment it was applied to. array(CreditUse) false
deleted_in_qbo Whether this credit was pushed to QuickBooks Online and later deleted there. boolean false
external_note A note on this credit, visible to the customer string false
id Unique ID for this credit string false
inserted_datetime The datetime at which the credit was created in Distru string false
internal_note An internal note on this credit string false
original_amount The amount this credit was originally created with. Never changes. string false
owner Information about a user in Distru User false
payment A record of money exchanged — received from a customer against an invoice, or paid to a vendor against a purchase order. Payment false
qb_credit_memo_id The id of the QuickBooks Online credit memo this credit maps to, when synced. string false
qb_payment_id The id of the QuickBooks Online payment this credit maps to, when synced. string false
qb_sync_status The credit's QuickBooks Online sync status. Only meaningful when the QuickBooks Online integration is enabled; null otherwise. Values: PENDING (the latest sync covering this credit is still in flight), ERROR (the latest sync covering this credit failed), DELETED_IN_QBO (pushed to QuickBooks Online once, then deleted there), NOT_SYNCED (never pushed to QuickBooks Online), PARTIALLY_SYNCED (the credit is in QuickBooks Online but at least one of its applications has not been synced yet), SYNCED (fully synced). string false
remaining_balance The unused balance still available on this credit string false
return A compact representation of a return CompactReturn false
source How this credit was created string false
status The status of this credit. ACTIVE has a remaining balance, REDEEMED is fully used, CANCELED was voided. string false
updated_datetime The datetime at which the credit was last updated in Distru string false

CreditResponse

A single credit wrapped in a data envelope

Property Description Type Required
data Store credit held by a customer that can be applied toward what they owe. Credits can be issued manually or generated automatically (for example from a return or an invoice overpayment). Credit false

CreditUse

An application of a credit to an invoice payment

Property Description Type Required
amount The amount of the credit applied to the invoice payment string false
credit A compact representation of a credit CompactCredit false
id Unique ID for this credit use string false
inserted_datetime The datetime at which this credit use was created in Distru string false
payment A record of money exchanged — received from a customer against an invoice, or paid to a vendor against a purchase order. Payment false

Credits

A collection of Credits

Property Description Type Required
data Credits array(Credit) false
next_page URL for the next page of results; null when there is no next page string false

CultivationTransactionHistoryReport

The Cultivation Transaction History report

Property Description Type Required
data The report rows array(CultivationTransactionHistoryReportRow) true
meta Report-level metadata CultivationTransactionHistoryReportMeta true

CultivationTransactionHistoryReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

CultivationTransactionHistoryReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(CultivationTransactionHistoryReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

CultivationTransactionHistoryReportRow

A single row of the Cultivation Transaction History report (one cultivation transaction). The total_cost key is omitted for users without permission to view costs.

Property Description Type Required
amount The signed transaction amount number false
batch_name The plant batch name string false
date The transaction date, in the company's timezone string false
description The transaction description string false
package_label_s The package compliance label(s) string false
plant_tag_s The plant tag(s) involved string false
product_name The product name string false
related_entity The related entity (teardown or harvest) string false
related_entity_status The related entity's status string false
strain The strain name string false
total_cost The transaction's total cost number false
type The transaction type string false
unit The unit string false

CustomField

A user-defined field attached to a record, with the value set for this particular record. Which custom fields exist is configured in Distru; use GET /public/v1/custom-fields to list the definitions and their IDs.

Property Description Type Required
id Unique ID for this custom field integer 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

CustomFieldDefinition

A custom field definition

Property Description Type Required
description Description of the custom field string false
disabled_field_options The subset of field_options that have been turned off. Applies only to dropdown and checkbox fields; always empty for text and date fields. A disabled option can no longer be selected on new or edited records, but it stays in field_options and is listed here so that historical records already holding the value continue to display it. Every value here also appears in field_options. Example: a dropdown with field_options ["Small", "Medium", "Large"] and disabled_field_options ["Medium"] keeps showing "Medium" on records saved with it, but "Medium" is no longer offered when picking a value. array(any) false
field_options The selectable values for dropdown and checkbox fields; empty for other field types array(any) false
field_type The kind of value this field stores, e.g. text, date, dropdown, checkbox string false
filterable Whether records can be filtered by this field's value boolean false
id Custom field ID integer false
name Name of the custom field string false
parent_object The entity type this field is attached to, e.g. order, invoice, product, company, contact, package, batch string false
required Whether a value for the field is required when saving a record boolean false

CustomFieldDefinitionResponse

A single custom field definition wrapped in a data envelope

Property Description Type Required
data A custom field definition CustomFieldDefinition false

CustomFieldDefinitions

A collection of custom field definitions

Property Description Type Required
data CustomFieldDefinitions array(CustomFieldDefinition) false
next_page URL for the next page of results; null when there is no next page string false

Driver

A driver

Property Description Type Required
birth_date The driver's birth date (ISO-8601 date) string false
driver_license The driver's license number string false
email The driver's email string false
first_name The driver's first name string false
hire_date The driver's hire date (ISO-8601 date) string false
id Unique ID for this driver string false
inserted_datetime When the driver was created (UTC ISO-8601) string false
last_name The driver's last name string false
occupational_license_number The driver's occupational license number string false
phone_number The driver's phone number string false
updated_datetime When the driver was last updated (UTC ISO-8601) string false
us_state The driver's US state string false

DriverResponse

A single driver

Property Description Type Required
data A driver Driver false

Drivers

A collection of drivers

Property Description Type Required
data Drivers array(Driver) false
next_page URL for the next page of results; null when there is no next page string false

FileAttachment

A file attachment

Property Description Type Required
assembly_id ID of the assembly this file is attached to, if any string false
batch_id ID of the batch this file is attached to, if any string false
company_relationship_id ID of the company relationship this file is attached to, if any string false
contact_id ID of the contact this file is attached to, if any string false
id Unique ID for this file attachment string false
invoice_id ID of the invoice this file is attached to, if any string false
license_id ID of the license this file is attached to, if any string false
mime_type MIME type of the file; null when the file is missing string false
name The file name string false
order_id ID of the order this file is attached to, if any string false
order_shipment_id ID of the order shipment this file is attached to, if any string false
product_id ID of the product this file is attached to, if any string false
purchase_id ID of the purchase this file is attached to, if any string false
request_id ID of the request this file is attached to, if any string false
return_id ID of the return this file is attached to, if any string false
size_in_bytes Size of the file in bytes; null when the file is missing integer false
stock_transfer_id ID of the stock transfer this file is attached to, if any string false
task_id ID of the task this file is attached to, if any string false
upload_datetime When the file was uploaded (UTC ISO-8601) string false
uploader.id string false
uploader.name string false
url URL to download the file; null when the file is missing string false

FileAttachmentResponse

A single file attachment wrapped in a data envelope

Property Description Type Required
data A file attachment FileAttachment false

FinishPackagesRequest

Property Description Type Required
finished_datetime When the packages were finished (ISO 8601). Defaults to the current time. string false
package_ids Non-empty list of at most 300 package UUIDs to finish array(any) true

HarvestOutputsReport

The Harvest Outputs report

Property Description Type Required
data The report rows array(HarvestOutputsReportRow) true
meta Report-level metadata HarvestOutputsReportMeta true

HarvestOutputsReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

HarvestOutputsReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(HarvestOutputsReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

HarvestOutputsReportRow

A single row of the Harvest Outputs report (one input, output, or cost line item of a harvest assembly). The cost keys (unit_cost_actual, unit_cost_default, total_cost_actual, total_cost_default, cost_type, cost_type_description) are omitted for users without permission to view costs.

Property Description Type Required
cost_input_output The line item type (Input, Output, or Cost) string false
cost_type The cost type name string false
cost_type_description The cost type description string false
distru_product The Distru product name string false
harvest_assembly_date The harvest assembly date string false
harvest_assembly_number The harvest assembly number string false
harvest_name The harvest name string false
line_item_id The line item ID string false
location The location name string false
output_batch_number The output batch number string false
output_package_number The output package compliance label string false
output_reference_id The referenced output ID for cost line items string false
product_category The product category string false
quantity The line item quantity number false
status The assembly status string false
strain The strain name string false
total_cost_actual Actual total cost — unit_cost_actual multiplied by the row's quantity. number false
total_cost_default Default (standard) total cost — unit_cost_default multiplied by the row's quantity. number false
unit_cost_actual Actual cost per unit — the real cost Distru traces to the inputs and components that produced this inventory (purchase prices, assembly costs, stock-adjustment costs, and so on), per unit. number false
unit_cost_default Default (standard) cost per unit — traced the same way as unit_cost_actual, but each input/component is valued at its product's configured unit cost (unit_cost) instead of its real cost. number false
unit_type The unit type string false

Image

An image as shown in Distru

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

Inventories

A list of active and available quantity for each group

Property Description Type Required
data Inventories array(Inventory) false
next_page URL for the next page of results; null when there is no next page string false

Inventory

Property Description Type Required
active Total on-hand quantity for this group (decimal string) string true
available Quantity free to sell or use, i.e. active minus reserved (decimal string) string true
batch_number The batch number of the batch or the package string false
cost_default_per_unit Default (standard) cost per unit — total_cost_default divided by the active quantity. string false
cost_per_unit_actual Actual cost per unit — total_cost_actual divided by the active quantity. string false
location_id ID of the location string false
product_id ID of the product string true
reserved Quantity spoken for but not yet fulfilled, and therefore not sellable (decimal string). This is the quantity on unfulfilled line items of PROCESSING sales orders plus the quantity on unfulfilled inputs of pending assemblies — "unfulfilled" meaning no specific package or batch has been assigned yet. string true
total_cost_actual Total actual cost of the active quantity. Distru traces the inputs and components that produced the currently active inventory and sums their real costs incurred along the chain that led to this inventory — for example the price paid when a component was purchased, assembly costs, and costs added by stock adjustments, among others. string false
total_cost_default Total default (standard) cost of the active quantity. Traced the same way as total_cost_actual, but each input/component is valued at its product's configured unit cost (the product's unit_cost) instead of its real cost. string false
updated_datetime The datetime at which the inventory was last updated string false

InventoryAssetsReport

The Inventory Assets report

Property Description Type Required
data The report rows array(InventoryAssetsReportRow) true
meta Report-level metadata InventoryAssetsReportMeta true

InventoryAssetsReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

InventoryAssetsReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(InventoryAssetsReportColumn) false
date_range The human-readable date the report was generated string false
report The report identifier string true

InventoryAssetsReportRow

A single row of the Inventory Assets report. The final_input, cost_origin, and cost_quantity keys are present only when style=granular. Cost keys (unit_cost_actual, unit_cost_default, total_cost_actual, total_cost_default) are omitted for users without permission to view costs.

Property Description Type Required
active_quantity The active on-hand quantity number false
assembling_quantity The quantity being assembled number false
batch_number The batch number string false
category The product's category string false
cost_origin The origin of the cost input (granular) string false
cost_quantity The quantity attributed to the cost input (granular) number false
expiration_date The asset's expiration date string false
final_input Whether the row is the final asset or a cost input (granular) string false
harvest_date The package's harvest date string false
license The location's license number string false
location The location name string false
owner The product owner's name string false
package_number The package compliance label string false
product The product name string false
selling_quantity The quantity being sold number false
sku The product SKU string false
subcategory The product's subcategory string false
total_cost_actual Actual total cost — unit_cost_actual multiplied by the row's quantity. number false
total_cost_default Default (standard) total cost — unit_cost_default multiplied by the row's quantity. number false
tracking_method The product's inventory tracking method string false
unit_cost_actual Actual cost per unit — the real cost Distru traces to the inputs and components that produced this inventory (purchase prices, assembly costs, stock-adjustment costs, and so on), per unit. number false
unit_cost_default Default (standard) cost per unit — traced the same way as unit_cost_actual, but each input/component is valued at its product's configured unit cost (unit_cost) instead of its real cost. number false
unit_price The product's unit price number false
unit_type The unit type string false
vendor The product's vendor string false

InventoryTransactionHistoryReport

The Inventory Transaction History report

Property Description Type Required
data The report rows array(InventoryTransactionHistoryReportRow) true
meta Report-level metadata InventoryTransactionHistoryReportMeta true

InventoryTransactionHistoryReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

InventoryTransactionHistoryReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(InventoryTransactionHistoryReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

InventoryTransactionHistoryReportRow

A single row of the Inventory Transaction History report (one inventory transaction). Companies on the BioTrack compliance integration do not get the metrc_unit_name and metrc_production_batch_number keys. Potency keys are only populated for package-based transactions.

Property Description Type Required
amount The transaction amount (signed quantity) number false
batch_id The batch ID string false
batch_number The Distru batch number string false
cbd The package CBD percentage number false
cbd_mg_g The package CBD in mg/g number false
cbd_mg_ml The package CBD in mg/mL number false
company_relationship_id The ID of the related company (customer or vendor) string false
date The transaction date and time, in the company's timezone string false
description The transaction description string false
metrc_production_batch_number The Metrc production batch number string false
metrc_unit_name The Metrc unit name string false
package_batch_number_or_batch_name The package batch number or, for batch-tracked products, the batch name string false
package_label The package compliance label string false
product The product name string false
product_id The product ID string false
related_entity The related entity (order, return, assembly, adjustment...) string false
related_entity_customer_vendor The related entity's customer or vendor name string false
related_entity_status The related entity's status string false
thc The package THC percentage number false
thc_mg_g The package THC in mg/g number false
thc_mg_ml The package THC in mg/mL number false
total_cbd The package total CBD percentage number false
total_cbd_mg_g The package total CBD in mg/g number false
total_cbd_mg_ml The package total CBD in mg/mL number false
total_cost The transaction's total cost number false
total_thc The package total THC percentage number false
total_thc_mg_g The package total THC in mg/g number false
total_thc_mg_ml The package total THC in mg/mL number false
type The transaction type string false
unit_type The unit type string false

InventoryValuationReport

The Inventory Valuation report

Property Description Type Required
data The report rows array(InventoryValuationReportRow) true
meta Report-level metadata InventoryValuationReportMeta true

InventoryValuationReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

InventoryValuationReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(InventoryValuationReportColumn) false
date_range The human-readable date the report was generated string false
report The report identifier string true

InventoryValuationReportRow

A single row of the Inventory Valuation report (one product). Companies with Product custom fields will see additional keys. When calculation_method=cost, the active_value_price key is returned as active_value_cost instead.

Property Description Type Required
active_quantity The active on-hand quantity number false
active_value_price The active inventory value (priced by unit price) number false
assembling_quantity The quantity being assembled number false
available_quantity The available quantity (active minus reserved) number false
brand The product's brand string false
category The product's category string false
group The product's group string false
image_url The product's thumbnail image URL string false
incoming_quantity The incoming quantity from open purchases number false
inventory_threshold_max The product's inventory alert maximum number false
inventory_threshold_min The product's inventory alert minimum number false
name The product name string false
owner The product owner's name string false
pending_output_quantity The quantity pending output from open assemblies number false
reserved_quantity The reserved quantity number false
sku The product SKU string false
subcategory The product's subcategory string false
unit_cost The product's unit cost number false
unit_price The product's unit price number false
unit_type The product's unit type string false
vendor The product's vendor string false

Invoice

A bill to a customer for what they owe, tracking the total, how much has been paid, and what remains. Always generated from a sales order.

Property Description Type Required
billing_location A location with its license number inlined, as nested on orders/invoices/purchases LocationWithLicense false
charges A collection of Charges array(Charge) false
company A company as nested inside another entity in Distru CompanyCompact 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
external_notes Notes on this invoice that are visible to 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
internal_notes Notes on this invoice that are only visible internally 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
order A compact view of an order as nested inside another entity in Distru CompactOrder false
owner Information about a user in Distru User false
paid_amount The payment amount recorded against this invoice so far. string false
payment_term_name The name of the payment term applied to this invoice (e.g. "Net 30") string false
payments A collection of the invoice's payments array(Payment) false
remaining_amount The remaining amount for this invoice string false
status The payment status of this invoice: NOT_PAID (nothing paid yet), PARTIALLY_PAID (some but not all paid), FULLY_PAID (paid in full), or OVER_PAID (payments exceed the total). string false
total The total for this invoice including taxes, discounts, and all line items string false
updated_datetime The datetime at which the invoice was last updated in Distru string false
voided_datetime The datetime the invoice was voided. An invoice is automatically voided when its sales order is canceled, and un-voided (cleared back to null) if that order later leaves the canceled status. Null for invoices that have never been voided. string false

InvoiceChargeRequest

Invoice charge params

Property Description Type Required
id Unique ID for this invoice charge. Omit it when creating a new charge — Distru assigns one. Provide an existing charge's ID to update that charge. 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

InvoiceHistoryReport

The Invoice History report

Property Description Type Required
data The report rows array(InvoiceHistoryReportRow) true
meta Report-level metadata InvoiceHistoryReportMeta true

InvoiceHistoryReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

InvoiceHistoryReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(InvoiceHistoryReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

InvoiceHistoryReportRow

A single row of the Invoice History report. Companies on a compliance integration and companies with Invoice custom fields will see additional keys.

Property Description Type Required
charge_summary A per-charge breakdown of the invoice charges string false
customer The customer name string false
discount_summary A per-discount breakdown of the invoice discounts string false
due_date The due date, in the company's timezone string false
invoice_date The invoice date, in the company's timezone string false
invoice_number The invoice number string false
line_item_subtotal The invoice line item subtotal number false
outstanding The outstanding (unpaid) amount on the invoice number false
owner The invoice owner's name string false
paid The amount paid on the invoice number false
sales_order The sales order number the invoice belongs to string false
status The invoice payment status string false
tax_summary A per-tax breakdown of the invoice taxes string false
total The invoice total number false
total_charges The total charges on the invoice number false
total_discounts The total discounts on the invoice number false
total_taxes The total taxes on the invoice number false

InvoiceItem

A single billed line on an invoice. Read product, inventory, and cost details from the embedded order_item. Responses may also include deprecated legacy copies of some order-item fields at the top level; these are omitted here — use order_item.

Property Description Type Required
description A free-text description for this invoice line item string false
id Unique ID for this invoice item string false
inserted_datetime The datetime this invoice item was created at string false
order_item A single product line on a sales order — what is being sold, how much, at what price, and which inventory (batch/package) fulfills it. SalesOrderItem false
order_item_id The ID of the order item this invoice item is associated with string false
quantity Quantity billed on this invoice item, expressed in the product's unit type string false

InvoiceItemRequest

Invoice item params

Property Description Type Required
description An optional free-text description for this billed line. string false
id Unique ID for this invoice item. Omit it when creating a new item — Distru assigns one. Provide an existing item's ID to update that item. string false
order_item_id The ID of the order item this line bills. Required, and it must belong to the invoice's order. The product, batch or package, and price are taken from that order item. string true
quantity The quantity being billed on this line, expressed in the product's unit type. Can be less than the order item's quantity for partial billing. number true

InvoicePayment

A payment received from a customer and applied to an invoice.

Property Description Type Required
amount The amount paid, in the invoice's currency number false
description 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 Online deposit account used for this payment string false
quickbooks_deposit_account_name The name of the QuickBooks Online deposit account used for this payment string false
quickbooks_sync_enqueued Whether a sync of this payment to QuickBooks Online was enqueued. False when the company isn't integrated with QuickBooks Online, or when the payment's invoice or credits aren't synced yet (those must be synced first). boolean false

InvoiceResponse

A single invoice wrapped in a data envelope

Property Description Type Required
data A bill to a customer for what they owe, tracking the total, how much has been paid, and what remains. Always generated from a sales order. Invoice false

Invoices

A collection of Invoices

Property Description Type Required
data Invoices array(Invoice) false
next_page URL for the next page of results; null when there is no next page string false

License

A cannabis license held by a company or tied to a location, identifying it to the state and its compliance system.

Property Description Type Required
active Whether this license is currently active boolean false
expiry_datetime The datetime this license expires string false
id Unique ID for this license string false
inserted_datetime The datetime this license was created at string false
issue_datetime The datetime this license was issued string false
license_number License number string false
license_type The license type as configured in Distru. A state-specific free-form value, e.g. "Distributor" or "Type 11 Distributor-Transport" string false

Location

A place where inventory is held. This is flexible: it can be a whole site such as a warehouse or store, or a more specific spot like a room or area within one. Has an address and optionally a license.

Property Description Type Required
address Human readable address for this location string false
apt The apartment/suite/unit of this location, or null string false
city The city of this location string false
company_id ID of the company that owns this location string false
country The country of this location string false
deleted_at The datetime of deletion if the location was deleted string false
id Unique ID for this location string false
inserted_datetime The datetime this location was created at string false
latitude The latitude of this location number false
license A cannabis license held by a company or tied to a location, identifying it to the state and its compliance system. 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
longitude The longitude of this location number false
metrc_id The Metrc location ID for this location, or null integer false
name Human readable name for this location string false
state The state of this location string false
street_address The street address of this location string false
updated_datetime The datetime this location was last updated at string false
zip The postal code of this location string false

LocationCompact

A location as nested inside another entity 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_id ID of the license this location is associated with, null if none string false
name Human readable name for this location string false

LocationResponse

A single location wrapped in a data envelope

Property Description Type Required
data A place where inventory is held. This is flexible: it can be a whole site such as a warehouse or store, or a more specific spot like a room or area within one. Has an address and optionally a license. Location false

LocationWithLicense

A location with its license number inlined, as nested on orders/invoices/purchases

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_id ID of the license this location is associated with, null if none string false
license_number License number of the location's license, null if none string false
name Human readable name for this location string false

Locations

A collection of Locations

Property Description Type Required
data Locations array(Location) false
next_page URL for the next page of results; null when there is no next page string false
Property Description Type Required
active Whether the menu is active boolean false
available_delivery_days Days of the week available for delivery, e.g. MONDAY, TUESDAY, ..., SUNDAY array(any) false
default_order_status Status applied to orders placed through this menu string false
discoverable Whether the menu is listed on the DistruCommerce marketplace. Only possible when visibility is PUBLIC boolean false
external_name The menu's name shown to customers viewing the menu string false
id Unique ID for this menu string false
inserted_datetime Created at (UTC ISO-8601) string false
internal_name The menu's name used internally in Distru; not shown to customers string false
minimum_order_lead_time_days Number of days from order placement that are unavailable for delivery integer false
minimum_order_subtotal Minimum order subtotal required to check out through this menu; null when unset string false
product_count Count of active products on the menu integer false
updated_datetime Updated at (UTC ISO-8601) string false
url The menu's primary public URL; null when the menu has no primary URL string false
visibility One of: PUBLIC, PRIVATE, PASSCODE_PROTECTED string false

A single menu wrapped in a data envelope

Property Description Type Required
data Menu false

A collection of menus

Property Description Type Required
data Menus array(Menu) false
next_page URL for the next page of results; null when there is no next page string false

MetrcTag

A Metrc tag: a unique compliance identifier provisioned to a license for tracking a package or plant in the state cannabis system.

Property Description Type Required
assigned_datetime The datetime this tag was assigned, or null if unassigned string false
commissioned_date The date this tag was commissioned in Metrc, or null string false
id Distru's unique ID for this Metrc tag (not a Metrc identifier) string false
inserted_datetime The datetime this tag was created in Distru (not a Metrc timestamp) string false
is_assigned Whether this tag has been assigned to a package or plant boolean false
kind Whether the tag is for a package or a plant string false
license_id ID of the license this tag belongs to string false
tag The Metrc tag label string false
updated_datetime The datetime this tag was last updated in Distru (not a Metrc timestamp) string false

MetrcTagResponse

A single Metrc tag

Property Description Type Required
data A Metrc tag: a unique compliance identifier provisioned to a license for tracking a package or plant in the state cannabis system. MetrcTag false

MetrcTags

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

Property Description Type Required
data Metrc Tags array(MetrcTag) false
next_page URL for the next page of results; null when there is no next page string false

MovePackagesRequest

Property Description Type Required
location_id UUID of the destination Distru location. Must belong to the same license as the packages. string true
metrc_location_id Metrc's own location id. When provided, the packages are also moved to this Metrc location. string false
package_ids Non-empty list of at most 300 package UUIDs to move. All must belong to the same license. array(any) true

OfficialProductCategories

A collection of official product categories

Property Description Type Required
data OfficialProductCategories array(OfficialProductCategory) false
next_page URL for the next page of results; null when there is no next page string false

OfficialProductCategory

A Distru standard, system-defined product category that your own product categories can map to

Property Description Type Required
id Unique ID for this official product category string false
name The name of the official product category string false

Order

A sale of products to a customer. Holds the line items sold, their quantities and prices, any extra charges/discounts/taxes, delivery and fulfillment details, and links to the resulting invoices and returns.

Property Description Type Required
billing_location A location with its license number inlined, as nested on orders/invoices/purchases LocationWithLicense false
biotrack_id The ID of the BioTrack manifest associated with this order string false
blaze_payment_type The payment type for an order shipping to a Blaze-associated company. string false
buyer_company A company as nested inside another entity in Distru CompanyCompact false
buyer_note A note left by the buyer when the order was placed through a Distru menu, or null string false
charges A collection of Charges array(Charge) false
combined_order A compact view of an order as nested inside another entity in Distru CompactOrder false
company A company as nested inside another entity in Distru CompanyCompact false
creator Information about a user in Distru User false
custom_data A collection of CustomData array(CustomField) false
delivered_datetime The datetime the order was marked Delivered or Completed, or null if it never reached those statuses string false
delivery_datetime The datetime on which the order was / will be delivered string false
due_datetime The datetime by which the customer is expected to pay for this order string false
external_notes External notes for this order 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
inventory_source A location with its license number inlined, as nested on orders/invoices/purchases LocationWithLicense false
invoices A collection of the invoices on this order array(CompactInvoice) false
items A collection of SalesOrderItems array(SalesOrderItem) false
leaflink_id The LeafLink ID for this order string false
leaflink_order_number The LeafLink order number for this order string false
menu A compact reference to a menu, nested inside another entity in Distru CompactMenu false
metrc_transfer_id The ID of the Metrc transfer associated with this order integer false
metrc_transfer_template_error The error explaining why this order's Metrc transfer template failed to sync. Only set while metrc_transfer_template_status is FAILED, null otherwise. string false
metrc_transfer_template_id The ID of the Metrc transfer template Distru created in Metrc for this order, or null if none has been created integer false
metrc_transfer_template_status The sync status of this order's Metrc transfer template, or null if no template sync has been requested. PENDING: the template is queued to be created or updated in Metrc. COMPLETED: the template exists in Metrc and matches this order. FAILED: the last sync attempt failed — see metrc_transfer_template_error for the reason. 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
payment_term_name The name of the payment term applied to this order string false
returns A collection of the returns on this order array(CompactReturn) false
shipping_location A location with its license number inlined, as nested on orders/invoices/purchases LocationWithLicense false
status Where this order is in its lifecycle, which also governs how it affects inventory. PENDING: does not affect inventory — assigning packages/batches to line items does not change their active quantity, unfulfilled items do not add to the product's reserved quantity, and the order cannot be associated with a compliance transfer. PROCESSING: affects inventory — assigning a package/batch to a line item moves that quantity out of active and into a committed selling state, unfulfilled items add to the product's reserved quantity, and the order may be associated with a compliance transfer. READY_TO_SHIP: same inventory behavior as PROCESSING, but every line item must be fulfilled. DELIVERING, DELIVERED, and COMPLETED: every line item must be fulfilled, and the order must be associated with a compliance transfer if it contains any package-tracked items. CANCELED: the order has been canceled — like PENDING, it does not affect inventory and cannot be associated with a compliance transfer. string false
total The total for this order including taxes, discounts, and all line items string false
updated_datetime The datetime at which the order was last updated in Distru string false

OrderChargeRequest

Order charge params

Property Description Type Required
id Unique ID for this order charge. Omit it when creating a new charge — Distru assigns one. Provide an existing charge's ID to update that charge. string false
name The name of this charge (e.g. "Delivery Fee") string false
percent The percentage applied for this charge. Used when type is PERCENT number false
price The flat amount for this charge. Used when type is PRICE 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

OrderFulfillmentReport

The Order Fulfillment report

Property Description Type Required
data The report rows array(OrderFulfillmentReportRow) true
meta Report-level metadata OrderFulfillmentReportMeta true

OrderFulfillmentReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

OrderFulfillmentReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions, including one column per matching order array(OrderFulfillmentReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

OrderFulfillmentReportRow

A single row of the Order Fulfillment report (one product). In addition to the keys below, each row carries one dynamic key per matching order, named after the slugified order number (e.g. so_1042), whose value is the quantity of this product on that order.

Property Description Type Required
category The product's category string false
group The product's group string false
product The product name string false
subcategory The product's subcategory string false
total_units The total units of this product across the matching orders number false
total_value The total value of this product across the matching orders number false
unit_price The product's unit price number false

OrderItemRequest

Order item params

Property Description Type Required
batch_id The ID of the batch this line item draws from; set it to fulfill a batch-tracked line, and the product is inferred from it (no product_id needed). To create an unfulfilled line instead, leave this empty and send product_id — the product's reserved quantity goes up without committing to a batch. Must be empty for product-tracked and package-tracked products. string false
compliance_quantity The compliance quantity for this item, expressed in the package's unit type; leave null when the item is not package-tracked (no package_id). Must be the full quantity currently in the package. number false
id Unique ID for this order item. Omit it when creating a new item — Distru assigns one. Provide an existing item's ID to update that item. string false
is_sample True if this order is a sample boolean false
location_id The ID of the location this order item is fulfilled from string false
package_id The ID of the package this line item draws from; set it to fulfill a package-tracked line, and the product is inferred from it (no product_id needed). To create an unfulfilled line instead, leave this empty and send product_id — the product's reserved quantity goes up without committing to a package. Must be empty for product-tracked and batch-tracked products. 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 being sold. Required for product-tracked products, where batch_id and package_id must be left empty. For batch- and package-tracked products, product_id is inferred when you send batch_id or package_id; sending it on its own instead creates an unfulfilled line item — the order commits to the product without drawing from a specific batch or package yet, which adds to the product's reserved quantity while the order is PROCESSING. Set batch_id or package_id later to fulfill it. Every line item must include at least one of product_id, batch_id, or package_id. string false
quantity Quantity used on this order item, expressed in the product's unit type number true

OrderResponse

A single order wrapped in a data envelope

Property Description Type Required
data A sale of products to a customer. Holds the line items sold, their quantities and prices, any extra charges/discounts/taxes, delivery and fulfillment details, and links to the resulting invoices and returns. Order false

Orders

A collection of Orders

Property Description Type Required
data Orders array(Order) false
next_page URL for the next page of results; null when there is no next page string false

Package

A specific, compliance-tracked quantity of a product identified by a unique tag (e.g. a Metrc package). This is the physical unit of inventory for package-tracked products. This is the compact reference; see PackageFull for all fields.

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

PackageFull

A specific, compliance-tracked quantity of a product with all its details — its tag, product, dates, quantity, and testing state. This is the physical unit of inventory for package-tracked products.

Property Description Type Required
batch_number The non-compliance batch number for this package string false
bins The bins this package is stored in. Only present when bin inventory tracking is enabled for the company. array(BinCompact) false
biotrack_id The BioTrack inventory ID for this package; null for non-BioTrack packages integer false
biotrack_inventory_type_id The BioTrack inventory type ID for this package integer false
biotrack_net_quantity_per_unit The BioTrack net quantity per unit for this package string false
biotrack_room_id The BioTrack room ID where this package is stored integer false
biotrack_status The package's BioTrack inventory status. Null for non-BioTrack packages. string false
biotrack_usable_weight The BioTrack usable weight for this package. For weighable (weight/volume) packages this is the package's weight at creation; for count-based packages it is the per-unit amount of cannabis. May be null for some inventory types (and is null for non-BioTrack packages). string false
compliance_label The unique tag assigned by the state compliance system (e.g. the Metrc package tag) string false
compliance_product_name The product name reported by the compliance system (e.g. Metrc, BioTrack) string false
compliance_strain_name The strain name reported by the compliance system (e.g. Metrc, BioTrack) string false
compliance_transferred_datetime The datetime this package was transferred out in the compliance system (ISO 8601); null if not transferred out string false
compliance_type The compliance system tracking this package: METRC or BIOTRACK; null if not compliance-tracked string false
cost_per_unit_actual Actual cost per unit — total_cost_actual divided by the package quantity. string false
cost_per_unit_default Default (standard) cost per unit — total_cost_default divided by the package quantity. string false
creator Information about a user in Distru User false
custom_data The custom data for this package array(CustomField) false
description The description for this package string false
expiration_datetime The date and time this package expires (ISO 8601) string false
finished_datetime The datetime this package was finished in the compliance system (ISO 8601); null if not finished string false
harvest_date The harvest date for this package (ISO 8601) string false
id Unique ID for this package in Distru string false
inactivated_datetime The datetime this package was inactivated (ISO 8601); null while active string false
inserted_datetime The datetime this package was created at (ISO 8601) string false
is_production_batch True if this package is a production batch boolean false
is_test_sample True if this package is a test sample boolean false
is_trade_sample True if this package is a Metrc trade sample boolean false
lab_testing_state Compliance lab testing state (e.g. Metrc); BioTrack uses analogous values string false
license A cannabis license held by a company or tied to a location, identifying it to the state and its compliance system. License false
location.id Unique ID for this Location string false
location.name The name of this Location string false
metrc_archived_date The date this package was archived in Metrc — i.e. the moment it was discontinued in Metrc (ISO 8601 date) string false
metrc_finished_date The date this package was finished in Metrc (ISO 8601 date) string false
metrc_id The Metrc package ID for this package; null for non-Metrc packages integer false
metrc_label The Metrc label for this package, null if not Metrc-tracked string false
metrc_production_batch_number The Metrc production batch number for this package string false
metrc_received_datetime The most recent datetime this package was received via a Metrc transfer (ISO 8601) string false
metrc_received_from_manifest_number The Metrc manifest number the package was most recently received from string false
metrc_source_harvest_names The Metrc source harvest names for this package string false
metrc_status The package's Metrc inventory status. Null for BioTrack-synced packages. string false
metrc_transfer_id The Metrc transfer ID this package is currently on; null if not in transit integer false
metrc_unit_name The Metrc unit of measure name for this package string false
owner Information about a user in Distru User false
packaged_date The compliance packaged date for this package (ISO 8601) string false
primary_test_result The compact primary test result nested on a package or batch PrimaryTestResult false
product_id The ID of this package's product string false
product_unit_quantity The quantity of this package expressed in it's product's unit type string false
product_unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false
quantity The last known accurate quantity of this package string false
quantity_active The active quantity in this package (i.e. quantity that can be used as input in an assembly, that can be moved to another location, that can be added to a sales order, that can be adjusted down, etc) string false
quantity_assembling This quantity of this package currently allocated towards a pending assembly string false
status The status of this package array(any) false
total_cost_actual Total actual cost of this package. Distru traces the inputs and components that produced the package and sums the real costs incurred along that chain — for example the price paid when a component was purchased, assembly costs, and costs added by stock adjustments, among others. string false
total_cost_default Total default (standard) cost of this package. Traced the same way as total_cost_actual, but each input/component is valued at its product's configured unit cost (the product's unit_cost) instead of its real cost. string false
unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false

PackageFullResponse

A single package wrapped in a data envelope

Property Description Type Required
data A specific, compliance-tracked quantity of a product with all its details — its tag, product, dates, quantity, and testing state. This is the physical unit of inventory for package-tracked products. PackageFull false

Packages

A collection of Packages

Property Description Type Required
data Packages array(PackageFull) false
next_page URL for the next page of results; null when there is no next page string false

Page

Pagination information for a request

Property Description Type Required
number Page number integer true

PageWithSize

Pagination information for a request

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

Payment

A record of money exchanged — received from a customer against an invoice, or paid to a vendor against a purchase order.

Property Description Type Required
amount The payment amount, in the currency of the related invoice or purchase string false
company A company as nested inside another entity in Distru CompanyCompact false
credit_uses Credits applied towards this invoice payment. Null for purchase payments. array(PaymentCreditUse) false
description Description of this payment string false
fully_paid_with_credits Whether this payment was fully paid using credits. When true, payment_method is null. boolean false
id Unique ID for this payment string false
inserted_datetime The datetime at which the payment was created in Distru string false
invoice A compact view of an invoice as nested inside another entity in Distru CompactInvoice false
overpayment_credits Credits created from overpaying this invoice payment. Null for purchase payments. array(PaymentCredit) false
payment_date The datetime of this payment string false
payment_method A way payments are made or received (e.g. Cash, Check, Credit Card, Bank Transfer). PaymentMethod false
payment_number The payment number as shown in the Distru UI string false
payment_type Whether this payment belongs to an invoice (INVOICE) or a purchase (PURCHASE) string false
purchase A compact representation of the purchase a payment belongs to PaymentPurchase false
quickbooks_deposit_account_id The QuickBooks Online deposit account ID for this payment string false
quickbooks_deposit_account_name The QuickBooks Online deposit account name for this payment. Only present on the single-payment response. string false
quickbooks_sync_enqueued Whether a QuickBooks Online sync was enqueued for this payment. Only present on the payment creation response. boolean false
status The status of this payment. Either POSTED or VOIDED. string false
updated_datetime The datetime at which the payment was last updated in Distru string false

PaymentCredit

A compact representation of a credit related to a payment

Property Description Type Required
amount The current amount of this credit string false
credit_number The credit number as shown in the Distru UI string false
id Unique ID for this credit string false
source How this credit was created string false

PaymentCreditUse

A credit applied towards an invoice payment

Property Description Type Required
amount The amount of credit applied towards the payment string false
credit A compact representation of a credit related to a payment PaymentCredit false
id Unique ID for this credit use string false

PaymentMethod

A way payments are made or received (e.g. Cash, Check, Credit Card, Bank Transfer).

Property Description Type Required
active Whether this payment method is active boolean false
deleted_at The datetime of deletion if the payment method was deleted string false
id Unique ID for this payment method string false
inserted_datetime The datetime this payment method was created at string false
name Name of the payment method string false
qb_payment_method_id The ID of the matching payment method in QuickBooks Online, if this payment method is synced string false
type The payment method type. One of CASH, CHECK, CREDIT_CARD, BANK_REMITTANCE, BANK_TRANSFER string false
updated_datetime The datetime this payment method was last updated at string false

PaymentMethodResponse

A single Payment Method

Property Description Type Required
data A way payments are made or received (e.g. Cash, Check, Credit Card, Bank Transfer). PaymentMethod false

PaymentMethods

A collection of Payment Methods

Property Description Type Required
data Payment Methods array(PaymentMethod) false
next_page URL for the next page of results; null when there is no next page string false

PaymentPurchase

A compact representation of the purchase a payment belongs to

Property Description Type Required
id Unique ID for this purchase string false
purchase_number The purchase number as shown in the Distru UI string false
status The status of this purchase string false
total The total amount of this purchase string false

PaymentResponse

A single Payment

Property Description Type Required
data A record of money exchanged — received from a customer against an invoice, or paid to a vendor against a purchase order. Payment false

PaymentTerm

The agreed timeframe a customer has to pay — for example "Net 30" means payment is due 30 days after the invoice.

Property Description Type Required
days Number of days until payment is due integer false
id Unique ID for this payment term string false
inserted_datetime The datetime this payment term was created at string false
locked Whether this payment term is a locked Distru default that cannot be edited boolean false
name Name of the payment term string false
time_of_day Time of day the payment is due string false
updated_datetime The datetime this payment term was last updated at string false

PaymentTerms

A collection of Payment Terms

Property Description Type Required
data Payment Terms array(PaymentTerm) false
next_page URL for the next page of results; null when there is no next page string false

Payments

A collection of Payments

Property Description Type Required
data Payments array(Payment) false
next_page URL for the next page of results; null when there is no next page string false

PdfDownloadUrl

The JSON envelope a PDF download endpoint returns when ?format=url is passed

Property Description Type Required
data.expires_datetime ISO 8601 datetime when the signed URL expires string false
data.url Temporary signed URL to download the PDF string false

PlantLifecycleReport

The Plant Lifecycle report

Property Description Type Required
data The report rows array(PlantLifecycleReportRow) true
meta Report-level metadata PlantLifecycleReportMeta true

PlantLifecycleReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

PlantLifecycleReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(PlantLifecycleReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

PlantLifecycleReportRow

A single row of the Plant Lifecycle report (one plant batch). The cost keys (total_cost_batch_stage, total_cost_veg_to_last_harvest, destroyed_plant_cost, total_lifecycle_cost) are omitted for users without permission to view costs.

Property Description Type Required
batch_creation_date The plant batch creation date string false
days_as_batch The number of days spent as a batch number false
days_veg_to_last_harvest The number of days from veg to the last harvest number false
destroyed_plant_cost The cost of destroyed plants number false
first_harvest_date The date of the batch's first harvest string false
harvest_name_s The names of the harvests the batch produced string false
last_harvest_date The date of the batch's last harvest string false
plant_batch_name The plant batch name string false
plants_destroyed The number of plants destroyed number false
plants_harvested The number of plants harvested number false
plants_promoted_to_veg The number of plants promoted to vegetative number false
plants_started The number of plants started number false
promoted_to_veg_date The date the batch was promoted to vegetative string false
strain The strain name string false
total_cost_batch_stage The total cost during the batch stage number false
total_cost_veg_to_last_harvest The total cost from veg to the last harvest number false
total_lifecycle_cost The total lifecycle cost number false
total_lifecycle_days The total number of lifecycle days number false

PrimaryTestResult

The compact primary test result nested on a package or batch

Property Description Type Required
cbd_mg_per_unit The CBD mg per unit for this test result string false
cbd_mg_per_unit_total The total CBD mg per unit for this test result string false
cbd_percentage The CBD percentage for this test result string false
cbd_percentage_total The total CBD percentage for this test result string false
coa_url Public URL to view/download this test result's Certificate of Analysis (COA), or null when no file is attached 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
thc_mg_per_unit The THC mg per unit for this test result string false
thc_mg_per_unit_total The total THC mg per unit for this test result string false
thc_percentage The THC percentage for this test result string false
thc_percentage_total The total THC percentage for this test result string false

Product

A sellable or trackable item in your catalog — its name, pricing, category, unit of measure, and how its inventory is tracked (see inventory_tracking_method).

Property Description Type Required
bill_of_materials A product's bill of materials (recipe of inputs and additional costs) BillOfMaterials false
brand A company as nested inside another entity in Distru CompanyCompact false
category The top-level classification of a product (e.g. Flower, Edibles, Concentrates). Categories are defined per company and can be organized into subcategories. ProductCategoryCompact false
creator Information about a user in Distru User false
custom_data The custom data for this product array(CustomField) false
deleted_at The datetime of deletion if the product was deleted string 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
gross_weight The gross weight of the product string false
gross_weight_unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false
id Unique ID for this product string false
images The images associated with the product array(Image) false
inserted_datetime The datetime this product was created at string false
inventory_tracking_method How this product's inventory is tracked. One of: BATCH (grouped into batches sharing traits such as expiration dates and test results), PACKAGE (inventory is defined by packages), PRODUCT (ungrouped; inventory exists directly on the product). string false
is_active Is this product active? boolean false
is_featured Is this product featured? boolean false
leaflink_product_id The LeafLink product ID this product is synced to, or null if not synced integer false
menu_visibility Which menus this product is shown in. One of DO_NOT_INCLUDE, INCLUDE_IN_ALL, INCLUDE_IN_SELECT (same values accepted by the upsert endpoint), or null if unset. The menus field below lists the specific menus the product belongs to — this is how you see which menus when the value is INCLUDE_IN_SELECT. When the value is INCLUDE_IN_ALL, menus lists every menu (newly created menus are automatically added). string false
menus Menus this product is associated with, ordered by menu creation time then id (includes inactive menus). Reflects menu_visibility: empty for DO_NOT_INCLUDE, the selected subset for INCLUDE_IN_SELECT, and every menu for INCLUDE_IN_ALL. array(CompactMenu) false
msrp The MSRP of the product string false
name Human readable name for this product string false
owner Information about a user in Distru User false
product_group.id Unique ID for this product group string false
product_group.name The name of this product group string false
quantity_available_threshold_max The maximum available quantity before an over-stock alert is triggered string false
quantity_available_threshold_min The minimum available quantity before a low-stock alert is triggered string false
sku The SKU configured for the product string false
strain A cannabis strain (its genetics), such as "Blue Dream". Products can be linked to a strain to carry its name and type. Strain false
subcategory A finer classification within a product category (e.g. "Pre-Rolls" under Flower). ProductSubcategoryCompact false
tags The tags associated with this product array(ProductTagRef) false
total_cannabinoid_unit The unit that total THC and CBD are measured in string false
total_cbd The total CBD of this product string false
total_thc The total THC of this product string false
treez_wholesale_price The Treez wholesale price of this product, or null string false
unit_cost The cost (or purchase price) of the product per unit. string false
unit_net_weight The net weight of the product per unit string false
unit_net_weight_serving_size_unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false
unit_price The price of one unit of this product string false
unit_serving_size The serving size of the product per unit string false
unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false
units_per_case The number of units of this product that come in one case, if any string false
upc The UPC of this product string false
updated_datetime The datetime this product was last updated at string false
vendor A company as nested inside another entity in Distru CompanyCompact false
wholesale_unit_price The wholesale unit price of this product number false

ProductCategories

A collection of product categories

Property Description Type Required
data Product Categories array(ProductCategory) false
next_page URL for the next page of results; null when there is no next page string false

ProductCategory

A product category

Property Description Type Required
id Unique ID for this product category string false
inserted_datetime When the product category was created (UTC ISO-8601) string false
name The name of the product category string false
official_product_category_id ID of the official product category this maps to (Distru's standard, system-defined category list; see GET /public/v1/official-product-categories) string false
updated_datetime When the product category was last updated (UTC ISO-8601) string false

ProductCategoryCompact

The top-level classification of a product (e.g. Flower, Edibles, Concentrates). Categories are defined per company and can be organized into subcategories.

Property Description Type Required
id Unique ID for this category string false
name Human readable name for this category string false
official_product_category_id The ID of Distru's standardized (official) category this maps to, used to normalize categories across companies string false

ProductCategoryResponse

A single product category

Property Description Type Required
data A product category ProductCategory false

ProductGroup

A product group

Property Description Type Required
id Unique ID for this product group string false
inserted_datetime When the product group was created (UTC ISO-8601) string false
name The name of the product group string false
updated_datetime When the product group was last updated (UTC ISO-8601) string false

ProductGroupResponse

A single product group

Property Description Type Required
data A product group ProductGroup false

ProductGroups

A collection of product groups

Property Description Type Required
data Product Groups array(ProductGroup) false
next_page URL for the next page of results; null when there is no next page string false

ProductPosMapping

A link between a Distru product and the matching product in an external point-of-sale (POS) system such as Blaze, Dutchie, or Treez

Property Description Type Required
blaze_asset_id Blaze asset ID string false
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_datetime Creation timestamp string false
pos_type POS type (BLAZE, DUTCHIE, or TREEZ) string false
product_id Distru product ID string false
treez_photo_url Treez photo URL string false
treez_product_id Treez product ID string false
treez_retailer_id Treez retailer ID integer false
updated_datetime Last update timestamp string false

ProductPosMappingResponse

Property Description Type Required
data A link between a Distru product and the matching product in an external point-of-sale (POS) system such as Blaze, Dutchie, or Treez ProductPosMapping false

ProductPosMappingsResponse

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

ProductResponse

A single Product

Property Description Type Required
data A sellable or trackable item in your catalog — its name, pricing, category, unit of measure, and how its inventory is tracked (see inventory_tracking_method). Product false

ProductSubcategories

A collection of product subcategories

Property Description Type Required
data Product Subcategories array(ProductSubcategory) false
next_page URL for the next page of results; null when there is no next page string false

ProductSubcategory

A product subcategory

Property Description Type Required
category The top-level classification of a product (e.g. Flower, Edibles, Concentrates). Categories are defined per company and can be organized into subcategories. ProductCategoryCompact false
id Unique ID for this product subcategory string false
inserted_datetime When the product subcategory was created (UTC ISO-8601) string false
name The name of the product subcategory string false
updated_datetime When the product subcategory was last updated (UTC ISO-8601) string false

ProductSubcategoryCompact

A finer classification within a product category (e.g. "Pre-Rolls" under Flower).

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

ProductSubcategoryResponse

A single product subcategory

Property Description Type Required
data A product subcategory ProductSubcategory false

ProductTagRef

A tag associated with a product

Property Description Type Required
id Unique ID for this tag string false
name The name of this tag string false

Products

A collection of Products

Property Description Type Required
data Products array(Product) false
next_page URL for the next page of results; null when there is no next page string false

Purchase

An order to buy inventory from a vendor. Holds the line items being bought, their quantities and prices, any extra charges, and the payments made against it. Receiving against it brings the inventory in.

Property Description Type Required
billing_location A location with its license number inlined, as nested on orders/invoices/purchases LocationWithLicense false
biotrack_id The BioTrack transfer ID this purchase was matched with, if any string false
charges A collection of Charges array(Charge) false
company A company as nested inside another entity in Distru CompanyCompact false
creator Information about a user in Distru User false
custom_data The custom data for this purchase order array(CustomField) false
description A description of the purchase order string false
due_datetime The datetime by which the purchase order should be paid 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
location A location with its license number inlined, as nested on orders/invoices/purchases LocationWithLicense false
metrc_transfer_id The Metrc transfer ID this purchase was matched with, if any integer false
order_datetime The datetime on which the order was placed string false
owner Information about a user in Distru User false
paid The total amount paid towards this purchase order across all payments string false
payment_status The payment status of this purchase order string false
payments A collection of the purchase's payments array(Payment) false
purchase_number The purchase order number as shown in the Distru UI string false
qb_bill_id The ID of the associated bill in QuickBooks Online, if synced string false
status Where this purchase order is in its lifecycle, which also governs when inventory is received. PENDING, PROCESSING, and DELIVERING behave identically: the order has not been received and does not affect inventory. PARTIALLY_RECEIVED: works together with each line item's received_quantity — when at least one item has a positive received_quantity but not every item has received_quantity equal to its quantity, the order must be in this status, and the received amounts are brought into inventory. Not supported for orders that contain package-tracked items. COMPLETED: the whole order has been received, bringing its inventory into your facility; if the order has package-tracked items it must be associated with a compliance transfer. Only COMPLETED may be associated with a compliance transfer — no other status can. Once received (PARTIALLY_RECEIVED or COMPLETED) an order can no longer be moved back to PENDING, PROCESSING, or DELIVERING, and once it is associated with a compliance transfer it is effectively locked at COMPLETED. string false
supplier_location A location as nested inside another entity in Distru LocationCompact false
total The total for this order including taxes, discounts, and all line items string false
updated_datetime The datetime at which the order was last updated in Distru string false

PurchaseChargeRequest

Purchase charge params

Property Description Type Required
id Unique ID for this purchase charge. Omit it when creating a new charge — Distru assigns one. Provide an existing charge's ID to update that charge. string false
name The name of this charge string true
percent The percent value for this charge. Required if unit_type is PERCENT number false
price The flat price for this charge. Required if unit_type is PRICE. Auto-calculated for percent-based charges number false
type Type of this line item. Note: Tax charges should be sent as CHARGE with a tax_id string true
unit_type Determines if this line is tracked as a percentage or a flat charge string true

PurchaseItemRequest

Purchase item params. Must provide either batch_id or product_id. If batch_id is provided, product_id will be auto-filled. The metrc_package_id, biotrack_id, and compliance_quantity fields are only used when matching the purchase with an incoming compliance transfer (see the endpoint description). received_quantity is only used when the purchase status is PARTIALLY_RECEIVED.

Property Description Type Required
batch_id The ID of the batch to receive this line into (an existing batch). Provide it for batch-tracked products; the product is inferred from it, so product_id isn't needed. Must be left empty for product-tracked and package-tracked products. string false
biotrack_id The BioTrack package ID this line maps to within the matched incoming BioTrack transfer. Only used when the purchase is matched with a BioTrack transfer via the top-level biotrack_id. string false
compliance_quantity The full quantity in the matched compliance package, expressed in the package's unit type. Required for each line when matching the purchase with an incoming Metrc or BioTrack transfer; omit otherwise. number false
id Unique ID for this purchase order item. Omit it when creating a new item — Distru assigns one. Provide an existing item's ID to update that item. string false
location_id The ID of the location this line's inventory is received into. Defaults to the purchase's location_id when omitted. string false
metrc_package_id The Metrc package ID this line maps to within the matched incoming Metrc transfer. Only used when the purchase is matched with a Metrc transfer via the top-level metrc_transfer_id. integer false
price Price per unit of the inventory being received on this purchase item number true
product_id The ID of the product being purchased. Required for product-tracked and package-tracked products; for batch-tracked products it's inferred from batch_id, so you don't need to send it. Each line item must include batch_id or product_id. It must also be set when the line provides metrc_package_id or biotrack_id to match a compliance transfer package. string false
quantity Quantity received in this purchase item number true
received_quantity The quantity received so far on this line, in the product's unit type. Only settable when the purchase status is PARTIALLY_RECEIVED (and the line is not package-tracked); must be between 0 and quantity. Omit for any other status — it is derived automatically. It may be decreased in a later call as long as the previously-received amount has not been consumed elsewhere in Distru. number false

PurchaseOrderHistoryReport

The Purchase Order History report

Property Description Type Required
data The report rows array(PurchaseOrderHistoryReportRow) true
meta Report-level metadata PurchaseOrderHistoryReportMeta true

PurchaseOrderHistoryReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

PurchaseOrderHistoryReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(PurchaseOrderHistoryReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

PurchaseOrderHistoryReportRow

A single row of the Purchase Order History report. Companies on a compliance integration and companies with Purchase custom fields will see additional keys.

Property Description Type Required
amount The purchase total number false
due_date The due date, in the company's timezone string false
owner The purchase owner's name string false
paid The amount paid on the purchase number false
purchase_date The purchase date, in the company's timezone string false
purchase_number The purchase number string false
status The purchase status string false
vendor The vendor name string false

PurchaseOrderItem

A single product line on a purchase order — what is being bought, how much, at what price, and how much has been received so far.

Property Description Type Required
batch A lot of a product — a group of inventory that shares traits such as a harvest/production run, expiration date, and lab results. Used for batch-tracked products. This is the compact reference; see BatchFull for all fields. Batch false
compliance_quantity The quantity of this order item expressed in its package's unit type. Null if not package-tracked. string false
id Unique ID for this order item string false
is_sample True if this order item is a sample boolean false
location A location as nested inside another entity in Distru LocationCompact false
package A specific, compliance-tracked quantity of a product identified by a unique tag (e.g. a Metrc package). This is the physical unit of inventory for package-tracked products. This is the compact reference; see PackageFull for all fields. Package false
price Price per unit of this order item (with discounts applied) string false
price_base Price per unit of this order item string false
product A sellable or trackable item in your catalog — its name, pricing, category, unit of measure, and how its inventory is tracked (see inventory_tracking_method). Product false
quantity Quantity purchased on this order item, expressed in the product's unit type string false
received_quantity Quantity received on this order item. Less than or equal to the quantity field. string false

PurchasePayment

A payment you made to a vendor against a purchase order.

Property Description Type Required
amount The amount paid, in the purchase order's currency number false
description 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 Online deposit account used for this payment string false
quickbooks_deposit_account_name The name of the QuickBooks Online deposit account used for this payment string false

PurchaseResponse

A single purchase order envelope

Property Description Type Required
data An order to buy inventory from a vendor. Holds the line items being bought, their quantities and prices, any extra charges, and the payments made against it. Receiving against it brings the inventory in. Purchase false

Purchases

A collection of Purchases

Property Description Type Required
data Purchases array(Purchase) false
next_page URL for the next page of results; null when there is no next page string false

PurchasesByCompanyReport

The Purchases By Company report

Property Description Type Required
data The report rows array(PurchasesByCompanyReportRow) true
meta Report-level metadata PurchasesByCompanyReportMeta true

PurchasesByCompanyReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

PurchasesByCompanyReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(PurchasesByCompanyReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

PurchasesByCompanyReportRow

A single row of the Purchases By Company report. Companies with CompanyRelationship custom fields will see additional keys.

Property Description Type Required
category The vendor's category string false
last_purchase_date The date of the vendor's most recent purchase string false
name The vendor (related company) name string false
product_owner The vendor's owner (sales rep) name string false
purchase_order_count The number of purchases in the reported date range number false
relationship_type The vendor's relationship type string false
total_purchases The total cost of the vendor's purchases number false

PurchasesByProductReport

The Purchases By Product report

Property Description Type Required
data The report rows array(PurchasesByProductReportRow) true
meta Report-level metadata PurchasesByProductReportMeta true

PurchasesByProductReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

PurchasesByProductReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(PurchasesByProductReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

PurchasesByProductReportRow

A single row of the Purchases By Product report. Companies with Product custom fields will see additional keys.

Property Description Type Required
category The product's category string false
group The product's group string false
name The product name string false
owner The product owner's name string false
quantity_purchased The quantity purchased number false
sale_price The product's sale price number false
sku The product SKU string false
subcategory The product's subcategory string false
total_purchased The total cost of the purchased quantity number false
unit_cost The product's unit cost number false
unit_type The product's unit type string false
vendor The product's vendor string false
wholesale_price The product's wholesale price number false

RelationshipType

How a company relates to your business — whether they are a customer you sell to, a vendor you buy from, or both.

Property Description Type Required
id Unique ID for this relationship type string false
name Name of the relationship type (e.g. Customer, Vendor) string false

Return

Product a customer sent back, reversing the related inventory and financials. Usually tied to the original order, and may generate a credit for the customer.

Property Description Type Required
company A company as nested inside another entity in Distru CompanyCompact false
creator Information about a user in Distru User false
credits The credits generated from this return. array(CompactCredit) false
custom_data Custom data associated with this return map false
description Description of the return string false
id Unique ID for this return string false
inserted_datetime The datetime at which the return was created in Distru string false
invoice_numbers Invoice numbers associated with the order array(any) false
items The items on this return array(ReturnItem) false
location A location as nested inside another entity in Distru LocationCompact false
order A compact view of an order as nested inside another entity in Distru CompactOrder false
order_quantity Total quantity of all items on the associated order string false
owner Information about a user in Distru User false
qb_credit_memo_id The id of the QuickBooks Online credit memo this return maps to, when synced. string false
return_datetime The datetime of the return string false
return_number The return number as shown in the Distru UI string false
return_quantity Total quantity of all items on this return string false
return_type Indicates if this is a Full Return or Partial Return. Full Return means ALL order items have been FULLY returned. Null if not associated with an order. string false
status Where this return is in its lifecycle. While PROCESSING, SHIPPED, or RECEIVED, the returned goods are set aside as returning stock and have not yet been added back to sellable inventory. Once COMPLETED, the returned goods are restocked into inventory (except items flagged as waste, which are written off instead), and the return can no longer be deleted. string false
total The total amount of this return number false
updated_datetime The datetime at which the return was last updated in Distru string false

ReturnItem

A single line on a return — how much of an order line item was sent back.

Property Description Type Required
id Unique ID for this return item string false
order_item A compact view of an order line item as nested inside another entity in Distru — what was sold, how much, at what price, and which inventory (batch/package) fulfills it. CompactOrderItem false
quantity Quantity returned number false
waste Whether this item was marked as waste boolean false

ReturnResponse

A single return envelope

Property Description Type Required
data Product a customer sent back, reversing the related inventory and financials. Usually tied to the original order, and may generate a credit for the customer. Return false

Returns

A collection of Returns

Property Description Type Required
data Returns array(Return) false
next_page URL for the next page of results; null when there is no next page string false

Role

A user role as shown in Distru

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

SalesByCompanyReport

The Sales By Company report

Property Description Type Required
data The report rows array(SalesByCompanyReportRow) true
meta Report-level metadata SalesByCompanyReportMeta true

SalesByCompanyReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

SalesByCompanyReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(SalesByCompanyReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

SalesByCompanyReportRow

A single row of the Sales By Company report. Companies with CompanyRelationship custom fields will see additional keys.

Property Description Type Required
category The customer's category string false
last_order_date The date of the customer's most recent order string false
name The customer (related company) name string false
order_count The number of orders in the reported date range number false
owner The customer's owner (sales rep) name string false
relationship_type The customer's relationship type string false
total_received The total payments received on the customer's orders number false
total_sales The total order sales, net of returns number false

SalesByProductReport

The Sales By Product report

Property Description Type Required
data The report rows array(SalesByProductReportRow) true
meta Report-level metadata SalesByProductReportMeta true

SalesByProductReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

SalesByProductReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(SalesByProductReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

SalesByProductReportRow

A single row of the Sales By Product report. Companies with Product custom fields will see additional keys.

Property Description Type Required
category The product's category string false
group The product's group string false
name The product name string false
product_owner The product owner's name string false
quantity_sold The quantity sold, net of returns number false
sale_price The product's sale price number false
shipped_from_license The license the sold items shipped from string false
sku The product SKU string false
subcategory The product's subcategory string false
total_sales The total sales, net of returns number false
unit_cost The product's unit cost number false
unit_type The product's unit type string false
upc The product's UPC string false
vendor The product's vendor string false
wholesale_price The product's wholesale price number false

SalesByUserReport

The Sales By User report

Property Description Type Required
data The report rows array(SalesByUserReportRow) true
meta Report-level metadata SalesByUserReportMeta true

SalesByUserReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

SalesByUserReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(SalesByUserReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

SalesByUserReportRow

A single row of the Sales By User report.

Property Description Type Required
leaderboard_rank The user's rank by total sales, with 1 as the top seller number false
order_count The number of orders in the reported date range number false
sales_pre_tax The pre-tax sales total, net of returns number false
total_sales The total sales, net of returns number false
user The user's (sales rep's) name string false

SalesOrderHistoryReport

The Sales Order History report

Property Description Type Required
data The report rows array(SalesOrderHistoryReportRow) true
meta Report-level metadata SalesOrderHistoryReportMeta true

SalesOrderHistoryReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

SalesOrderHistoryReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(SalesOrderHistoryReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

SalesOrderHistoryReportRow

A single row of the Sales Order History report. Companies on a compliance integration and companies with Order custom fields will see additional keys.

Property Description Type Required
charges_taxes_not_included The total charges on the order, taxes not included number false
customer The customer name string false
delivery_date The delivery date, in the company's timezone string false
delivery_date_utc The delivery date, in UTC string false
discounts_taxes_not_included The total discounts on the order, taxes not included number false
due_date The due date, in the company's timezone string false
due_date_utc The due date, in UTC string false
order_date The order date, in the company's timezone string false
order_date_utc The order date, in UTC string false
order_number The order number string false
outstanding The outstanding (unpaid) amount on the order number false
owner The order owner's name string false
paid The amount paid on the order number false
returns The total value of returns on the order number false
status The order status string false
subtotal The order subtotal number false
taxes The total taxes on the order number false
total The order total number false

SalesOrderItem

A single product line on a sales order — what is being sold, how much, at what price, and which inventory (batch/package) fulfills it.

Property Description Type Required
batch A lot of a product — a group of inventory that shares traits such as a harvest/production run, expiration date, and lab results. Used for batch-tracked products. This is the compact reference; see BatchFull for all fields. Batch false
compliance_quantity The quantity of this order item expressed in its package's unit type. Null if not package-tracked. string false
cost_per_unit Actual cost per unit — total_cost_actual divided by this order item's quantity. string false
cost_per_unit_default Default (standard) cost per unit — total_cost_default divided by this order item's quantity. string false
id Unique ID for this order item string false
inserted_datetime The datetime this order item was created at string false
is_sample True if this order item is a sample boolean false
leaflink_id The LeafLink ID for this order item, or null integer false
location A location as nested inside another entity in Distru LocationCompact false
note A note on this order item, or null string false
package A specific, compliance-tracked quantity of a product identified by a unique tag (e.g. a Metrc package). This is the physical unit of inventory for package-tracked products. This is the compact reference; see PackageFull for all fields. Package false
price Price per unit of this order item string false
price_base Price per unit before any discounts string false
product A sellable or trackable item in your catalog — its name, pricing, category, unit of measure, and how its inventory is tracked (see inventory_tracking_method). Product false
quantity Quantity sold on this order item, expressed in the product's unit type string false
returned_quantity Quantity returned on this order item string false
thc_percentage_total The total THC % this order line is reserved at, used when the company sells by potency. Only meaningful for batch- or package-tracked products (always null for product-tracked items). Set from the order/menu selection when the line is created — it is not derived from or changed by the assigned package (a package can only fulfill the line if its primary test result's total THC matches this value). Null when not selling by potency. string false
total_cost_actual Total actual cost of the non-returned quantity in this order item (i.e. quantity minus returned_quantity). Distru traces the inputs and components that produced the shipped inventory and sums the real costs incurred along that chain — for example the price paid when a component was purchased, assembly costs, and costs added by stock adjustments, among others. string false
total_cost_default Total default (standard) cost of the non-returned quantity in this order item. Traced the same way as total_cost_actual, but each input/component is valued at its product's configured unit cost (the product's unit_cost) instead of its real cost. string false

SalesOrderItemHistoryReport

The Sales Order Item History report

Property Description Type Required
data The report rows array(SalesOrderItemHistoryReportRow) true
meta Report-level metadata SalesOrderItemHistoryReportMeta true

SalesOrderItemHistoryReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

SalesOrderItemHistoryReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(SalesOrderItemHistoryReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

SalesOrderItemHistoryReportRow

A single row of the Sales Order Item History report (one sales order line item). Companies on a compliance integration and companies with Order custom fields will see additional keys (package, potency, manifest, and custom field columns).

Property Description Type Required
batch_number The batch number string false
brand The brand name string false
brand_id The brand ID string false
category The product category string false
customer The customer name string false
customer_id The customer ID string false
default_unit_cost The product's default unit cost number false
default_unit_price The product's default unit price number false
default_wholesale_price The product's default wholesale price number false
delivery_date The delivery date, in the company's timezone string false
delivery_date_utc The delivery date, in UTC string false
due_date The due date, in the company's timezone string false
due_date_utc The due date, in UTC string false
group The product group string false
invoice_numbers The invoice numbers associated with the line item string false
line_item_id The line item ID string false
order_date The order date, in the company's timezone string false
order_date_utc The order date, in UTC string false
order_id The order ID string false
order_item_price The line item price number false
order_number The order number string false
product The product name string false
product_id The product ID string false
product_sku The product SKU string false
quantity The line item quantity number false
returned_quantity The returned quantity on the line item number false
sales_rep The sales rep's name string false
source_package The compliance label of the source package the line item's package was repackaged from string false
status The order status string false
subcategory The product subcategory string false
upc The product UPC string false
vendor The vendor name string false
vendor_id The vendor ID string false

SalesOrderTaxReport

The Sales Order Tax report

Property Description Type Required
data The report rows array(SalesOrderTaxReportRow) true
meta Report-level metadata SalesOrderTaxReportMeta true

SalesOrderTaxReportColumn

Property Description Type Required
key The key used for this column in each data row string true
label The human-readable label of the column string true

SalesOrderTaxReportMeta

Report-level metadata

Property Description Type Required
columns The report's column definitions array(SalesOrderTaxReportColumn) false
date_range The human-readable date range the report covers string false
report The report identifier string true

SalesOrderTaxReportRow

A single row of the Sales Order Tax report (one tax type and rate)

Property Description Type Required
tax_rate The tax rate percentage number false
tax_type The name of the tax string false
total_tax The total tax collected for this tax type and rate number false

SplitPackageOutput

A single output package produced by the split

Property Description Type Required
batch_number Distru batch number stored on the output package. string false
bin_ids Bin IDs to assign the output package to. array(any) false
copy_custom_data_from_input When true, copies the source package's custom field values onto the output package. boolean false
costs Costs to apply to the output package. array(CostEntryInput) false
expiration_date Expiration date reported to Metrc, e.g. "2027-08-19". string false
input_compliance_quantity Amount drawn from the source package, in the source package's compliance unit. Must be > 0. number true
location_id The output location ID. Must be in the same Metrc license as the source package. string true
metrc_item_id The Metrc item id for the output. Required unless use_same_item is true, and must be omitted when it is. Must exist in the source package's Metrc license. integer false
metrc_label The Metrc tag for the new package. Must be an available tag in the source package's license. string true
metrc_notes Notes sent to Metrc as the output package's note when it is created (max 255 characters). string false
metrc_production_batch_number When set, flags the output as a Metrc production batch with this batch number. string false
output_compliance_quantity Size of the new package, in the output package's compliance unit (the source unit when use_same_item is true, otherwise the unit of metrc_item_id). Must be > 0. number true
package_date The output package's packaged date. Defaults to today when omitted. string false
product_id The output product ID. Must be package-tracked. string true
use_same_item When true, the output package reuses the source package's Metrc item and metrc_item_id must be omitted. boolean false

SplitPackageRequest

A Metrc source package and the output packages to split it into

Property Description Type Required
outputs The output packages to create, between 1 and 300 array(SplitPackageOutput) true
source_package_id The package to split. Must be package-tracked and in a Metrc license. string true

StockAdjustment

A manual change to on-hand inventory that isn't a sale, purchase, or transfer — for example recording waste, theft, damage, a physical recount, or a reconciliation with the state compliance system. A positive quantity adds inventory; a negative quantity removes it.

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 string false
compliance_quantity The quantity of this adjustment, expressed in the package's unit type. Null if this adjustment is not associated with a package-tracked product (i.e. no package_id). string false
compliance_unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false
creator Information about a user in Distru User false
description A free-text note explaining this adjustment string false
id Unique ID for this stock adjustment string false
inserted_datetime The datetime this adjustment was created at 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, expressed in the product's unit type string false
reason Why the inventory was adjusted (e.g. waste, stolen, damaged, expired, write-off, or a compliance reason) string false
total_cost The total cost of this adjustment string false
unit_cost The cost per unit of this adjustment string false
unit_type A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound). UnitType false
updated_datetime The datetime this adjustment was last modified at string false

StockAdjustmentResponse

A single stock adjustment envelope

Property Description Type Required
data A manual change to on-hand inventory that isn't a sale, purchase, or transfer — for example recording waste, theft, damage, a physical recount, or a reconciliation with the state compliance system. A positive quantity adds inventory; a negative quantity removes it. StockAdjustment false

StockAdjustments

A collection of Stock Adjustments

Property Description Type Required
data Stock Adjustments array(StockAdjustment) false
next_page URL for the next page of results; null when there is no next page string false

Strain

A cannabis strain (its genetics), such as "Blue Dream". Products can be linked to a strain to carry its name and type.

Property Description Type Required
id Unique ID for this strain string false
inserted_datetime The datetime this strain was created at string false
name Name of the strain string false
strain_type The type of strain, or null if unset string false
updated_datetime The datetime this strain was last updated at string false

StrainResponse

A single Strain

Property Description Type Required
data A cannabis strain (its genetics), such as "Blue Dream". Products can be linked to a strain to carry its name and type. Strain 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
data Strains array(Strain) false
next_page URL for the next page of results; null when there is no next page string false

Tag

A tag

Property Description Type Required
id Unique ID for this tag string false
name The name of the tag string false

TagResponse

A single tag envelope

Property Description Type Required
data A tag Tag false

Tags

A collection of tags

Property Description Type Required
data Tags array(Tag) false
next_page URL for the next page of results; null when there is no next page string false

Tax

A tax

Property Description Type Required
description The description of the tax string false
id Unique ID for this tax string false
inserted_datetime When the tax was created (UTC ISO-8601) string false
name The name of the tax string false
qb_account_id The associated QuickBooks Online account ID string false
qb_product_id The associated QuickBooks Online product ID string false
tags Tags associated with this tax array(Tag) false
tax_applied_after_charges When true, the tax is calculated on the amount after other charges (fees/discounts) are added, rather than on the pre-charge amount boolean false
tax_applied_after_price_tiers When true, the tax is calculated after price tier (tiered/volume pricing) adjustments are applied boolean false
tax_code The tax code string false
tax_rate_percent The tax rate as a percentage, e.g. 8.25 means 8.25% number false
updated_datetime When the tax was last updated (UTC ISO-8601) string false

TaxResponse

A single tax envelope

Property Description Type Required
data A tax Tax false

Taxes

A collection of taxes

Property Description Type Required
data Taxes array(Tax) false
next_page URL for the next page of results; null when there is no next page string false

TestResult

Lab results for a batch or package — the Certificate of Analysis (COA). Headline potency figures (THC/CBD) sit on this object; the full analyte breakdown (terpenes, pesticides, heavy metals, and more) is nested under additional_test_results.

Property Description Type Required
additional_test_results The full breakdown of individual analytes measured on a lab test, grouped by category (cannabinoids, terpenes, pesticides, heavy metals, microbials, mycotoxins, residual solvents, and more). Each value is a string. The unit is encoded in the field-name suffix: _percentage is percent by weight, _mg_per_unit is milligrams per unit, _ug_per_g is micrograms per gram, _ug_per_kg is micrograms per kilogram, and _cfu_per_g is colony-forming units per gram. A null or empty value means the analyte was not measured. AdditionalTestResult false
batch_id The ID of the batch this test result belongs to, or null string false
biotrack_id The BioTrack ID for this test result, or null string 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
coa_url Public URL to view/download this test result's Certificate of Analysis (COA), or null when no file is attached string false
id Unique ID for this test result string false
inserted_datetime The datetime this test result was created at 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
metrc_id The Metrc ID for this test result, or null integer 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
package_id The ID of the package this test result belongs to, or null 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

TestResultResponse

A single test result envelope

Property Description Type Required
data Lab results for a batch or package — the Certificate of Analysis (COA). Headline potency figures (THC/CBD) sit on this object; the full analyte breakdown (terpenes, pesticides, heavy metals, and more) is nested under additional_test_results. TestResult false

TestResults

A collection of Test Results

Property Description Type Required
data Test Results array(TestResult) false
next_page URL for the next page of results; null when there is no next page string false

UnitType

A unit of measure used for quantities and pricing (e.g. Gram, Each, Pound).

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

UnitTypeFull

A unit type

Property Description Type Required
active Whether this unit type is active and available for use; inactive ones are hidden from most pickers boolean false
category The category of the unit type string false
id Unique ID for this unit type string false
inserted_datetime When the unit type was created (UTC ISO-8601) string false
locked Whether this unit type is locked from being edited or deleted (typically Distru's built-in default units) boolean false
name The name of the unit type string false
qty_per_si_unit The number of this unit that make up one SI base unit of its category. For weight-based unit types the SI base unit is the kilogram (e.g. a Gram is 1000, a Pound is ~2.20462). For volume-based unit types the SI base unit is the liter (e.g. a Milliliter is 1000, a Gallon is ~0.264172). For count-based (discrete/each) unit types it is 1, since a count unit has no physical measure. string false
updated_datetime When the unit type was last updated (UTC ISO-8601) string false

UnitTypeFullResponse

A single unit type envelope

Property Description Type Required
data A unit type UnitTypeFull false

UnitTypes

A collection of unit types

Property Description Type Required
data Unit Types array(UnitTypeFull) false
next_page URL for the next page of results; null when there is no next page string false

UpsertCredit

Parameters for creating or updating a credit

Property Description Type Required
amount The credit amount. Must be greater than 0. Required when creating. number false
company_id ID of the customer (company) this credit applies to. Required when creating; cannot be changed on update. string false
external_note A note on this credit, visible to the customer string false
id ID of the credit to update. Omit to create a new credit. string false
internal_note An internal note on this credit string false
owner_id ID of the user who owns this credit. Defaults to the API user when creating. string false
quickbooks_sales_item_id Optional QuickBooks Online sales item this credit maps to, used only when QuickBooks Online credit sync is enabled. Omit or send null to use the default "Distru Sales" item. Never required. string false

UpsertProductPosMapping

Parameters for creating or updating a POS mapping

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

User

Information about a user in Distru

Property Description Type Required
banned Is this user banned by Distru? boolean false
deleted_at The datetime of deletion if the user was deleted string false
email The email address of this user string false
full_name The full name of this user string false
id Unique ID for this user string false
inserted_datetime The datetime this user was created at string false
role A user role as shown in Distru Role false

UserResponse

A single user envelope

Property Description Type Required
data Information about a user in Distru User false

Users

A collection of Users

Property Description Type Required
data Users array(User) false
next_page URL for the next page of results; null when there is no next page string false

Vehicle

A vehicle

Property Description Type Required
color The color of the vehicle string false
description A description or name for the vehicle string false
id Unique ID for this vehicle string false
inserted_datetime When the vehicle was created (UTC ISO-8601) string false
license_plate_number The license plate number string false
license_plate_state The license plate state string false
make The make of the vehicle string false
model The model of the vehicle string false
updated_datetime When the vehicle was last updated (UTC ISO-8601) string false
vin The vehicle identification number (VIN) string false
year The year of the vehicle string false

VehicleResponse

A single vehicle envelope

Property Description Type Required
data A vehicle Vehicle false

Vehicles

A collection of vehicles

Property Description Type Required
data Vehicles array(Vehicle) false
next_page URL for the next page of results; null when there is no next page string false

Changelog

2026-08-19

2026-08-18

2026-08-17

2026-08-13

2026-08-12

2026-08-03

2026-07-30

2026-07-29

Read/write parity pass across the API — every field that can be set can now be read back, and related resources (owner, locations, notes, custom data, tags) are exposed consistently.

2026-07-27

2026-06-29

2026-06-23

2026-06-08

2026-05-28

2026-05-25

2026-05-17

2026-05-11

2026-05-06

2026-05-01

2026-03-27

2026-03-10

2026-02-13

2026-02-12

2026-02-10

2026-01-23

2026-01-21

2026-01-19

2025-10-24

2025-10-19

2025-10-15

2025-09-10

2025-08-21

2025-08-20

2025-08-19

2025-07-01

2025-06-12

2025-06-12

2025-06-09

2025-05-27

2025-05-22

2025-05-18

2025-05-16

2025-05-15

2025-05-14

2025-05-13

2025-05-06

2025-04-09

2025-03-18

2025-03-11

2025-03-05

2025-02-26

2025-01-31

2025-01-17

2025-01-15

2025-01-08

2024-12-26

2024-12-24

2024-11-06

2024-10-02