Waste

Create waste event

Create a waste event for use by the license_number provided.

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" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"

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

Request Body schema: application/json

license_number

string

Reference (entity_ID) for the license. This is the business license number issued by the state. The presence of the license number in the body is of informational nature, while it must be provided in the query parameters.

required

object

The create action being taken on the waste

required

string

Reference (entity_ID) for the waste action.

name

required

string

The display name of the waste.

required

object

The dates event dates of the creation of the waste. Hold dates are required in some states.

hold_start	string Timestamp date of the hold start event. Required in some states.
hold_end	string Timestamp date of the hold end event. Required in some states.
waste_start required	string Timestamp date of the waste start event.
waste_end required	string Timestamp date of the waste end event

Array of objects

The employee who created the waste.

Array

id	string Reference (entity_id) for the employee that removed the waste.

required

Array of objects

The type of waste that was removed (e.g. Plant Material, Fibrous, Root Ball).

Array

id	string The id of the waste type.

required

object

The reason for the waste as specified by the state.

required

string

Reference (entity_ID) for the waste reason.

note

string

Additional information related to the waste. May be optional or required based on the reason provided.

required

object

The waste method as specified by the state (e.g. Compost, Self-Hauler, or Waste-Hauler).

required

string

Reference (entity_ID) for the waste method.

weight

required

number <float>

The weight of the waste being removed.

unit_of_measure

required

string

The unit of measure for the weight of the waste.

required

object

List of plants, plant_batches, or harvests the waste was removed from (e.g. immature plant batch, flowering plant, harvest batch, etc.). One waste event must be from one origin type.

Array of objects

Array

id	string ID of the source plant
barcode	string Plant tag of the source plant.

Array of objects

Array

id required	string Reference (entity_ID) for the plant_batch.
barcode required	string barcode of the plant_batch.

Array of objects

Array

id	string Reference (entity_ID) for the source harvest.

Array of objects

Other material the waste was mixed with.

Array

material	string The material the waste was mixed with.
material_weight	number <float> The weight of the material.
unit_of_measure	string The unit of measure for the weight of the material.

date

string

The date the waste was removed.

Responses

200

Response Schema: application/json

object

type

string

Value: "object"

object

license_number

string

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

object

License type of the company/facility.

name	string The display name of the license type.
characteristics	object Specific information related to the license type. The presence of the characteristics' object depends on the use of the expand query parameter .

object

Last action taken on the waste.

id	string Reference (entity_id) for the waste action.
name	string Display name of the wast action.

string

Reference (entity_ID) for the waste.

name

string

The display name of the waste.

barcode

string

A unique identifier required for specific states.

object

The dates event dates of the creation of the waste. Hold dates are required in some states.

hold_start	string Timestamp date of the hold start event.
hold_end	string Timestamp date of the hold end event
waste_start	string Timestamp date of the waste start event.
waste_end	string Timestamp date of the waste end event

object

string

reference (entity_id) for the employee.

object

first_name	string employee first name
last_name	string employee last name

email_address

string

employee email address

phone_number

string

employee phone number

Array of objects

Array

id	string Reference (entity_ID) for the waste type
name	string The display name of the type

object

id	string Reference (entity_ID)for the waste reason.
name	string The display name for the waste reason.
is_note_required	boolean True if note is required when using this reason.
info	string Additional information.

note

string

Additional information related to the waste. May be optional or required based on the reason provided.

object

id	string Reference (entity_ID) for the waste method.
name	string The display name of the method.

object

id	string Reference (entity_ID) for the waste mixed_material.
name	string name of the mixed_material.ß
quantity	number <float> The quantity of mixed_material in the waste.
unit_of_measure	string The unit_of_measure of the quantity.

object

The quantity & unit of measure of the waste.

quantity	number <integer> The number of origin sources in the waste.
unit_of_measure	string The unit of measure for the quantity of the counts.

object

Total weight of the waste.

quantity	number <float> The weight of the waste.
unit_of_measure	string Unit of measure for the quantity.

object

The waste's origin, either plant (mother plant), plant_batch, harvest, location, or lot.

Array of objects or null

Array

id	string Reference (entity_ID) for the plant.
barcode	string A unique identifier required for specific states.
name	string The display name of the plant.
	object

Array of objects or null

Array

id	string Reference (entity_ID) for the plant_batch.
barcode	string Barcode of the plant_batch.
name	string Display name of the plant_batch.
quantity	integer The quantity of immature plant_batches in the origin plant_batch.
unit_of_measure	string The unit of measure used in the quantity.

Array of objects

Array

id	string Reference (entity_ID) for the harvest
	object The quantities of the harvest used in the waste.

Array of objects or null

Array

id	string Reference (entity_ID) for the location.
name	string The name of the location.
quantity	number <float> The quantity of material from the location in the waste.
unit_of_measure	string Unit of measure for the quantity.

Array of objects or null

Array

id	string Reference (entity_ID) of the source lot.
barcode	string Barcode/tag of the source lot.
name	string User friendly reference for the lot.
	object The type of the lot that is origin to the plant_batch.

object

The location of the waste.

string

Reference (entity_ID) for the location.

name

string

name of the location.

object

Type of the location.

id	string Reference (entity_ID) for the location type.
name	string name of the location type.

Array of objects

A list of state changes made to the entity. Entity states for waste [active, inactive, updated, finished, unfinished].

Array

state	string state of the entity.
date	string timestamp when the state was recorded ISO 8601 UTC format.
reason	string additional information for the 'state' change.
actioned_by	string username of the person who updated the state of the entity (if applicable).

Array of objects

Array

type	string
detail	string

400

Bad Request

post/{state}/v1/waste

Request samples

Payload

application/json

{"license": {"license_number": "KMIL1012345"
},
"actions": {"id": "KOMWAAS0007"
},
"name": "Tomino amuro kamui 05242022 waste 1",
"dates": {"hold_start": "2022-05-24T18:27:39Z",
"hold_end": "2022-05-24T18:27:39Z",
"waste_start": "2022-05-24T18:27:39Z",
"waste_end": "2022-05-24T18:27:39Z"
},
"employees": {"id": "0ab0e41e280244d4b26a6cd678f24583"
},
"type": [{"id": "ILWTY0001"
},
{"id": "ILWTY0003"
}
],
"reason": {"id": "ILPWR0001"
},
"note": "too much pesticide was sprayed",
"method": {"id": "ILPWM0002"
},
"mixed_material": [{"id": "ILWAMM0001",
"material": "inorganic material",
"quantity": 1000.1234,
"unit_of_measure": "Grams"
}
],
"weights": null,
"origin": {"harvests": [{"id": "44cee18ee3564d148cbf6fc440dabc94",
"quantity": {"flower": {"wet": {"quantity": 50
},
"dry": {"quantity": 0
}
},
"plant_material": {"wet": {"quantity": 50
},
"dry": {"quantity": 0
}
}
},
"unit_of_measure": "Grams"
}
],
"plant_batches": null,
"plants": null,
"locations": null
},
"locations": {"id": "015db810bd814b20bb99c622d1194026"
}
}

Response samples

application/json

{"results": {"type": "object",
"data": {"license": {"license_number": "KMIL1012345",
"type": {"name": "Cultivation Centers"
}
},
"actions": {"id": "KOMWAAS0007",
"name": "waste_harvest_material"
},
"id": "870472d5c6d443e79eef78c8c38ee028",
"name": "Tomino amuro kamui 05242022 waste 1",
"barcode": "8167196724995261",
"dates": {"hold_start": "2022-05-24T18:27:39Z",
"hold_end": "2022-05-24T18:27:39Z",
"waste_start": "2022-05-24T18:27:39Z",
"waste_end": "2022-05-24T18:27:39Z",
"actual_waste_start": null,
"actual_waste_end": null
},
"employees": {"id": "0ab0e41e280244d4b26a6cd678f24583",
"name": {"first_name": "Priss",
"last_name": "Asagiri"
},
"email_address": "pasagiri@maetel.com",
"phone_number": "312-123-4567"
},
"type": [{"id": "ILWTY0001",
"name": "wet_plant_material"
},
{"id": "ILWTY0003",
"name": "wet_flower_material"
}
],
"reason": {"id": "ILPWR0001",
"name": "other",
"is_note_required": false
},
"note": "too much pesticide was sprayed",
"methods": {"id": "ILPWM0002",
"name": "harvest"
},
"mixed_material": [{"id": "ILWAMM0001",
"name": "inorganic_material",
"material": "inorganic material",
"quantity": 1000.1234,
"unit_of_measure": "Grams"
}
],
"counts": {"quantity": 1,
"unit_of_measure": "Each"
},
"weights": {"total_weight": {"quantity": 100,
"unit_of_measure": "Grams"
}
},
"origin": {"plants": null,
"plant_batches": null,
"harvests": [{"id": "44cee18ee3564d148cbf6fc440dabc94",
"quantity": {"quantity_tts_delta": 0,
"quantity_total": 100,
"flower": {"wet": {"quantity": 50
},
"dry": {"quantity": 0
}
},
"plant_material": {"wet": {"quantity": 50
},
"dry": {"quantity": 0
}
}
},
"unit_of_measure": "Grams"
}
],
"locations": null,
"lots": null
},
"locations": {"id": "015db810bd814b20bb99c622d1194026",
"name": "Hathaway cultivation 51 inventorY2",
"type": {"id": "ILLOC0002",
"name": "inventory_room"
}
},
"entity_state": [{"state": "active",
"date": "2022-07-14T01:53:25Z",
"reason": "waste created",
"actioned_by": "system generated"
},
{"state": "updated",
"date": "2022-05-24T18:27:39Z",
"reason": "waste updated",
"actioned_by": "user credentials"
},
{"state": "scheduled_for_destruction",
"date": "2022-05-24T18:27:39Z",
"reason": "waste scheduled for destruction",
"actioned_by": "user credentials"
}
]
}
},
"warnings": [ ]
}

Retrieve waste event(s) details

Retrieve the waste event details. If the id is not provided, the details of all the waste events for the license_number are obtained.

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" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"
id required	string Waste 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
start_date	string start date value for query operations Example: start_date=2021-08-12T00:00:00z
end_date	string end date value for query operations Example: end_date=2021-08-13T00:00:00z
entity_state	string Queryable entity states for additive. Inactive will return inactive and/or deleted additives. Enum: "active" "inactive" "updated" "finished" "unfinished"

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

Response Schema: application/json

object

type

string

Value: "object"

object

license_number

string

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

object

License type of the company/facility.

name	string The display name of the license type.
characteristics	object Specific information related to the license type. The presence of the characteristics' object depends on the use of the expand query parameter .

object

Last action taken on the waste.

id	string Reference (entity_id) for the waste action.
name	string Display name of the wast action.

string

Reference (entity_ID) for the waste.

name

string

The display name of the waste.

barcode

string

A unique identifier required for specific states.

object

The dates event dates of the creation of the waste. Hold dates are required in some states.

hold_start	string Timestamp date of the hold start event.
hold_end	string Timestamp date of the hold end event
waste_start	string Timestamp date of the waste start event.
waste_end	string Timestamp date of the waste end event

object

string

reference (entity_id) for the employee.

object

first_name	string employee first name
last_name	string employee last name

email_address

string

employee email address

phone_number

string

employee phone number

Array of objects

Array

id	string Reference (entity_ID) for the waste type
name	string The display name of the type

object

id	string Reference (entity_ID)for the waste reason.
name	string The display name for the waste reason.
is_note_required	boolean True if note is required when using this reason.
info	string Additional information.

note

string

Additional information related to the waste. May be optional or required based on the reason provided.

object

id	string Reference (entity_ID) for the waste method.
name	string The display name of the method.

object

id	string Reference (entity_ID) for the waste mixed_material.
name	string name of the mixed_material.ß
quantity	number <float> The quantity of mixed_material in the waste.
unit_of_measure	string The unit_of_measure of the quantity.

object

The quantity & unit of measure of the waste.

quantity	number <integer> The number of origin sources in the waste.
unit_of_measure	string The unit of measure for the quantity of the counts.

object

Total weight of the waste.

quantity	number <float> The weight of the waste.
unit_of_measure	string Unit of measure for the quantity.

object

The waste's origin, either plant (mother plant), plant_batch, harvest, location, or lot.

Array of objects or null

Array

id	string Reference (entity_ID) for the plant.
barcode	string A unique identifier required for specific states.
name	string The display name of the plant.
	object

Array of objects or null

Array

id	string Reference (entity_ID) for the plant_batch.
barcode	string Barcode of the plant_batch.
name	string Display name of the plant_batch.
quantity	integer The quantity of immature plant_batches in the origin plant_batch.
unit_of_measure	string The unit of measure used in the quantity.

Array of objects

Array

id	string Reference (entity_ID) for the harvest
	object The quantities of the harvest used in the waste.

Array of objects or null

Array

id	string Reference (entity_ID) for the location.
name	string The name of the location.
quantity	number <float> The quantity of material from the location in the waste.
unit_of_measure	string Unit of measure for the quantity.

Array of objects or null

Array

id	string Reference (entity_ID) of the source lot.
barcode	string Barcode/tag of the source lot.
name	string User friendly reference for the lot.
	object The type of the lot that is origin to the plant_batch.

object

The location of the waste.

string

Reference (entity_ID) for the location.

name

string

name of the location.

object

Type of the location.

id	string Reference (entity_ID) for the location type.
name	string name of the location type.

Array of objects

A list of state changes made to the entity. Entity states for waste [active, inactive, updated, finished, unfinished].

Array

state	string state of the entity.
date	string timestamp when the state was recorded ISO 8601 UTC format.
reason	string additional information for the 'state' change.
actioned_by	string username of the person who updated the state of the entity (if applicable).

Array of objects

Array

type	string
detail	string

400

Bad Request

get/{state}/v1/waste/{id}

Response samples

application/json

{"results": {"type": "object",
"data": {"license": {"license_number": "KMIL1012345",
"type": {"name": "Type 12"
}
},
"actions": {"id": "KOMWAAS0006",
"name": "waste_flowering_plant_material"
},
"id": "707089cb8bd747a2bfac434dc817fa59",
"name": "KMP waste CSV plant material 06242022",
"barcode": null,
"dates": {"hold_start": "2022-05-24T18:27:39Z",
"hold_end": "2022-05-24T18:27:39Z",
"waste_start": "2022-05-24T18:27:39Z",
"waste_end": "2022-05-24T18:27:39Z",
"actual_waste_start": null,
"actual_waste_end": null
},
"employees": {"id": "b96ae6385b6749b6846eb9ec7f9a93c9",
"name": {"first_name": "Kamile",
"last_name": "Bidan"
},
"email_address": "kidan2@maetal.com",
"phone_number": "408-123-4568"
},
"type": [{"id": "CAWTY0001",
"name": "wet_plant_material"
},
{"id": "CAWTY0003",
"name": "wet_flower_material"
}
],
"reason": {"id": "CAPWR0003",
"name": "failure_to_thrive_bcc",
"is_note_required": true
},
"note": "plants are not doing well and dying",
"methods": {"id": "CAPWM0003",
"name": "self_haul"
},
"mixed_material": [{"id": "CAWAMM0001",
"name": "inorganic_material",
"material": "inorganic material",
"quantity": 1001.1234,
"unit_of_measure": "Grams"
}
],
"counts": {"quantity": 2,
"unit_of_measure": "Each"
},
"weights": {"total_weight": {"quantity": 10013,
"unit_of_measure": "Grams"
}
},
"origin": {"plants": [{"id": "cbb5803792524c9182569081904b5b89",
"barcode": "1A4FF0200000029000014249",
"name": "tomino amuro kamui 05202022 plants A",
"quantity": {"flower": {"wet": {"quantity": 2003.2
},
"dry": {"quantity": 0
}
},
"plant_material": {"wet": {"quantity": 2003.2
},
"dry": {"quantity": 0
}
}
},
"unit_of_measure": "Grams"
},
{"id": "17e9ec8efb5444b8927033577f9ed59f",
"barcode": "1A4FF0200000029000014247",
"name": "Tomino amuro 052022 plants A 014247",
"quantity": {"flower": {"wet": {"quantity": 3003.3
},
"dry": {"quantity": 0
}
},
"plant_material": {"wet": {"quantity": 3003.3
},
"dry": {"quantity": 0
}
}
},
"unit_of_measure": "Grams"
}
],
"plant_batches": null,
"harvests": null,
"locations": null,
"lots": null
},
"locations": {"id": "39d820bae059468facede4bff0efc4ec",
"name": "Hathaway cultivation 1",
"type": {"id": "CALOC0001",
"name": "Cultivation"
}
},
"entity_state": [{"state": "active",
"date": "2022-07-01T23:10:35Z",
"reason": "waste created",
"actioned_by": "system generated"
},
{"state": "updated",
"date": "2022-05-24T18:27:39Z",
"reason": "waste updated",
"actioned_by": "user credentials"
},
{"state": "csv_file_created",
"date": "2022-05-24T18:27:39Z",
"reason": "csv file ID 707089cb8bd747a2bfac434dc817fa59 name record_plants_waste_707089cb8bd747a2bfac434dc817fa59_1656717036.csv  created for waste",
"actioned_by": "user credentials"
}
]
}
},
"warnings": [ ]
}

Update waste event

Update the details of a waste event for the license_number provided.

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" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"
id required	string Waste ID Example: a521f55de4394f4f99c282be687e63aa

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

Request Body schema: application/json

required

object

license_number

string

required

object

Trace ID related to the move waste action.

string

move_date

required

string

Timestamp in ISO8601 UTC format representing the time the waste was physically moved.

required

object

Trace Location id for where the waste was placed.

string

Responses

200

Response Schema: application/json

object

type

string

Value: "object"

object

license_number

string

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

object

License type of the company/facility.

name	string The display name of the license type.
characteristics	object Specific information related to the license type. The presence of the characteristics' object depends on the use of the expand query parameter .

object

Last action taken on the waste.

id	string Reference (entity_id) for the waste action.
name	string Display name of the wast action.

string

Reference (entity_ID) for the waste.

name

string

The display name of the waste.

barcode

string

A unique identifier required for specific states.

object

The dates event dates of the creation of the waste. Hold dates are required in some states.

hold_start	string Timestamp date of the hold start event.
hold_end	string Timestamp date of the hold end event
waste_start	string Timestamp date of the waste start event.
waste_end	string Timestamp date of the waste end event

object

string

reference (entity_id) for the employee.

object

first_name	string employee first name
last_name	string employee last name

email_address

string

employee email address

phone_number

string

employee phone number

Array of objects

Array

id	string Reference (entity_ID) for the waste type
name	string The display name of the type

object

id	string Reference (entity_ID)for the waste reason.
name	string The display name for the waste reason.
is_note_required	boolean True if note is required when using this reason.
info	string Additional information.

note

string

Additional information related to the waste. May be optional or required based on the reason provided.

object

id	string Reference (entity_ID) for the waste method.
name	string The display name of the method.

object

id	string Reference (entity_ID) for the waste mixed_material.
name	string name of the mixed_material.ß
quantity	number <float> The quantity of mixed_material in the waste.
unit_of_measure	string The unit_of_measure of the quantity.

object

The quantity & unit of measure of the waste.

quantity	number <integer> The number of origin sources in the waste.
unit_of_measure	string The unit of measure for the quantity of the counts.

object

Total weight of the waste.

quantity	number <float> The weight of the waste.
unit_of_measure	string Unit of measure for the quantity.

object

The waste's origin, either plant (mother plant), plant_batch, harvest, location, or lot.

Array of objects or null

Array

id	string Reference (entity_ID) for the plant.
barcode	string A unique identifier required for specific states.
name	string The display name of the plant.
	object

Array of objects or null

Array

id	string Reference (entity_ID) for the plant_batch.
barcode	string Barcode of the plant_batch.
name	string Display name of the plant_batch.
quantity	integer The quantity of immature plant_batches in the origin plant_batch.
unit_of_measure	string The unit of measure used in the quantity.

Array of objects

Array

id	string Reference (entity_ID) for the harvest
	object The quantities of the harvest used in the waste.

Array of objects or null

Array

id	string Reference (entity_ID) for the location.
name	string The name of the location.
quantity	number <float> The quantity of material from the location in the waste.
unit_of_measure	string Unit of measure for the quantity.

Array of objects or null

Array

id	string Reference (entity_ID) of the source lot.
barcode	string Barcode/tag of the source lot.
name	string User friendly reference for the lot.
	object The type of the lot that is origin to the plant_batch.

object

The location of the waste.

string

Reference (entity_ID) for the location.

name

string

name of the location.

object

Type of the location.

id	string Reference (entity_ID) for the location type.
name	string name of the location type.

Array of objects

A list of state changes made to the entity. Entity states for waste [active, inactive, updated, finished, unfinished].

Array

state	string state of the entity.
date	string timestamp when the state was recorded ISO 8601 UTC format.
reason	string additional information for the 'state' change.
actioned_by	string username of the person who updated the state of the entity (if applicable).

Array of objects

Array

type	string
detail	string

400

Bad Request

put/{state}/v1/waste/{id}

Request samples

Payload

application/json

{"license": {"license_number": "KMIL1012345"
},
"actions": {"id": "KOMWAAS0013"
},
"move_date": "2022-07-16T20:29:19Z",
"locations": {"id": "66878631b87e43968cbcd0d776d856b8"
}
}

Response samples

application/json

{"results": {"type": "object",
"data": {"license": {"license_number": "KMIL1012345",
"type": {"name": "Cultivation Centers"
}
},
"actions": {"id": "KOMWAAS0013",
"name": "move_waste_to_new_location"
},
"id": "870472d5c6d443e79eef78c8c38ee028",
"name": "Tomino amuro kamui 05242022 waste 1",
"barcode": "8167196724995261",
"dates": {"hold_start": "2022-05-24T18:27:39Z",
"hold_end": "2022-05-24T18:27:39Z",
"waste_start": "2022-05-24T18:27:39Z",
"waste_end": "2022-05-24T18:27:39Z",
"actual_waste_start": null,
"actual_waste_end": null
},
"employees": {"id": "0ab0e41e280244d4b26a6cd678f24583",
"name": {"first_name": "Priss",
"last_name": "Asagiri"
},
"email_address": "pasagiri@maetel.com",
"phone_number": "312-123-4567"
},
"type": [{"id": "ILWTY0001",
"name": "wet_plant_material"
},
{"id": "ILWTY0003",
"name": "wet_flower_material"
}
],
"reason": {"id": "ILPWR0001",
"name": "other",
"is_note_required": false
},
"note": "too much pesticide was sprayed",
"methods": {"id": "ILPWM0002",
"name": "harvest"
},
"mixed_material": [{"id": "ILWAMM0001",
"name": "inorganic_material",
"material": "inorganic material",
"quantity": 1000.1234,
"unit_of_measure": "Grams"
}
],
"counts": {"quantity": 1,
"unit_of_measure": "Each"
},
"weights": {"total_weight": {"quantity": 100,
"unit_of_measure": "Grams"
}
},
"origin": {"plants": null,
"plant_batches": null,
"harvests": [{"id": "44cee18ee3564d148cbf6fc440dabc94",
"quantity": {"quantity_tts_delta": 0,
"quantity_total": 100,
"flower": {"wet": {"quantity": 50
},
"dry": {"quantity": 0
}
},
"plant_material": {"wet": {"quantity": 50
},
"dry": {"quantity": 0
}
}
},
"unit_of_measure": "Grams"
}
],
"locations": null,
"lots": null
},
"locations": {"id": "66878631b87e43968cbcd0d776d856b8",
"name": "Cultivation Room 1A",
"type": {"id": "ILLOC0002",
"name": "inventory_room"
}
},
"entity_state": [{"state": "active",
"date": "2022-07-14T01:53:25Z",
"reason": "waste created",
"actioned_by": "system generated"
},
{"state": "updated",
"date": "2022-07-18T00:44:06Z",
"reason": "waste updated",
"actioned_by": "user credentials"
},
{"state": "scheduled_for_destruction",
"date": "2022-05-24T18:27:39Z",
"reason": "waste scheduled for destruction",
"actioned_by": "user credentials"
},
{"state": "waste_moved",
"date": "2022-07-16T20:29:19Z",
"reason": "original location 015db810bd814b20bb99c622d1194026 Hathaway cultivation 51 inventorY2",
"actioned_by": "user credentials"
}
]
}
},
"warnings": [{"detail": "move_date entered is 28 hours before the current time stamp 2022-07-18T00:44:05Z",
"type": "move_date"
}
]
}

Delete waste event

Deactivate a waste event for the license_number provided.

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" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"
id required	string Waste ID Example: a521f55de4394f4f99c282be687e63aa

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

Request Body schema: application/json

license_number

required

string

Responses

200

Response Schema: application/json

object

type

string

Value: "object"

object

id	string Reference (entity_ID) for the waste event.
deleted	boolean True if the waste event was deleted successfully, otherwise false.

Array of objects

Array

type	string
detail	string

400

Bad Request

delete/{state}/v1/waste/{id}

Request samples

Payload

application/json

{"license_number": "KMIL1012345"
}

Response samples

application/json

{"results": {"type": "object",
"data": {"id": "707089cb8bd747a2bfac434dc817fa59",
"deleted": true
}
},
"warnings": [ ]
}

Retrieve waste types

retrieve the waste types for a specific state

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" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"

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

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

Response Schema: application/json

object

type

string

Value: "array"

Array of objects

Array

id	string Reference (entity_ID) for the waste type
name	string The display name of the type
note	string Additional information

Array of objects

Array

type	string
detail	string

400

Bad Request

get/{state}/v1/waste/types

Response samples

application/json

{"results": {"type": "array",
"data": [{"id": "CAWTY0001",
"name": "wet_plant_material",
"note": "wet plant material waste"
},
{"id": "CAWTY0002",
"name": "dry_plant_material",
"note": "dry plant material waste"
},
{"id": "CAWTY0003",
"name": "wet_flower_material",
"note": "wet flower material waste"
},
{"id": "CAWTY0004",
"name": "dry_flower_material",
"note": "dry flower material waste"
},
{"id": "CAWTY0005",
"name": "Lots",
"note": "lot or product waste"
}
]
},
"warnings": [ ]
}

Retrieve waste reasons

retrieve the waste types for a specific state and license number

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" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"

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

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

Response Schema: application/json

object

type

string

Value: "array"

Array of objects

Array

id	string Reference (entity_ID)for the waste reason.
name	string The display name for the waste reason.
is_note_required	boolean True if note is required when using this reason.
info	string Additional information.

Array of objects

Array

type	string
detail	string

400

Bad Request

get/{state}/v1/waste/reasons

Response samples

application/json

{"results": {"type": "array",
"data": [{"id": "CAPWR0001",
"name": "contamination_bcc",
"is_note_required": true,
"info": "bcc for bcc licenses only"
},
{"id": "CAPWR0002",
"name": "damage_bcc",
"is_note_required": true,
"info": "bcc for bcc licenses only"
},
{"id": "CAPWR0003",
"name": "failure_to_thrive_bcc",
"is_note_required": true,
"info": "bcc for bcc licenses only"
},
{"id": "CAPWR0004",
"name": "male_plants_bcc",
"is_note_required": false,
"info": "bcc for bcc licenses only"
},
{"id": "CAPWR0005",
"name": "mandated_destruction",
"is_note_required": true,
"info": null
},
{"id": "CAPWR0006",
"name": "pesticides",
"is_note_required": true,
"info": null
},
{"id": "CAPWR0007",
"name": "pruning",
"is_note_required": true,
"info": null
},
{"id": "CAPWR0012",
"name": "mold",
"is_note_required": false,
"info": null
}
]
},
"warnings": [ ]
}

Retrieve waste methods

retrieve the waste methods for a specific state

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" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"

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

Response Schema: application/json

object

type

string

Value: "array"

Array of objects

Array

id	string Reference (entity_ID) for the waste method.
name	string The display name of the method.

Array of objects

Array

type	string
detail	string

400

Bad Request

get/{state}/v1/waste/methods

Response samples

application/json

{"results": {"type": "array",
"data": [{"id": "ILPWM0001",
"name": "compost"
},
{"id": "ILPWM0002",
"name": "harvest"
},
{"id": "ILPWM0003",
"name": "self_haul"
},
{"id": "ILPWM0004",
"name": "waste_hauler"
},
{"id": "ILPWM0005",
"name": "other"
}
]
},
"warnings": [ ]
}

Retrieve waste actions

Retrieve the waste actions for a specific state

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" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"

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

Response Schema: application/json

object

type

string

Value: "array"

Array of objects

Array

id	string Reference (entity_ID) for the waste action.
name	string The display name of the action.
note	string Details of this action.
info	string Additional information on this action.

Array of objects

Array

type	string
detail	string

400

Bad Request

get/{state}/v1/waste/actions

Response samples

application/json

{"results": {"type": "array",
"data": [{"id": "KOMWAAS0001",
"name": "waste_immature_plants_from_batch",
"note": "waste by count",
"info": "destroy immature plants"
},
{"id": "KOMWAAS0002",
"name": "waste_immature_plant_batch_material",
"note": "waste by weight",
"info": "may require file upload to tts"
},
{"id": "KOMWAAS0003",
"name": "waste_plant",
"note": "waste entire plant",
"info": "destroy plant"
},
{"id": "KOMWAAS0004",
"name": "waste_immature_plant_material",
"note": "waste by weight",
"info": "may require file upload to tts"
},
{"id": "KOMWAAS0005",
"name": "waste_vegetative_plant_material",
"note": "waste by weight",
"info": "may require file upload to tts"
},
{"id": "KOMWAAS0006",
"name": "waste_flowering_plant_material",
"note": "waste by weight",
"info": "may require file upload to tts"
},
{"id": "KOMWAAS0007",
"name": "waste_harvest_material",
"note": "waste by weight",
"info": ""
},
{"id": "KOMWAAS0008",
"name": "waste_by_location",
"note": "waste by weight",
"info": "may require file upload to tts"
},
{"id": "KOMWAAS0009",
"name": "destroy_material",
"note": "destroy material after holding period",
"info": "required by specific states after holding period"
}
]
},
"warnings": [ ]
}

Retrieve waste mixed_materials

retrieve the materials mixed with waste per state

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" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"

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

Response Schema: application/json

object

type

string

Value: "array"

Array of objects

Array

id	string Reference (entity_ID) for the waste mixed_material.
name	string The display name of the mixed_material.
note	string Additional information.

Array of objects

Array

type	string
detail	string

400

Bad Request

get/{state}/v1//waste/mixed_materials

Response samples

application/json

{"results": {"type": "array",
"data": [{"id": "CAWAMM0001",
"name": "inorganic_material",
"note": null
},
{"id": "CAWAMM0002",
"name": "soil",
"note": null
},
{"id": "CAWAMM0003",
"name": "none",
"note": "use none when mixed materials not required"
}
]
},
"warnings": [ ]
}

➔ Next to Lot