Retrieve harvest(s) details

Retrieve the harvest details. If the id is not provided, the details of all the active harvests for the license_number are obtained, filtered by the query parameter(s) criteria

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"
id required	string Harvest ID 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
limit	number Optional parameter that allows you to specify a number to limit the results in the response. Default limit is 100. Example: limit=100
offset	number Optional parameter that allows you to offset records if the max number for the filter exceeds the limit. Example: offset=0
name	string Display name of the harvest. Example: name=Harvest strain 06122022 manicure A02
expand	string The expand query parameter is used to include additional information for the child objects in the harvests response. Enum: "cure" "waste" "lots" "all"
entity_state	string Queryable entity states for plant. Inactive will return harvested, destroyed, and/or deleted harvests. Enum: "active" "inactive" "curing" "cured" "updated" "finished" "unfinished" "onhold" "lab_testing_not_submitted" "lab_testing_submitted" "lab_testing_in_progress" "lab_testing_awaiting_confirmation" "lab_testing_passed" "lab_testing_failed" "lab_retesting_in_progress" "lab_retest_passed" "lab_retest_failed"
start_date	string Starting date for the time range of harvest's modifications. Example: start_date=2020-09-04
end_date	string End date for the time range of harvest's modifications. Example: end_date=2020-09-05

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/harvests/{id}

Response samples

application/json

{"results": {"type": "array",
"records": {"count": "0 - 100",
"total": 437,
"previous": null,
"next": "https://integration-kmp.greencheckverified.com/ca/v1/harvests?license_number=123-LIC&limit=100&offset=100"
},
"data": {"license": {"license_number": "KMP20222825",
"type": {"name": "Type 12"
}
},
"actions": {"id": "KMHAN0002",
"name": "cure"
},
"id": "a66594cfea964c959292fcc5e188f662",
"name": "Tomino amuro kamui 05242022 manicure 1",
"harvest_date": {"start": "2022-05-24T18:27:39Z",
"end": "2022-05-24T00:00:00Z"
},
"type": {"id": "CAHHT0002",
"name": "manicure_harvest"
},
"strain": {"number": 1,
"unit_of_measure": "Each",
"strains": [{"id": "ef2db9096a8b48b5b261e0247098721a",
"name": "Tomino amuro kamui 05202022"
}
]
},
"totals": {"plants": {"number": 3,
"unit_of_measure": "Each"
},
"weights": {"total_weight": {"wet": {"quantity": 0,
"initial_quantity": [{"qty": 1201.2
}
],
"unit_of_measure": "Grams"
},
"dry": {"quantity": 301.6,
"initial_quantity": [{"qty": 361.6
},
{"qty": 301.6
}
],
"unit_of_measure": "Grams"
},
"moisture_loss": {"quantity": [{"qty": 839.6
},
{"qty": 899.6
}
],
"unit_of_measure": "Grams"
}
},
"flower": {"wet": {"quantity": 0,
"initial_quantity": [{"qty": 600.6
}
],
"unit_of_measure": "Grams"
},
"dry": {"quantity": 150.8,
"initial_quantity": [{"qty": 180.8
},
{"qty": 150.8
}
],
"unit_of_measure": "Grams"
},
"moisture_loss": {"quantity": [{"qty": 419.8
},
{"qty": 449.8
}
],
"unit_of_measure": "Grams"
}
},
"plant_material": {"wet": {"quantity": 0,
"initial_quantity": [{"qty": 600.6
}
],
"unit_of_measure": "Grams"
},
"dry": {"quantity": 150.8,
"initial_quantity": [{"qty": 180.8
},
{"qty": 150.8
}
],
"unit_of_measure": "Grams"
},
"moisture_loss": {"quantity": [{"qty": 419.8
},
{"qty": 449.8
}
],
"unit_of_measure": "Grams"
}
}
}
},
"cure": {"number": 2,
"cures": [{"id": "133c21a843b745b49144e6184550f4b0",
"name": "Tomino amuro kamui 05242022 cure 2",
"drying": {"duration": 720,
"unit_of_measure": "hours"
},
"temperature": {"value": 25,
"unit_of_measure": "Celsius"
},
"humidity": {"level": 60,
"unit_of_measure": "RH percent"
},
"date": "2022-05-24T20:29:19Z",
"locations": {"harvest_locations": {"id": "39d820bae059468facede4bff0efc4ec",
"name": "Hathaway cultivation 1"
},
"lots_locations": {"id": null,
"name": null
}
}
},
{"id": "165d455b919d4023ba007317b7882c80",
"name": "Tomino amuro kamui 05242022 cure 3",
"drying": {"duration": 720,
"unit_of_measure": "hours"
},
"temperature": {"value": 25,
"unit_of_measure": "Celsius"
},
"humidity": {"level": 60,
"unit_of_measure": "RH percent"
},
"date": "2022-05-24T20:29:19Z",
"locations": {"harvest_locations": {"id": "39d820bae059468facede4bff0efc4ec",
"name": "Hathaway cultivation 1"
},
"lots_locations": {"id": null,
"name": null
}
}
}
]
},
"plants": [{"id": "1f46b71cbfa54535b26524ab54bb790c",
"barcode": "1A4FF0200000029000014271"
},
{"id": "618ed4dfa1f1407195c125f7a78b4525",
"barcode": "1A4FF0200000029000014275"
},
{"id": "949201a758794e9a96617191cc7a383c",
"barcode": "1A4FF0200000029000014273"
}
],
"waste": {"quantity": 100,
"unit_of_measure": "Grams"
},
"lots": null,
"locations": {"harvest_locations": {"id": "39d820bae059468facede4bff0efc4ec",
"name": "Hathaway cultivation 1",
"type": {"id": "CALOC0001",
"name": "Cultivation"
}
},
"lots_locations": null
},
"products": null,
"additional": {"patient_license": null,
"is_for_medical_use": false
},
"entity_state": [{"state": "active",
"date": "2022-05-25T21:10:32Z",
"reason": "manicure_harvest",
"actioned_by": "system generated"
},
{"state": "updated",
"date": "2022-05-25T21:11:55Z",
"reason": "harvest updated",
"actioned_by": "system generated"
},
{"state": "lab_testing_not_submitted",
"date": "2022-05-25T21:11:55Z",
"reason": "harvest lab testing not submitted",
"actioned_by": "system generated by metrc"
},
{"state": "waste_removed",
"date": "2022-05-24T18:27:39Z",
"reason": "100.0 Grams of waste removed ID 5feaaddab18d44f7b7e0d5973c4de553",
"actioned_by": "user credentials"
},
{"state": "cured",
"date": "2022-06-14T19:45:49Z",
"reason": "harvest cured",
"actioned_by": "system generated"
}
]
}
},
"warnings": [ ]
}