---
title: "Find businesses on the record by part of a name or street address"
method: GET
path: "/v1/find"
---

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

`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`

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.

## Query parameters

- `q` string, required
- `market` string

## Response `200`

Matches, alphabetical

## Other responses

- `400`: q missing or too short

---

[API](https://skmtc.dev/lodestarstamp/apis/lodestar-trust-api.md) · [All operations](https://skmtc.dev/lodestarstamp/apis/lodestar-trust-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lodestarstamp/apis/lodestar-trust-api/revisions/af78368ab7a5?raw)