Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.axiomancer.io/llms.txt

Use this file to discover all available pages before exploring further.

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.
FilterDescription
MetroOne or more metro slugs from the curated list (chicago, philadelphia, nyc, denver, austin, portland, atlanta, los-angeles, san-francisco, seattle, houston, phoenix, las-vegas, miami, boston). Multi-select; results match any of the selected metros.
AddressSubstring match (ILIKE) against the normalized address column. Useful for street, neighborhood, or partial address search.
NAICS codeSubstring match against naics_code. Enter a 2-, 4-, or 6-digit prefix to narrow by industry.
Pioneer tierOne of Pioneer, Advanced, Mature, Dormant, or None. Distinguishes recently-issued licenses from long-running operators based on issue cadence and business age.
A Reset filters link clears every active filter in one click; it appears only when at least one filter is set.

​
Sorting and pagination

ColumnDefaultNotes
Loaded At (source_loaded_at)DescendingWhen Locus first ingested the record. The default sort.
Occurred At (occurred_at)—When the licensing event happened upstream.
Metro (metro_slug)—Alphabetical by metro slug.
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.
To export more than 50 rows at a time, raise the page size by hitting GET /api/business-licenses/search?limit=200 directly — the API caps at 200 records per call but accepts arbitrary offset for follow-up pages.

​
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
ParameterTypeDescription
metrosstringComma-separated metro slugs (e.g. chicago,nyc).
address_qstringSubstring to match against address.
naicsstringSubstring to match against naics_code.
pioneer_tierstringExact match — one of Pioneer, Advanced, Mature, Dormant, None.
sort_bystringOne of source_loaded_at (default), occurred_at, metro_slug.
sort_dirstringasc or desc (default).
limitnumberPage size. Default 50, capped at 200.
offsetnumberZero-based offset for pagination. Default 0.
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
Find new restaurant licenses in Chicago and NYC
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.

ZBA decisions

Search zoning board appeal decisions across jurisdictions.

Explorer

Cell-level scoring that incorporates business-license activity as a signal.