---
title: "Search for cannabis licenses"
method: GET
path: "/service-providers/{sp_id}/licenses-search"
tags: ["Service Provider"]
---

# Search for cannabis licenses

`GET /service-providers/{sp_id}/licenses-search`

## Request

- Base URL: `https://sandbox-api.greencheckverified.com`
- URL: `https://sandbox-api.greencheckverified.com/service-providers/{sp_id}/licenses-search`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/greencheckverified/apis/green-check-access/docs/service-providers/:sp_id/licenses-search/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `sp_id` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `licenseNumber` string
- `name` string
- `state` union
  - 'AL' | 'AK' | 'AZ' | 'AR' | 'AS' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FM' | 'FL' | 'GA' | 'GU' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MH' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'MP' | 'OH' | 'OK' | 'OR' | 'PW' | 'PA' | 'PR' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UM' | 'UT' | 'VT' | 'VA' | 'VI' | 'WA' | 'WV' | 'WI' | 'WY' | 'AA' | 'AE' | 'AP': Enumeration of all of the United States
  - 'CAN' | 'NLA'
- `licenseType` '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`

Ok

- PagedBusinessLicenseResponse
  - `metadata` object, required
    - `total` integer, required
    - `count` string, required: Range of items returned
  - `data` BusinessLicense[], required
    - `licensee` string, nullable, required
    - `license_identifier` string, nullable, required
    - `med_rec_classification` 'both' | 'hemp' | 'medical' | 'recreational', required
    - `locality` string, nullable, required
    - `licensing_authority_name` string, required
    - `licensing_authority_tier` 'country' | 'locality' | 'other' | 'region' | 'sub_region', required
    - `licensing_authority_address` object, required
      - `postal_code` string, nullable, required
      - `sub_region` string, nullable, required
      - `region` string, nullable, required
      - `created_at` string, nullable, required
      - `locality` string, nullable, required
      - `street` string, nullable, required
      - `premise` string, nullable, required
      - `updated_at` string, nullable, required
      - `sub_locality` string, nullable, required
      - `box_number` string, nullable, required
      - `country` string, nullable, required
      - `sub_premise` string, nullable, required
    - `state_license_class_description` string, nullable, required
    - `state_license_status_description` string, nullable, required
    - `state_license_sub_class_description` string, nullable, required
    - `reported_license_type_description` string, required
    - `reported_license_status` string, required
    - `reported_license_sub_type` string, nullable, required
    - `uniform_license_type_description` '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', required
    - `uniform_license_status_description` 'Active' | 'Approved/Pending' | 'Inactive' | 'Pre-License' | 'Unknown' | 'Unlicensed', required
    - `status_date` string, required
    - `issued_at` string, nullable, required
    - `expires_at` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
    - `edited_at` string, required
    - `businesses` object[], required
      - `name` string, required
    - `individuals` object[], required
      - `name` string, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Validation Failed

---

[API](https://skmtc.dev/greencheckverified/apis/green-check-access.md) - [All operations](https://skmtc.dev/greencheckverified/apis/green-check-access/llms.txt) - [OpenAPI document](https://skmtc.dev/greencheckverified/apis/green-check-access/revisions/fb63a7a6151b?raw)