Food-service business verification API
Resolve a submitted venue to its local regulator record.
Send a merchant name and street address. Receive an accepted or rejected result with source-linked evidence.
Last reviewed: 2026-08-13
The recurring decision
Developers repeatedly need a stable regulator facility identifier before storing evidence, adding monitoring, or continuing an onboarding workflow.
Why horizontal data falls short
Broad business and place APIs can return plausible locations without proving that the selected record is the supported regulator facility for the submitted address.
What Venue Authority returns
Venue Authority applies one frozen resolver policy and charges one prepaid unit for each valid authenticated resolution or canonical facility request, including a fail-closed rejection.
Production-compatible API shape
The response shape exposes the disposition, reason, regulator identity, snapshot, and evidence boundary needed by an integration.
curl -X POST https://venueauthority.com/api/v1/resolve \
-H 'Authorization: Bearer YOUR_ONE_TIME_KEY' \
-H 'X-Request-Id: onboarding-000001' \
-H 'Content-Type: application/json' \
--data '{"name":"REDACTED MERCHANT","address":"REDACTED STREET ADDRESS"}'
{
"disposition": "accepted",
"reason": "The name and address clear the corpus resolution policy.",
"record": {
"jurisdiction": "nyc",
"sourceId": "REDACTED",
"name": "REGULATOR-REPORTED NAME",
"sourceUrl": "https://data.cityofnewyork.us/..."
},
"snapshot": {"manifestSha256":"...","schemaVersion":"runtime-corpus/v1"},
"requestId": "onboarding-000001"
}
Questions buyers ask
What input does the resolver require?
The resolver requires a merchant name and street address. A supported jurisdiction can narrow the evaluation input, but the production resolver still applies the same name, address, ambiguity, and collision controls.
Last updated: 2026-08-13
What does one prepaid unit cover?
One unit covers one valid authenticated resolver request or canonical facility request, including a fail-closed rejection. Exact replay returns the stored response without another debit.
Last updated: 2026-08-13
Can developers test before buying capacity?
A verified workspace can claim one complimentary test allowance subject to the lifetime identity controls. Portfolio Proof also evaluates one bounded CSV sample per rolling 30-day period when the feature is enabled.
Last updated: 2026-08-13
Measure your own sample before choosing capacity.
Portfolio Proof uses the same resolver policy and returns bounded aggregate evidence without storing the uploaded CSV.
Run Portfolio Proof