Find businesses on the record by part of a name or street address

The step before a receipt for an agent that holds a name. Every business whose name, legal name, a name the City's food-inspection register uses for it, a name it was listed under before a register rename, or registered street line contains each word of q, listed alphabetically, at most 20, with the receipt URL for each. A licence-keyed match carries legal_name where it differs from the name, also_known_as: each register name with the last inspection date it appeared on and the register URL, and former_names: each earlier name with the day it changed. Those are search aids, never receipt fields. Never a receipt and never an ordering by quality.

get/v1/find

Request

  • Base URL: https://api.lodestarstamp.com
  • URL: https://api.lodestarstamp.com/v1/find
  • Auth: one of:
    • none
    • API key in header X-Lodestar-Key
    • OAuth 2 (authorization code, authorization URL https://api.lodestarstamp.com/oauth/authorize, token URL https://api.lodestarstamp.com/oauth/token, scopes: mcp:read)
    • API key in header PAYMENT-SIGNATURE

Query parameters

qstring required

Part of the business name or its street address.

marketstring
Example:chicago-hvac

Market slug from /v1/markets. Without it a lookup starts on the primary market and falls through to every other market by domain or licence; with it the lookup stays on that record. Without it, a market that cannot be read is skipped while the others are asked, and a business none of them holds answers as a named market that cannot be read does (record_unavailable), not as not on the record. Unknown slugs answer 404 unknown_market with the list.

Response

Matches, alphabetical

Changes

No recorded changes to this operation across all 1 revision of this API.