> ## Documentation Index
> Fetch the complete documentation index at: https://docs.licensesearcher.com/llms.txt
> Use this file to discover all available pages before exploring further.

# County queries

Hawaii and Nevada require one `county` parameter on license lookups and searches. Names are case-insensitive, and surrounding whitespace is ignored. Missing, blank, repeated, or unrecognized values return `400 validation_error`. Numeric IDs and FIPS codes are not accepted.

Your API key must have access to the requested state.

## Hawaii

Use the issuing county. The same license number can exist in more than one county.

| County | Value | Coverage |
| - | - | - |
| City and County of Honolulu | `honolulu` | Supported |
| Maui County | `maui` | Supported |
| Hawaii County (Big Island) | `hawaii` | Unsupported: `400 county_not_supported` |
| Kauai County | `kauai` | Unsupported: `400 county_not_supported` |

```bash Lookup theme={null}
curl "https://api.licensesearcher.com/v2/license/hi/441?county=maui" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```bash Search theme={null}
curl "https://api.licensesearcher.com/v2/search?state=hi&county=honolulu&name=market" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

A lookup in a supported county returns `404 license_not_found` if there is no match. A search returns `200` with `data: []`. The API does not fall back to another county.

To search both supported counties, send a request for each. There is no statewide search or `county=all` option.

Store Hawaii licenses using `(state, address.county, license)`. Include `types[].type` when identifying a particular license type. For example, `hi / MAUI / 441` and `hi / HONOLULU / 441` identify different licenses. Type codes include the issuing county, such as `MAUI:PERMANENT`.

## Nevada

Use the geographic county. Coverage currently includes unincorporated Clark County, Las Vegas, North Las Vegas, Henderson, Boulder City, and Mesquite. `county=clark` includes all six issuing authorities.

```bash Lookup theme={null}
curl "https://api.licensesearcher.com/v2/license/nv/1000005.LIQ-118?county=clark" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```bash Search theme={null}
curl "https://api.licensesearcher.com/v2/search?state=nv&county=clark&name=market" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

City-issued licenses use the same filter. For example: `/v2/license/nv/L09-00003?county=clark`. Preserve punctuation and leading zeros in license numbers.

### Accepted counties

Accepted values are `carson city`, `churchill`, `clark`, `douglas`, `elko`, `esmeralda`, `eureka`, `humboldt`, `lander`, `lincoln`, `lyon`, `mineral`, `nye`, `pershing`, `storey`, `washoe`, and `white pine`.

Use the full name without a `County` suffix. Abbreviations (`cl`), city names (`las vegas`), and `county=all` are invalid. Carson City is accepted as a county-equivalent.

Recognized counties outside Clark County are valid filters, but have no data. Lookup returns `404 license_not_found`; search returns `200` with `data: []`. This differs from Hawaii, where requests for Hawaii County and Kauai are rejected.

### Issuing agencies

The county filter does not select an issuer. In the November response, each `types[].agency` identifies the agency that issued that type. It contains `id`, `object`, `name`, and `url`, or is `null` when the issuer is unknown. Type codes also retain their issuer prefix, such as `CLARK_COUNTY:LIQ-118` or `LAS_VEGAS:L16`.

The county and city in an address are not enough to identify the issuer. [Retrieve a state](https://docs.licensesearcher.com/states/retrieve-a-state.md) lists the agencies registered for covered Nevada jurisdictions.

### Source limitations

All six sources are checked daily. Henderson publishes weekly, so daily checks may return unchanged records. Clark County, Las Vegas, and North Las Vegas publish historical statuses where available. Henderson, Boulder City, and Mesquite publish active inventories.

Clark County's listing omits owner, phone, original issuance, and expiration fields. Those values are `null`.

## Update existing requests

Add `county` to both lookup and search requests for `hi` and `nv`. Other states do not require it. For Hawaii, keep the issuing county with any stored license number.

| Request | With county |
| - | - |
| `/v2/license/hi/441` | `/v2/license/hi/441?county=maui` |
| `/v2/search?state=hi&name=market` | `/v2/search?state=hi&county=maui&name=market` |
| `/v2/search?state=nv&name=market` | `/v2/search?state=nv&county=clark&name=market` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.