# Search for cannabis licenses

Endpoint: GET /service-providers/{sp_id}/licenses-search
Version: 1.0.0
Security: access_auth

## Path parameters:

  - `sp_id` (string, required)
    Service Provider Id

## Query parameters:

  - `limit` (integer)
    The page size

  - `offset` (integer)
    The page offset

  - `licenseNumber` (string)
    License number / identifier

  - `name` (string)
    Name of licensee or holding business

  - `state` (any)
    State of Licensing Authority (CAN = Cananda, NLA = No Licensing Authority)

  - `licenseType` (string)
    License Type
    Enum: "Caregiver", "CBD", "Corporate Officer", "Cultivation", "Delivery/Transporter", "Event Organizer", "Hemp", "Illicit Establishment", "Management Company", "Manufacturer/Processor", "Owner/Investor", "Research", "Retail/Dispensary", "Senior Manager", "Social Use Club", "Storage", "Testing", "Unknown", "Vertically Integrated", "Waste Disposal", "Wholesale/Distribution"

## Response 200 fields (application/json):

  - `metadata` (object, required)

  - `metadata.total` (integer, required)

  - `metadata.count` (string, required)
    Range of items returned

  - `data` (array, required)

  - `data.licensee` (string,null, required)

  - `data.license_identifier` (string,null, required)

  - `data.med_rec_classification` (string,null, required)
    Enum: "both", "hemp", "medical", "recreational"

  - `data.locality` (string,null, required)

  - `data.licensing_authority_name` (string, required)

  - `data.licensing_authority_tier` (string, required)
    Enum: "country", "locality", "other", "region", "sub_region"

  - `data.licensing_authority_address` (object, required)

  - `data.licensing_authority_address.postal_code` (string,null, required)

  - `data.licensing_authority_address.sub_region` (string,null, required)

  - `data.licensing_authority_address.region` (string,null, required)

  - `data.licensing_authority_address.created_at` (string,null, required)

  - `data.licensing_authority_address.street` (string,null, required)

  - `data.licensing_authority_address.premise` (string,null, required)

  - `data.licensing_authority_address.updated_at` (string,null, required)

  - `data.licensing_authority_address.sub_locality` (string,null, required)

  - `data.licensing_authority_address.box_number` (string,null, required)

  - `data.licensing_authority_address.country` (string,null, required)

  - `data.licensing_authority_address.sub_premise` (string,null, required)

  - `data.state_license_class_description` (string,null, required)

  - `data.state_license_status_description` (string,null, required)

  - `data.state_license_sub_class_description` (string,null, required)

  - `data.reported_license_type_description` (string, required)

  - `data.reported_license_status` (string, required)

  - `data.reported_license_sub_type` (string,null, required)

  - `data.uniform_license_type_description` (string, required)
    Enum: "Caregiver", "CBD", "Corporate Officer", "Cultivation", "Delivery/Transporter", "Event Organizer", "Hemp", "Illicit Establishment", "Management Company", "Manufacturer/Processor", "Owner/Investor", "Research", "Retail/Dispensary", "Senior Manager", "Social Use Club", "Storage", "Testing", "Unknown", "Vertically Integrated", "Waste Disposal", "Wholesale/Distribution"

  - `data.uniform_license_status_description` (string, required)
    Enum: "Active", "Approved/Pending", "Inactive", "Pre-License", "Unknown", "Unlicensed"

  - `data.status_date` (string, required)

  - `data.issued_at` (string,null, required)

  - `data.expires_at` (string,null, required)

  - `data.edited_at` (string, required)

  - `data.businesses` (array, required)

  - `data.businesses.name` (string, required)

  - `data.individuals` (array, required)

## Response 401 fields (application/json):

  - `name` (string, required)

  - `message` (string, required)

  - `status` (number, required)

  - `stack` (string)

  - `data` (any)

## Response 403 fields (application/json):

  - `name` (string, required)

  - `message` (string, required)

  - `status` (number, required)

  - `stack` (string)

  - `data` (any)

## Response 404 fields (application/json):

  - `name` (string, required)

  - `message` (string, required)

  - `status` (number, required)

  - `stack` (string)

  - `data` (any)

## Response 422 fields (application/json):

  - `name` (string, required)

  - `message` (string, required)

  - `status` (number, required)

  - `fields` (object, required)

  - `stack` (string)

  - `data` (any)