VerifyLicense.US API Documentation

Welcome to the License Verification API, a powerful tool designed to streamline the process of verifying professional licenses across the United States.

This API allows businesses, organizations, and individuals to quickly and securely validate licenses by providing the license number, ensuring that professionals hold valid and up-to-date credentials in their respective fields.

In this documentation, you will find all the necessary information to integrate and utilize the License Verification API, including authentication details, endpoint descriptions, and response formats. This guide is designed to help you get up and running quickly while maximizing the value of our service.

Getting started

To begin using the License Verification API, each request must be authenticated with an API key. This key serves as your unique identifier and ensures secure communication between your system and our servers.

To obtain an API key, you'll need to contact us directly. Simply reach out via our support email or contact form, and our team will assist you in generating your personalized API key. Once you have your key, you’ll include it in the GET parameters of every API request for authentication.

Please note: Your API key is confidential and should not be shared with anyone or exposed publicly. Ensure it is stored securely to prevent unauthorized access.

Once you have an API key you can start using the API.

Any API call is made by making a GET request to the following endpoint

GET https://verifylicense.us/api?key=YOUR_API_KEY&action=YOUR_DESIRED_ACTION

There are 2 mandatory GET parameters that need to be included in every API call:

  • key – Your API key obtained on the previous steps
  • action – The action requested

There are 3 possible values to action parameter:

  • get_states – Get the list of supported states
  • get_state_categories – Get the list of supported license categories for the state
  • search – Search and validate the license

Our API returns the result in JSON format.

{
    "status": "success",
    "quota": 100,
    "usage": 2,
    "code": "ok",
    "data": []
}

Every response contains the following keys:

  • status – The status of the response. Possible values: "success", "error"
  • quota – The amount of license verification requests in your plan
  • usage – The amount of license verification requests already made
  • code – The code of the response, in case of success it will be "ok"
  • data – The actual data of the response, depends on the action

Let’s have a closer look on each action.

get_states

Allows you to see the list of states supported by our service

Request

GET https://verifylicense.us/api?key=YOUR_API_KEY&action=get_states

Response

{
    "status": "success",
    "quota": 100,
    "usage": 2,
    "code": "ok",
    "data": [
        "CA",
        "FL",
        "NY",
        "TX"
    ]
}

get_state_categories

Allows you to see the list of license categories supported for the specific state.

Request

GET https://verifylicense.us/api?key=YOUR_API_KEY&action=get_state_categories&state=STATE_CODE

Parameters

  • state – state code (ANSI 2-letter standard, for ex. NY for New York)

Response

{
    "status": "success",
    "quota": 100,
    "usage": 2,
    "code": "ok",
    "data": {
        "007": "Certified Public Accountant",
        "008": "Public Accountant",
        "009": "And many more"
    }
}

The data contains the array of supported license categories where the key is the code of the category and the value is its name.

search

Allows you to search and validate the license

Request

GET https://verifylicense.us/api?key=YOUR_API_KEY&action=search&state=STATE_CODE&license_number=LICENSE_NUMBER&license_category=LICENSE_CATEGORY_CODE

Parameters

  • state – state code (ANSI 2-letter standard, for ex. NY for New York)
  • license_number – The number of the license to verify
  • license_category – The license category code (obtained using get_state_categories request)

Response

{
    "status": "success",
    "quota": 100,
    "usage": 2,
    "code": "ok",
    "data": [
        {
            "licensee": {
                "first_name": "JOHN",
                "last_name": "DOE",
                "full_name": "DOE, JOHN",
                "address_street": "123 Sunny street",
                "address_city": "MIAMI",
                "address_zip": "33156",
                "address_county": "MIAMI-DADE",
                "address_state": "Florida",
                "full_address": "123 Sunny street, Florida, 33156"
            },
            "expiration_date": "2029-12-31",
            "issuance_date": "1989-07-27",
            "number": "AC0000000",
            "type": "Certified Public Accountant",
            "status": "active",
            "status_info": "Active",
            "qualification": "Qualification Effective",
            "rank": "CPA"
        }
    ]
}

The data contains an array of found licenses. License usually have following fields:

  • licensee – The info about licensee (the name, address, etc.)
  • expiration_date – The date when this license expires
  • issuance_date – The date when this license was issued
  • status – The actual status of the license. Possible values: "active" when active, "expired" when expired or "none" when it's not possible to define the exact status