Create a lot

Create a lot 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" "il" "wa" "ma" "md" "mi" "wv" "co" "ok" "oh"
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_base)
required
object

specific action for this lot operation.

name
required
string

name of the lot.

required
object

product contained in the lot.

barcode
string

a unique identifier required for specific states.

quantity
required
number <float>

quantity of the lot.

unit_of_measure
required
string

unit of measure of the lot.

date
required
string

timestamp when the lot was created in ISO 8601 UTC format.

required
object

type of the lot as required by specific states.

required
object

location of the lot.

required
object

origin of the lot.

object

additional information about the lot.

Array of objects (entity_state)

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

Responses
200

OK

400

Bad Request

post/{state}/v1/lots
Request samples
application/json
{
  • "license": {
    },
  • "action": {
    },
  • "name": "Kodai 01 extract intermediate Lot 1",
  • "product": {
    },
  • "barcode": "1KMBV1200000000046",
  • "quantity": 100,
  • "unit_of_measure": "Grams",
  • "date": "2021-05-03T18:27:39Z",
  • "type": {
    },
  • "location": {
    },
  • "origin": {
    },
  • "additional": {
    }
}
Response samples
application/json
{
  • "results": {
    },
  • "warnings": [ ]
}