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

OK

400

Bad Request

get/{state}/v1/labs/results/{lot_id}
Response samples
application/json
{
  • "results": {
    },
  • "warnings": [ ]
}