v3

latestOpenAPI 3.0.3Apache 2.02026-07-312637031.3 MB
Licenses

Create a license and associate it with a business

License represents a business permit that will be verified

post/licenses

Request body

business_idstring uuid

Unique ID for the business. Exactly one of business_id or person_id must be set.

customer_idstring uuid
license_numberstring

The entity's license number

license_type'MRB'

The type of the license being created. For example, the license being created could be for MRB (Marijuana related business)

tenantstring

The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.

Example request

{
  "business_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "customer_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "license_type": "MRB",
  "tenant": "abcdef_ghijkl"
}

Response

Created license representation.

business_idstring uuid

Unique ID for the business. Exactly one of business_id or person_id must be set.

creation_timestring date-time required

The date and time the license resource was created.

customer_idstring uuid
idstring uuid required

License record unique id

last_updated_timestring date-time required

The date and time the license resource was last updated.

last_verified_timestring date-time

Timestamp of the last time the license was verified

license_classification'MEDICAL_AND_RECREATIONAL_CANNABIS' | 'MEDICAL_CANNABIS' | 'RECREATIONAL_CANNABIS'

The classification of the license

license_expiration_datestring date

The date on which the license will expire

license_issuance_datestring date

The date on which the license was issued

license_numberstring required

The entity's license number

license_type'MRB' required

The type of the license being created. For example, the license being created could be for MRB (Marijuana related business)

license_type_descriptionstring

Free-form text describing the type of the license

licensee_addressstring

The address of the entity that holds the license as reported by the verifying vendor

licensee_namestring

The name of the entity that holds the license that's reported by the verifying vendor

licensing_authoritystring

The name of the licensing body that granted the license

status'ACCEPTED' | 'REJECTED' | 'REVIEW' | 'UNVERIFIED' required

The status of the license

tenantstring required

The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.

Example response

{
  "business_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "creation_time": "2010-05-06T12:23:34.321Z",
  "customer_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "id": "7df5c505-b47c-490d-855f-c1b3cd99327f",
  "last_updated_time": "2010-05-06T12:23:34.321Z",
  "last_verified_time": "2023-05-06T12:23:34.321Z",
  "license_classification": "RECREATIONAL_CANNABIS",
  "license_expiration_date": "2023-01-01",
  "license_issuance_date": "2023-01-01",
  "license_type": "MRB",
  "license_type_description": "Limited Marijuana Cultivation Facility",
  "licensee_address": "1064 elm street, New York",
  "licensee_name": "Apex Corp",
  "licensing_authority": "Alcohol & Marijuana Control Office",
  "status": "ACCEPTED",
  "tenant": "abcdef_ghijkl"
}