---
title: "List Licenses"
method: GET
path: "/licenses"
tags: ["Licenses"]
---

# List Licenses

`GET /licenses`

## Query parameters

- `filter[license_holder_type]` 'company' | 'individual'
- `filter[company_id]` string, uuid
- `include` string[]
- `limit` integer
- `page` integer

## Response `200`

Success

- object
  - `data` CompanyRegistration[]
    - `id` string, uuid, required — id of the registration.
    - `license_number` string, required — Registration/license number.
    - `license_holder_on_license` string — Legal name of the entity or individual holding the license.
    - `license_name` string — The formal name of the license.
    - `effective_date` string, date, required — Registration effective date (YYYY-MM-DD)
    - `expiration_date` string, date, nullable — Registration expiration date (YYYY-MM-DD), or null
    - `next_annual_report_due_date` string, date, nullable — Next annual report due date, or null
    - `registration_type` string — The category of registration.
    - `ref_module_id` integer — The id of the module that generated this registration.
    - `ref_license_holder_type_id` integer — The id of the license holder type.
    - `account` Account
      - `id` string, uuid, required — UUID of the account
      - `name` string, required — Name of the account
      - `website` string, nullable — Website URL for the account
      - `billing_address` Address
        - `address_line_1` string, required — First line of the address
        - `address_line_2` string, nullable — Second line of the address (optional)
        - `locality` string, required — City or locality
        - `postal_code` string, required — Postal code
        - `administrative_area` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
        - `country` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
    - `company` Company
      - `id` string, required — id of the company
      - `legal_name` string, required — The company’s exact legal name, including punctuation. We use this data for harvesting data from state agencies, so accuracy ensures the right match.
      - `formation_date` string, date, nullable — Company formation date (YYYY-MM-DD)
      - `fiscal_year_end` string, nullable — Fiscal year end in MM/DD format, or null
      - `phone` string, nullable — Company phone number
      - `toll_free_phone` string, nullable — Company toll-free phone number
      - `email` string, nullable — Company email address
      - `fax` string, nullable — Company fax number
      - `no_fax` boolean — Whether the company has no fax number
      - `website` string, nullable — Company website URL
      - `no_website` boolean — Whether the company has no website
      - `mission` string, nullable — Company mission statement
      - `purpose_statement` string, nullable — Company purpose statement
      - `primary_product_or_service` string, nullable — Primary product or service of the company
      - `ein` string, nullable — Employer Identification Number
      - `domicile` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
        - `id` string, uuid, required — ID of the jurisdiction
        - `name` string, required — Name of the jurisdiction
      - `business_structure` BusinessStructure
        - `id` string, required — id of the business structure
        - `name` string, required — Name of the business structure
      - `principal_address` Address
        - `address_line_1` string, required — First line of the address
        - `address_line_2` string, nullable — Second line of the address (optional)
        - `locality` string, required — City or locality
        - `postal_code` string, required — Postal code
        - `administrative_area` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
        - `country` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
      - `mailing_address` Address
        - `address_line_1` string, required — First line of the address
        - `address_line_2` string, nullable — Second line of the address (optional)
        - `locality` string, required — City or locality
        - `postal_code` string, required — Postal code
        - `administrative_area` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
        - `country` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
      - `tax_classification` IrsTaxClassification
        - `id` string, required — UUID of the IRS tax classification
        - `name` string, required — Name of the tax classification
      - `accounting_method` AccountingMethod
        - `id` string, required — UUID of the accounting method
        - `name` string, required — Name of the accounting method
      - `signers` User[] — Preferred signers for this company
        - `id` string, uuid — UUID of the user
        - `first_name` string — First name of the user
        - `middle_name` string, nullable — Middle name of the user
        - `last_name` string — Last name of the user
        - `full_name` string — Full name of the user
        - `email` string — Email of the user
    - `individual_license_holder` User
      - `id` string, uuid — UUID of the user
      - `first_name` string — First name of the user
      - `middle_name` string, nullable — Middle name of the user
      - `last_name` string — Last name of the user
      - `full_name` string — Full name of the user
      - `email` string — Email of the user
    - `ref_jurisdiction` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
      - `id` string, uuid, required — ID of the jurisdiction
      - `name` string, required — Name of the jurisdiction
    - `ref_filing_authority` FilingAuthority
      - `id` string, required — id of the Filing Authority
      - `name` string, required — Name of the Filing Authority
    - `ref_license_holder_type` RefLicenseHolderType
      - `id` string, required — id of the License Holder Type
      - `name` string, required — Name of the License Holder Type
    - `ref_license` RefLicense
      - `id` string, required — id of the License
      - `name` string, required — Name of the License
      - `entity_requirements` string, nullable — Entity-level requirements for the license. Only returned to users with the required permission.
      - `legal_notes` string, nullable — Legal notes on the license. Only returned to users with the required permission.
      - `notes` string, nullable — General notes on the license. Only returned to users with the required permission.
      - `ownership_requirements` string, nullable — Ownership requirements for the license. Only returned to users with the required permission.
      - `source` string, nullable — Source reference for the license information. Only returned to users with the required permission.
      - `filing_authority` FilingAuthority
        - `id` string, required — id of the Filing Authority
        - `name` string, required — Name of the Filing Authority
    - `ref_license_types` RefLicenseType[]
      - `id` string, required — id of the License Type
      - `name` string, required — Name of the License Type
    - `ref_module` RefModule
      - `id` string, required — id of the Module
      - `name` string, required — Name of the Module
      - `description` string — Description of the Module
    - `ref_registration_type` RefRegistrationType
      - `id` string, required — id of the Registration Type
      - `name` string, required — Name of the Registration Type
    - `ref_registration_status_group` RefRegistrationStatusGroup
      - `id` string, required — id of the Registration Status Group
      - `name` string, required — Name of the Registration Status Group
  - `has_more` boolean — Indicates if there are more results available beyond the current page.

## Other responses

- `400` — Invalid parameter format
- `401` — Unauthenticated
- `403` — Forbidden - User does not have access

---

[API](https://skmtc.net/harborcompliance/apis/harbor-compliance-api.md) · [All operations](https://skmtc.net/harborcompliance/apis/harbor-compliance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harborcompliance/harbor-compliance-api/revisions/f9302ec2ef8a/schema)