Add a sample to an order

Add a sample to an existing order and return the updated order.

Send the sample as a single sample form field containing the JSON-encoded
object described below. The sample must belong to the same industry as the
rest of the order.

Samples cannot be added to an order that has been canceled or completed;
those requests fail with invalid_order_status.

Sample fields

  • name (string) — product name for this sample.
  • strain_name (string) — name of the sample strain. Optional for
    non-cannabis samples.
  • type_id (int) — ID from the sample type enumeration.
  • production_method_id (int) — ID from the production method enumeration.
    Use 99 to submit a blank value.
  • classification_id (int) — ID from the sample classification enumeration.
    Use 1 to submit a blank value.
  • test_package_ids (list of int) — IDs of the test packages ordered for this
    sample.
  • notes (string, optional) — additional notes about this sample.
  • lims_id (string, optional) — internal tracking ID for this sample.
  • production_date (date, optional) — date the sample or product was
    harvested or created.
  • date_samples_collected (date, optional) — date the sample was collected.
  • batch_id (string, optional) — batch identifier.
  • batch_size (float, optional) — batch size.
  • batch_size_unit (string, optional) — g for grams, units for units, or
    lb for pounds. Defaults to g.
  • lot_id (string, optional) — lot identifier.
  • lot_size (float, optional) — lot size.
  • lot_size_unit (string, optional) — g for grams, units for units, or
    lb for pounds. Defaults to g.
  • production_run_id (string, optional) — production run identifier.
  • production_run_size (float, optional) — production run size.
  • production_run_size_unit (string, optional) — g for grams, units for
    units, or lb for pounds. Defaults to g.
  • manifest_id (string, optional) — manifest identifier, often for
    seed-to-sale systems.
  • harvest_id (string, optional) — harvest identifier, often for seed-to-sale
    systems.
  • regulator_sample_id (string, optional) — seed-to-sale tracking ID for this
    sample.
  • regulator_batch_id (string, optional) — seed-to-sale batch ID for this
    sample.
  • regulator_lot_id (string, optional) — seed-to-sale lot ID for this sample.

The following fields are required to calculate mg/container values for
edibles:

  • unit_description (string, optional) — describes the serving unit of the
    sample.
  • unit_weight (float, optional) — weight of an individual unit.
  • units_per_serving (float, optional) — how many units make up one serving.
  • servings_per_container (float, optional) — how many servings are in a
    container.

The sample object also accepts:

  • send_client_email (boolean, optional) — if true the client receives email
    notifications for the order being edited. Defaults to true.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Form Data
string
required

JSON-encoded sample object — see the field reference below.

Headers
string

HMAC-SHA256 request signature. Required only when request signing is enabled for your API key — see the Request Signing guide.

string

Unix timestamp (seconds) of the request, required only when request signing is enabled for your API key. Requests older than 30 seconds are rejected.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json