Retrieve lab results details

Retrieve the lab test result details as provided by the licensed lab.

SecurityApiKeyAuth and CustomAuth

Request

path Parameters

state required	string Lower case ANSI standard 38:2009 USPS codes of the US state where licensee is operating. Enum: "ca" "il" "wa" "ma" "md" "mi" "wv" "co" "ok" "oh"
lot_id required	string lot id for requested lab results Example: a521f55de4394f4f99c282be687e63aa

query Parameters

license_number

required

string

Reference (entity_ID) for the license. This is the business license number issued by the state.

Example: license_number=ABC-1234

entity_state

string

Queryable entity states for lab test results. Not all entity states available for all states.

Enum: "lab_testing_not_submitted" "lab_testing_submitted" "lab_testing_in_progress" "lab_testing_awaiting_confirmation" "lab_testing_passed" "lab_testing_failed" "lab_retesting" "lab_retesting_passed" "lab_retesting_failed" "lab_testing_remediated_lot" "lab_testing_random_selection" "lab_testing_not_required" "lab_testing_process_validation" "lab_testing_completed"

header Parameters

x-api-key required	string Trace API key header Example: b123x21wbHlkYXBpa2V5
Authorization required	string Company and user credentials authentication Example: KMP-JSON token=dmVuZG9yLWFwaS1rZXk6dX12312sdfs2V5

Responses

200

400

Bad Request

get/{state}/v1/labs/results/{lot_id}

Response samples

application/json

{"results": {"type": "array",
"data": [{"license_number": "KML-1000555-LIC",
"id": "35104",
"lab": [{"id": "123",
"name": "KMP Judau Testing Laboratory 78",
"primary": ""
}
],
"contains_non_mandatory_tests": false,
"overall_result": "lab_testing_passed",
"original_test_id": "",
"test_use": "",
"batch_type": "",
"is_extraction_eligible": null,
"is_retest_eligible": null,
"test": [{"date": "2021-08-05T00:00:00Z",
"status": "lab_testing_passed",
"comment": "Required per regulation CSR.1.2.3.4",
"is_non_mandatory": false,
"revoked_date": "",
"test_detail_revoke_date": "",
"type": {"id": null,
"type": null,
"name": "Chlorantraniliprole (ug/g) (Edible - volume) [Phase 2]",
"detail": null
},
"result": {"level": 0.0345,
"unit_of_measure": null,
"total_thc_cbd": null,
"total_cbd": null,
"total_thc": null,
"is_high_cbd": null,
"is_high_thc": null,
"is_general_use": null,
"released": true,
"released_date": "2021-08-05T20:29:19Z",
"actioned_by": ""
}
},
{"date": "2021-08-05T00:00:00Z",
"status": "lab_testing_passed",
"comment": "Required per regulation CSR.1.2.3.5",
"is_non_mandatory": false,
"revoked_date": "",
"test_detail_revoke_date": "",
"type": {"id": null,
"type": null,
"name": "Chlordane (ug/g) (Edible - volume) [Phase 2]",
"detail": null
},
"result": {"level": 0.0345,
"unit_of_measure": null,
"total_thc_cbd": null,
"total_cbd": null,
"total_thc": null,
"is_high_cbd": null,
"is_high_thc": null,
"is_general_use": null,
"released": true,
"released_date": "2021-08-05T20:29:19Z",
"actioned_by": ""
}
}
],
"documents": [ ],
"entity_state": [{"state": "lab_testing_passed",
"date": "2021-05-21T20:29:19Z",
"reason": "lab_testing_passed",
"actioned_by": "KMP Judau Testing Laboratory 78"
}
],
"lots": {"license_number": "KMP-20201027-TST",
"action": {"id": "KOMLA0001",
"name": "split"
},
"id": "fg67e96ac61b4ca9bb9c2607f98f4",
"name": "Kodai 01 extract intermediate Lot lab test 1",
"barcode": "1KMBV1200000000046",
"quantity": 10,
"unit_of_measure": "Grams",
"date": "2021-05-03T18:27:39Z",
"type": {"id": "KOMLT0001",
"name": "Product"
},
"location": {"id": "fg67123c61b4ca9bb9c2607fghg6",
"name": "KMP Persona Location 1",
"type": {"id": "3",
"name": "Processing KMP 1"
}
},
"origin": {"plant": [ ],
"plant_batch": [ ],
"harvest": [ ],
"lots": [{"id": "fg67e96ac61b4ca9bb9c2607fghg6",
"barcode": "1KMBV1200000000045",
"name": "Kodai 01 extract intermediate sub lot A01",
"type": "Concentrate",
"quantity": 10,
"unit_of_measure": "Grams"
}
]
},
"contents": {"strain": {"id": "e239e96ac61b4ca9bb9c2607f2egghc86f4",
"name": "Queen Emeraldus Bounty"
},
"product": {"id": "fg67e96ac61b4ca9bb9c2607f98f4",
"name": "Kodai 01 extract intermediate",
"category": {"id": "e239e96ac61b4ca9bb9c2607f2cc86f4",
"type": "Concentrate",
"main_category": "Extract (weight)",
"sub_category": ""
},
"characteristics": {"quantity_type": "WeightBased",
"unit_of_measure": "Grams",
"ingredients": ["CO2 Kodai 01 extract intermediate"
],
"strain": {"id": "e239e96ac61b4ca9bb9c2607f2egghc86f4",
"name": "Queen Emeraldus Bounty"
},
"unit": {"cannabinoids": {"cbd_percent": 10,
"thc_percent": 10
},
"cbd_content": null,
"cbd_content_uom": null,
"cbd_content_dose": null,
"cbd_content_dose_uom": null,
"thc_content": null,
"thc_content_uom": null,
"thc_content_dose": null,
"thc_content_dose_uom": null,
"volume": null,
"volume_uom": null,
"weight": null,
"weight_uom": null,
"quantity": null,
"quantity_uom": null
},
"serving_size": null,
"serving_num": null,
"supply_duration_days": null,
"doses_number": null,
"lab_test_ref": "NotSubmitted",
"administration_method": "",
"brand": "KMP",
"description": "",
"image": {"product": "http://www.kmp-cat.com/product_image.png",
"label": "http://www.kmp.com/my_product_label.png",
"tracking_barcode": "http://www.kmp-cat.com/my_tracking_barcode_image.png",
"upc_barcode": "http://www.kmp-cat.com/my_upc_barcode_image.png",
"package": "http://www.kmp-cat.com/my_package_image.png"
},
"contains_seeds": false
}
}
},
"additional": {"patient_license": "",
"is_for_medical_use": false,
"medical_compliance_info": "no",
"note": "",
"is_production_batch": false,
"production_batch_id": "",
"is_trade_sample": false,
"is_donation": false,
"is_test_sample": true,
"is_process_validation_sample": false,
"is_requires_remediation": false,
"is_remediated": false,
"is_same_product": false,
"is_void": false,
"is_rejected": false,
"is_quarantine": false,
"is_initial_inventory": false,
"is_lab_or_QA_not_required": false,
"lab_or_qa_result_url": "",
"authentication_id": "",
"sample_data": ""
},
"adjustment": [ ],
"remediation": [ ],
"entity_state": [{"state": "active",
"date": "2021-05-21T20:29:19Z",
"reason": "lot created",
"actioned_by": "kodai@kmp.com"
},
{"state": "lab_testing_passed",
"date": "2021-07-26T20:29:19Z",
"reason": "lab_testing_passed",
"actioned_by": "kodai@kmp.com"
}
]
}
}
]
},
"warnings": [ ]
}