Business licenses

The Business Licenses dashboard is a metro-spanning search surface over Locus's normalized business-license catalog. Use it to find recently issued, modified, or closed licenses by metro, address, NAICS code, or pioneer-tier classification, and to pull the result set as CSV for downstream territory and site-selection workflows.

The page lives at /business-licenses inside the Locus app and is backed by GET /api/business-licenses/search.

When to use it

Reach for this dashboard when you need to:

• Track new business formation in a metro or neighborhood as a leading demand signal.
• Find specific operators (by address or NAICS) before a site visit, deal screen, or territory review.
• Pull a metro-scoped batch of licenses into a spreadsheet or CRM via CSV export.
• Distinguish freshly-licensed activity ("Pioneer" tier) from longer-running operators ("Mature") in a target geography.

For cell-level scoring that already incorporates business licenses as a signal, use the Explorer; the dashboard is the raw record-by-record surface beneath the score.

Filters

Every filter narrows the result set on the server side and resets pagination to the first page. Combine any subset of the filters below.

A Reset filters link clears every active filter in one click; it appears only when at least one filter is set.

Sorting and pagination

Click any column header to sort by it; click the same header again to flip direction. The arrow indicator (↑ / ↓) marks the active sort. Results paginate at 50 per page with a Previous / Next control and a running Showing M–N of T summary.

Result columns

Each row in the table corresponds to one license record:

• Source ID — the upstream license identifier.
• Metro — the normalized metro slug.
• Address — normalized street address (may be — if upstream is geocoded only).
• NAICS — industry code if reported by the issuing jurisdiction.
• Pioneer tier — color-coded badge (Pioneer / Advanced / Mature / Dormant / None).
• Loaded At — ingestion timestamp, locale-formatted.
• Close Date — license close or expiration date, when present.
• Maps icon — opens the row's coordinates in Google Maps in a new tab. Shown only when both latitude and longitude are present.

Export

Click Export CSV in the top-right of the filter bar to download the currently visible page of results as business-licenses.csv. The export honors active filters and the current sort, and includes the column set: Source ID, Metro, Address, NAICS, Pioneer Tier, Loaded At, Close Date. The button is disabled when the result set is empty.

API

The dashboard is a thin client over a single authenticated endpoint.

GET /api/business-licenses/search

Returns a page of normalized business licenses, plus the total count for the active filter set.

Query parameters

Response shape

{
  "licenses": [
    {
      "source_key": "chicago:1234567",
      "source_id": "1234567",
      "metro_slug": "chicago",
      "address": "123 N MAIN ST",
      "latitude": 41.8781,
      "longitude": -87.6298,
      "naics_code": "722511",
      "pioneer_tier": "Pioneer",
      "source_loaded_at": "2026-04-28T09:14:00Z",
      "close_date": null,
      "occurred_at": "2026-04-15T00:00:00Z"
    }
  ],
  "total": 1842,
  "limit": 50,
  "offset": 0
}

Example

curl 'https://app.axiomlocus.io/api/business-licenses/search?metros=chicago,nyc&naics=7225&pioneer_tier=Pioneer&limit=100' \
  -H 'Cookie: <your session cookie>'

The endpoint requires an authenticated Locus session; unauthenticated calls return 401 Unauthorized.

Related