Submit test results

POST /v0/labs/sample/{sample_id}/test_results

Submit test results for a sample. The payload surface is deliberately large so that it can describe any assay, but you only need to send what was actually tested - never include compounds that were not tested.

Results may be submitted while the sample's order is in any valid status, but every result is stored as a DRAFT and stays invisible to the client until the sample is published or its order moves to the completed stage. Set publish_data to true to publish the results, together with any draft CoA and CoA additions, as soon as they are submitted.

Each request replaces all previous test result data for the sample, so always submit the complete set of results in one call.

Request payload

test_results is a single JSON-encoded object. Build it with every tested category, then serialize it to a string and send it as the test_results form field.

{
  "categories": {
    "cannabinoids": {
      "info_fields": {
        "input_units": "%",
        "report_units": "%",
        "date_tested": "2026-08-14",
        "status": 1
      },
      "compounds": [
        {"name": "thca", "value": "21.34", "lod": "0.01", "loq": "0.03"},
        {"name": "d9_thc", "value": "0.68", "lod": "0.01", "loq": "0.03"}
      ]
    }
  }
}

Any compound returned by GET /compounds may be listed, within its own category. Setting "skip_coa": true alongside categories submits the data without generating a CoA.

Compound object

name and value are required; every other key is optional metadata, reported in the same units as value unless noted otherwise.

name: compound key for what was tested
value: the test result, as a string, e.g. "1.02"
lod: limit of detection
loq: limit of quantitation
limit: value above which this test fails
max: upper limit of quantitation
spike: spike recovery for the analyte
stdev: standard deviation of the sample replicate results
regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
qualifiers: testing qualifiers, where the regulator defines them
rsd: relative standard deviation of the analyte values
rpd: relative percent difference of the analyte values
limitrangehigh: upper limit when restricting value to a range
limitrangelow: lower limit when restricting value to a range
purity_percent: purity percentage for the analyte

General rules

All test values are numeric but must be submitted as strings, so that JSON encoding and decoding cannot lose precision. Sending bare numbers will likely produce inaccurate data.
Percentages are numbers between 0 and 100: report 23.1% as 23.1, not 0.231.
Statuses are integer IDs: 1 passed, 2 failed, 3 completed. Completed means the assay could neither pass nor fail.
input_units and report_units are required in info_fields for every category except general, and must come from that category's allowed units.
unit_weight is required whenever a unit field for the category is mg/unit, and ml_weight whenever one is mg/ml. Both drive mass-to-mass unit conversions, so a conversion that needs one and does not get it fails. When testing a cookie, send the weight of a whole cookie; when testing a liquid, send the weight of one millilitre.
footnote carries anything that should accompany the assay on the CoA - the definition of total THC and total CBD, dry weight versus wet weight, or other extraordinary QC data.

Error codes

A failed submission returns 400 with an error_code, plus error_field and error_category where they apply.

invalid_sample_id - no sample found with the requested id.
invalid_order_status - the sample's order cannot accept test results.
invalid_field - a field or category had the wrong type, or the category is unknown.
unknown_compound - an unknown compound was submitted.
duplicate_compound - a compound was given twice.
conversion_error - a result value could not be converted.
missing_required_field - a required field is missing.
invalid_date - an invalid date was given; dates are YYYY-MM-DD.
suspicious_date - a date much older than expected (before 2012) was given.
invalid_status - an invalid value was given for a status field.
invalid_unit - a category was reported in an unsupported unit.
significant_digits_outside_range - digits must be between 1 and 8 when digits_method is significant.
invalid_data - any other validation failure; error_field and error_category may be absent.

Categories

Each category below lists its allowed units, the defaults applied when a field is omitted, and every info field it accepts. The API also accepts dna, miscellaneous, ph and shelflife, which follow the same structure but have no published option set.

`alkaloids`

Allowed units: %, mg/container, mg/g, mg/ml, mg/serving, mg/unit, ppb, ppm

Defaults: input_units = %, report_units = %, digits = 2, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
ml_weight: the weight in grams of 1ml of sample when any unit fields are 'mg/ml'
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
secondary_report_units: the secondary units displayed on the certificate of analysis
servings_per_container: Number of servings per container
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'
units_per_serving: Number of units per serving
wet_weight: weight of aliquot as received

`anabolic_steroids`

Allowed units: %, mg/container, mg/g, mg/ml, mg/serving, mg/unit, ppb, ppm

Defaults: input_units = %, report_units = %, digits = 2, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
ml_weight: the weight in grams of 1ml of sample when any unit fields are 'mg/ml'
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
servings_per_container: Number of servings per container
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'
units_per_serving: Number of units per serving
wet_weight: weight of aliquot as received

`cannabinoids`

Allowed units: %, mg/container, mg/g, mg/ml, mg/serving, mg/unit, ppb, ppm

Defaults: input_units = %, report_units = %, digits = 2, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
container_description: Description of container (eg. bottle, box, tin)
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
method: testing method - eg, GC-FID, HPLC, etc
metrc_co_d9_thc_status: pass or fail integer ID from the status enum
metrc_me_total_thc_mg_package_status: pass or fail integer ID from the status enum
metrc_me_total_thc_mg_serving_status: pass or fail integer ID from the status enum
metrc_mi_potency_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mi_potency_status: pass or fail integer ID from the status enum
metrc_mi_potency_value: optional value for the 'Potency' field in Metrc
metrc_mi_total_cbd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mi_total_thc_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mi_total_thc_status: DEPRECATED
metrc_mi_total_thc_value: DEPRECATED
metrc_mn_other_adc_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mn_other_adc_status: pass or fail integer ID from the status enum
metrc_mn_other_adc_value: value for the 'Other ADC (mg/g) Full Panel ' field in Metrc. value should be in mg/serving
metrc_mn_thc_purity_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mn_thc_purity_status: pass or fail integer ID from the status enum
metrc_mn_thc_purity_value: value for the 'THC Purity (% or mg/g)' field in Metrc
metrc_mn_total_cannabinoids_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mn_total_cannabinoids_status: pass or fail integer ID from the status enum
metrc_mn_total_cbd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mn_total_cbd_status: pass or fail integer ID from the status enum
metrc_mn_total_thc_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mn_total_thc_status: pass or fail integer ID from the status enum
metrc_mt_total_cbd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mt_total_cbd_status: pass or fail integer ID from the status enum
metrc_mt_total_thc_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mt_total_thc_status: pass or fail integer ID from the status enum
metrc_oh_total_cbd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_oh_total_cbd_status: pass or fail integer ID from the status enum
metrc_oh_total_thc_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_oh_total_thc_status: pass or fail integer ID from the status enum
metrc_or_cbd_pct_rsd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_cbd_pct_rsd_status: pass or fail integer ID from the status enum
metrc_or_cbd_pct_rsd_value: Percent Relative Standard Deviation value for state traceability system
metrc_or_cbd_rpd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_cbd_rpd_status: pass or fail integer ID from the status enum
metrc_or_cbd_rpd_value: Relative Percent Difference value for state traceability system
metrc_or_d8_thc_pct_rsd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_d8_thc_pct_rsd_status: pass or fail integer ID from the status enum
metrc_or_d8_thc_pct_rsd_value: Percent Relative Standard Deviation value for state traceability system
metrc_or_d8_thc_rpd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_d8_thc_rpd_status: pass or fail integer ID from the status enum
metrc_or_d8_thc_rpd_value: Relative Percent Difference value for state traceability system
metrc_or_potency_control_study_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_potency_control_study_status: pass or fail integer ID from the status enum
metrc_or_potency_process_validation_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_potency_process_validation_status: pass or fail integer ID from the status enum
metrc_or_potency_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_potency_status: pass or fail integer ID from the status enum
metrc_or_thc_pct_rsd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_thc_pct_rsd_status: pass or fail integer ID from the status enum
metrc_or_thc_pct_rsd_value: Percent Relative Standard Deviation value for state traceability system
metrc_or_thc_rpd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_thc_rpd_status: pass or fail integer ID from the status enum
metrc_or_thc_rpd_value: Relative Percent Difference value for state traceability system
metrc_or_total_cbd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_total_thc_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_total_thc_status: pass or fail integer ID from the status enum
ml_weight: the weight in grams of 1ml of sample when any unit fields are 'mg/ml'
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
servings_per_container: Number of servings per container
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
totalcbd_outsidelimitrange
totalthc_outsidelimitrange
unit_description: definition of one unit when any unit fields are 'mg/unit'
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'
units_per_serving: Number of units per serving
wet_weight: weight of aliquot as received

`endotoxins`

Allowed units: eu/g, eu/mg, eu/ml

Defaults: input_units = eu/ml, report_units = eu/ml, digits = 2, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
ml_weight: the weight in grams of 1ml of sample when any unit fields are 'mg/ml'
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
servings_per_container: Number of servings per container
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'
units_per_serving: Number of units per serving
wet_weight: weight of aliquot as received

`flavonoids`

Allowed units: %, mg/container, mg/g, mg/ml, mg/serving, mg/unit, ppb, ppm

Defaults: input_units = %, report_units = %, digits = 2, digits_method = round

Info fields:

date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
ml_weight: the weight in grams of 1ml of sample when any unit fields are 'mg/ml'
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'
wet_weight: weight of aliquot as received

`foreign_matter`

Allowed units: %, mg/lb

Defaults: input_units = %, report_units = %, digits = 2, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
metrc_mi_foreign_organic_matter_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mi_foreign_organic_matter_value: value for the 'Foreign organic matter' field in Metrc.
metrc_nv_visual_inspection_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum

`homogeneity`

Allowed units: %, mg/unit

Defaults: input_units = %, report_units = %, digits = 0, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'

`metals`

Allowed units: mg/g, ppb, ppm

Defaults: input_units = ppb, report_units = ppb, digits = 0, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
metrc_mi_metals_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mi_metals_status: pass or fail integer ID from the status enum
metrc_mi_metals_value: optional value for the 'Metals' field in Metrc
metrc_or_metals_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_metals_status: pass or fail integer ID from the status enum
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum

`microbials`

Allowed units: cfu, cfu/g, cfu/m^3, cfu/ml, cfu/plate, cq, mpn/g

Defaults: input_units = cfu/g, report_units = cfu/g, digits = 0, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
metrc_co_microbials_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_co_microbials_status: pass or fail integer ID from the status enum
metrc_co_microbials_value: optional value for the 'Microbials' field in Metrc
metrc_mi_microbials_infused_bool: boolean true/false flag (0=false/1=true) to denote if the sample is an infused product
metrc_mi_microbials_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mi_microbials_status: pass or fail integer ID from the status enum
metrc_mi_microbials_value: optional value for the 'Microbials' field in Metrc
metrc_nv_microbials_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_nv_microbials_status: pass or fail integer ID from the status enum
metrc_nv_microbials_value: value for the 'Microbials' field in Metrc
metrc_or_microbials_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_microbials_status: pass or fail integer ID from the status enum
metrc_or_microbiological_process_validation_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_microbiological_process_validation_status: pass or fail integer ID from the status enum
ml_weight: the weight in grams of 1ml of sample when any unit fields are 'mg/ml'
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'
wet_weight: weight of aliquot as received

`moisture`

Allowed units: %

Defaults: input_units = %, report_units = %, digits = 1, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
wet_weight: weight of aliquot as received

`mycotoxins`

Allowed units: mg/g, ppb, ppm

Defaults: input_units = ppb, report_units = ppb, digits = 2, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
metrc_mi_mycotoxins_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mi_mycotoxins_status: pass or fail integer ID from the status enum
metrc_mi_mycotoxins_value: optional value for the 'Mycotoxins' field in Metrc
metrc_or_mycotoxins_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_mycotoxins_status: pass or fail integer ID from the status enum
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum

`nutrients`

Allowed units: %, mg/container, mg/g, mg/ml, mg/serving, mg/unit, ppb, ppm

Defaults: input_units = ppm, report_units = ppm, digits = 2, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
ml_weight: the weight in grams of 1ml of sample when any unit fields are 'mg/ml'
notes, notes_2 through notes_10: optional testing notes for this assay
report_units: the primary units displayed on the certificate of analysis
secondary_report_units: the secondary units displayed on the certificate of analysis
servings_per_container: Number of servings per container
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'
units_per_serving: Number of units per serving
wet_weight: weight of aliquot as received

`peptides`

Allowed units: %, iu, mg/container, mg/g, mg/ml, mg/serving, mg/unit, ppb, ppm

Defaults: input_units = %, report_units = %, digits = 2, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
ml_weight: the weight in grams of 1ml of sample when any unit fields are 'mg/ml'
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
servings_per_container: Number of servings per container
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'
units_per_serving: Number of units per serving
wet_weight: weight of aliquot as received

`pesticides`

Allowed units: mg/g, ppb, ppm

Defaults: input_units = ppm, report_units = ppm, digits = 3, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
metrc_co_other_pesticide_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_co_other_pesticide_status: pass or fail integer ID from the status enum
metrc_co_other_pesticide_value: the sum of all pesticide detections in ppm excluding Abamectin, Azoxystrobin, Bifenazate, Etoxazole, Imazalil, Imidacloprid, Malathion, Myclobutanil, Permethrin, Spinosad, Spiromesifen, Spirotetramat, and Tebuconazole
metrc_co_pesticide_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_co_pesticide_status: pass or fail integer ID from the status enum
metrc_co_pesticide_value: the total sum of all pesticides detected in ppm
metrc_mi_pesticides_chemical_residue_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mi_pesticides_chemical_residue_status: pass or fail integer ID from the status enum
metrc_mi_pesticides_chemical_residue_value: optional value for the 'Chemical Residue' field in Metrc
metrc_or_limited_batch_pesticide_testing_regulatornotes: DEPRECATED: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_pesticides_control_study_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_pesticides_control_study_status: pass or fail integer ID from the status enum
metrc_or_pesticides_process_validation_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_pesticides_process_validation_status: pass or fail integer ID from the status enum
metrc_or_pesticides_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_pesticides_status: pass or fail integer ID from the status enum
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
volume: volume of the aliquot in the solution
wet_weight: weight of aliquot as received

`solvents`

Allowed units: %, mg/g, ppb, ppm

Defaults: input_units = ppm, report_units = ppm, digits = 3, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
metrc_co_solvents_other_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_co_solvents_other_status: pass or fail integer ID from the status enum
metrc_co_solvents_other_value: the sum of all residual solvent detections in ppm excluding Benzene, Butanes, Heptanes, Hexane, Toluene, and Total Xylenes
metrc_co_solvents_remediated_bool: boolean true/false flag (0=false/1=true) to denote if the sample is from a batch made from remediated product
metrc_co_solvents_residual_regulatornotes: DEPRECATED: notes posted to state traceability systems such as METRC or BioTrack
metrc_co_solvents_residual_status: DEPRECATED: pass or fail integer ID from the status enum
metrc_mi_solvents_residual_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_mi_solvents_residual_status: pass or fail integer ID from the status enum
metrc_mi_solvents_residual_value: optional value for the 'Residual Solvents' field in Metrc
metrc_or_solvents_control_study_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_solvents_control_study_status: pass or fail integer ID from the status enum
metrc_or_solvents_pct_rsd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_solvents_pct_rsd_status: pass or fail integer ID from the status enum
metrc_or_solvents_pct_rsd_value: value for the 'Solvents (RPD)' field in Metrc
metrc_or_solvents_process_validation_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_solvents_process_validation_status: pass or fail integer ID from the status enum
metrc_or_solvents_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_solvents_rpd_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_solvents_rpd_status: pass or fail integer ID from the status enum
metrc_or_solvents_rpd_value: Relative Percent Difference value for state traceability system
metrc_or_solvents_status: pass or fail integer ID from the status enum
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
wet_weight: weight of aliquot as received

`terpenes`

Allowed units: %, mg/container, mg/g, mg/ml, mg/serving, mg/unit, ppb, ppm

Defaults: input_units = %, report_units = %, digits = 2, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
container_description: Description of container (eg. bottle, box, tin)
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
dry_weight: weight of aliquot after drying
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
ml_weight: the weight in grams of 1ml of sample when any unit fields are 'mg/ml'
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
servings_per_container: Number of servings per container
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum
totalterpenes_outsidelimitrange
unit_description: definition of one unit when any unit fields are 'mg/unit'
unit_weight: the weight in grams of the whole unit submitted for sampling when any unit fields are 'mg/unit'
units_per_serving: Number of units per serving
volume: volume of the aliquot in the solution
wet_weight: weight of aliquot as received

`water_activity`

Allowed units: aw

Defaults: input_units = aw, report_units = aw, digits = 5, digits_method = round

Info fields:

analytical_batch_id: optional analytical batch ID for QC samples
analytical_batch_id_2: optional second analytical batch ID for QC samples
date_prepared: date the sample was prepared for this assay
date_tested: date the sample was tested for this assay
digits: number of digits to display on the certificate of analysis; see digits_method
digits_method: round rounds to digits decimal places, significant rounds to digits significant figures
footnote: footnote to accompany this assay
input_units: units the data is being submitted in, from the category's allowed units
notes, notes_2 through notes_10: optional testing notes for this assay
qc_blank_dup_id: optional sample ID for QC Blank duplicate
qc_blank_id: optional sample ID for QC Blank
qc_blank_trip_id: optional sample ID for QC Blank triplicate
qc_control_study_id: optional sample ID for Control Study
qc_lcs_dup_id: optional sample ID for QC Lab Control Sample duplicate
qc_lcs_id: optional sample ID for QC Lab Control Sample
qc_lcs_trip_id: optional sample ID for QC Lab Control Sample triplicate
qc_sample_dup_id: optional sample ID for QC sample duplicate
qc_sample_id: optional sample ID for QC sample
qc_sample_trip_id: optional sample ID for QC sample triplicate
qc_spike_dup_id: optional sample ID for QC Spike duplicate
qc_spike_id: optional sample ID for QC Spike
qc_spike_trip_id: optional sample ID for QC Spike triplicate
report_units: the primary units displayed on the certificate of analysis
reported_as_wet: optional flag for if numbers are reported including moisture weight (wet) or converted (dry)
secondary_report_units: the secondary units displayed on the certificate of analysis
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report
status: pass or fail integer ID from the status enum

`general`

Allowed units: none. This category carries no numeric results.

Info fields:

amended: has the data been amended
amended_notes: optional notes detailing the amendment to the lab data
footnote: footnote to accompany this assay
metrc_co_contaminants_regulatornotes: DEPRECATED: notes posted to state traceability systems such as METRC or BioTrack
metrc_co_contaminants_status: DEPRECATED: pass or fail integer ID from the status enum
metrc_nv_subcontract_testing_value: DEPRECATED
metrc_ok_retest_all_value: value for the 'Retest (All)' field in Metrc
metrc_ok_subcontract_all_value: DEPRECATED
metrc_or_r_and_d_test_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_subcontracted_test_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
metrc_or_tic_regulatornotes: notes posted to state traceability systems such as METRC or BioTrack
notes, notes_2 through notes_10: optional testing notes for this assay
retest_id
retest_sample_id
signatory_name: name of lab employee to appear on certificate of analysis
signatory_title: title of lab employee to appear on certificate of analysis
signature: URL of the signature image for the report

Path parameters

sample_id string required

Body parameters (application/x-www-form-urlencoded)

publish_data boolean optional

Publish the results, and any draft CoA and CoA additions, as soon as they are stored. Defaults to false, which leaves everything in draft.

Default: False

date_published string optional

Publication date to record when publish_data is true. Defaults to the time of the request.

test_results string required

The results, as a JSON-encoded object. See the description above for its structure and for the fields each category accepts.

Try it

Responses

200 Success

No fields beyond the success envelope.

400 Bad request

The request was malformed or failed validation. Validation failures include per-field messages in error_details.

Possible error_code values: invalid_request, request_too_old.

401 Unauthorized

Authentication failed.

Possible error_code values: missing_api_key, invalid_api_key, invalid_credentials_type, api_access_restricted, api_access_denied, missing_signature, missing_timestamp, invalid_timestamp, invalid_signature.

403 Permission denied

The API key is valid but does not have permission for this endpoint (for example, a client key calling a labs endpoint).

Possible error_code values: permission_denied.

404 Not found

The requested record does not exist or is not visible to this organization.

Possible error_code values: not_found.

# X-ConfidentLims-Signature: see the Request Signing guide - https://api.confidentcannabis.com/v0/docs/request-signing.md
curl -X POST 'https://api.confidentcannabis.com/v0/labs/sample/{sample_id}/test_results' \
  -H 'X-ConfidentLims-APIKey: YOUR_API_KEY' \
  -H 'X-ConfidentLims-Timestamp: UNIX_TIMESTAMP' \
  -H 'X-ConfidentLims-Signature: REQUEST_SIGNATURE' \
  --data-urlencode 'test_results={
  "categories": {
    "cannabinoids": {
      "info_fields": {
        "input_units": "%",
        "report_units": "%",
        "date_prepared": "2026-08-13",
        "date_tested": "2026-08-14",
        "method": "HPLC-DAD",
        "digits": 2,
        "status": 1
      },
      "compounds": [
        {
          "name": "thca",
          "value": "21.34",
          "lod": "0.01",
          "loq": "0.03"
        },
        {
          "name": "d9_thc",
          "value": "0.68",
          "lod": "0.01",
          "loq": "0.03"
        },
        {
          "name": "cbda",
          "value": "0.11",
          "lod": "0.01",
          "loq": "0.03"
        },
        {
          "name": "cbd",
          "value": "0.04",
          "lod": "0.01",
          "loq": "0.03"
        }
      ]
    },
    "moisture": {
      "info_fields": {
        "input_units": "%",
        "report_units": "%",
        "date_tested": "2026-08-14",
        "status": 3
      },
      "compounds": [
        {
          "name": "moisture",
          "value": "11.20"
        }
      ]
    },
    "water_activity": {
      "info_fields": {
        "input_units": "aw",
        "report_units": "aw",
        "date_tested": "2026-08-14",
        "status": 1
      },
      "compounds": [
        {
          "name": "water_activity",
          "value": "0.58",
          "limit": "0.65"
        }
      ]
    }
  }
}'

import time
import requests

# sign_request() is defined in the Request Signing guide:
# https://api.confidentcannabis.com/v0/docs/request-signing.md
from sign_request import sign_request

API_KEY = 'YOUR_API_KEY'
API_SECRET = 'YOUR_API_SECRET'
path = '/v0/labs/sample/{sample_id}/test_results'

data = {
    "test_results": "{\n  \"categories\": {\n    \"cannabinoids\": {\n      \"info_fields\": {\n        \"input_units\": \"%\",\n        \"report_units\": \"%\",\n        \"date_prepared\": \"2026-08-13\",\n        \"date_tested\": \"2026-08-14\",\n        \"method\": \"HPLC-DAD\",\n        \"digits\": 2,\n        \"status\": 1\n      },\n      \"compounds\": [\n        {\n          \"name\": \"thca\",\n          \"value\": \"21.34\",\n          \"lod\": \"0.01\",\n          \"loq\": \"0.03\"\n        },\n        {\n          \"name\": \"d9_thc\",\n          \"value\": \"0.68\",\n          \"lod\": \"0.01\",\n          \"loq\": \"0.03\"\n        },\n        {\n          \"name\": \"cbda\",\n          \"value\": \"0.11\",\n          \"lod\": \"0.01\",\n          \"loq\": \"0.03\"\n        },\n        {\n          \"name\": \"cbd\",\n          \"value\": \"0.04\",\n          \"lod\": \"0.01\",\n          \"loq\": \"0.03\"\n        }\n      ]\n    },\n    \"moisture\": {\n      \"info_fields\": {\n        \"input_units\": \"%\",\n        \"report_units\": \"%\",\n        \"date_tested\": \"2026-08-14\",\n        \"status\": 3\n      },\n      \"compounds\": [\n        {\n          \"name\": \"moisture\",\n          \"value\": \"11.20\"\n        }\n      ]\n    },\n    \"water_activity\": {\n      \"info_fields\": {\n        \"input_units\": \"aw\",\n        \"report_units\": \"aw\",\n        \"date_tested\": \"2026-08-14\",\n        \"status\": 1\n      },\n      \"compounds\": [\n        {\n          \"name\": \"water_activity\",\n          \"value\": \"0.58\",\n          \"limit\": \"0.65\"\n        }\n      ]\n    }\n  }\n}",
    # optional form fields go here - they are signed too
}

headers = {'X-ConfidentLims-Timestamp': str(int(time.time()))}
headers['X-ConfidentLims-Signature'] = sign_request(
    'POST', path, headers, data, API_KEY, API_SECRET)
headers['X-ConfidentLims-APIKey'] = API_KEY

response = requests.post(
    'https://api.confidentcannabis.com' + path,
    headers=headers,
    data=data,
)
print(response.json())

// signRequest() is defined in the Request Signing guide:
// https://api.confidentcannabis.com/v0/docs/request-signing.md
import { signRequest } from './sign_request.js';

const API_KEY = 'YOUR_API_KEY';
const API_SECRET = 'YOUR_API_SECRET';
const path = "/v0/labs/sample/{sample_id}/test_results";

const data = {
  "test_results": "{\n  \"categories\": {\n    \"cannabinoids\": {\n      \"info_fields\": {\n        \"input_units\": \"%\",\n        \"report_units\": \"%\",\n        \"date_prepared\": \"2026-08-13\",\n        \"date_tested\": \"2026-08-14\",\n        \"method\": \"HPLC-DAD\",\n        \"digits\": 2,\n        \"status\": 1\n      },\n      \"compounds\": [\n        {\n          \"name\": \"thca\",\n          \"value\": \"21.34\",\n          \"lod\": \"0.01\",\n          \"loq\": \"0.03\"\n        },\n        {\n          \"name\": \"d9_thc\",\n          \"value\": \"0.68\",\n          \"lod\": \"0.01\",\n          \"loq\": \"0.03\"\n        },\n        {\n          \"name\": \"cbda\",\n          \"value\": \"0.11\",\n          \"lod\": \"0.01\",\n          \"loq\": \"0.03\"\n        },\n        {\n          \"name\": \"cbd\",\n          \"value\": \"0.04\",\n          \"lod\": \"0.01\",\n          \"loq\": \"0.03\"\n        }\n      ]\n    },\n    \"moisture\": {\n      \"info_fields\": {\n        \"input_units\": \"%\",\n        \"report_units\": \"%\",\n        \"date_tested\": \"2026-08-14\",\n        \"status\": 3\n      },\n      \"compounds\": [\n        {\n          \"name\": \"moisture\",\n          \"value\": \"11.20\"\n        }\n      ]\n    },\n    \"water_activity\": {\n      \"info_fields\": {\n        \"input_units\": \"aw\",\n        \"report_units\": \"aw\",\n        \"date_tested\": \"2026-08-14\",\n        \"status\": 1\n      },\n      \"compounds\": [\n        {\n          \"name\": \"water_activity\",\n          \"value\": \"0.58\",\n          \"limit\": \"0.65\"\n        }\n      ]\n    }\n  }\n}",
  // optional form fields go here - they are signed too
};

const headers = { 'X-ConfidentLims-Timestamp': String(Math.floor(Date.now() / 1000)) };
headers['X-ConfidentLims-Signature'] = signRequest(
  "POST", path, headers, data, API_KEY, API_SECRET);
headers['X-ConfidentLims-APIKey'] = API_KEY;

const response = await fetch("https://api.confidentcannabis.com" + path, {
  method: "POST",
  headers,
  body: new URLSearchParams(data),
});
console.log(await response.json());

{
  "success": true
}