Trust receipt by exactly one identifier: domain, phone, license or address
Dated facts with their sources. Advisory and non-blocking; the consumer retains the decision. Pass exactly one identifier. Phone, license and address resolve only against identifiers on file for a covered business (never fuzzy); two businesses behind one identifier answer 300 with candidates and no receipt.
Request
- Base URL: https://api.lodestarstamp.com
- URL: https://api.lodestarstamp.com/v1/trust
- 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
E.164 or 10-digit US number; punctuation ignored.
Licence number as printed by the register. Case, a leading # and the license: or lic- prefix of a record id are ignored; on a domain-keyed market so is punctuation. 400 bad_license when nothing but punctuation is left, when more than 32 letters and digits are, or for a control character or a letter or digit outside ASCII.
Street address, as the business publishes it or as the register prints it. The street line before the first comma decides: city, state, ZIP and a unit (floor, suite, storefront) are set aside, and a number inside a registered range (1000-1012) matches it. Case, punctuation and common abbreviations (N, St, Ave, Rd, Blvd) are normalised; a missing directional or suffix is never guessed. Several businesses at one address answer 300 with candidates.
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.
receipt (default) answers the full TrustReceipt. check answers the compact TrustCheck: the same receipt, projected to matched, the dated facts with their sources, the fields not published and the first expiry. Unknown values answer 400 unknown_view.
Headers
Optional self-declared consumer name, e.g. my-booking-agent. Never gates or changes the response. Used to count distinct integrations without a key, a cookie or an IP. Sending it adds only that string to what we store.
Response
Trust receipt (DRAFT); with view=check, the compact TrustCheck
Example response
{
"receipt": {
"fields": {
"real": {
"instrument": "chicago-bacp-r5kz-chrr"
},
"at_that_address": {
"instrument": "chicago-bacp-r5kz-chrr"
},
"licensed": {
"instrument": "chicago-bacp-r5kz-chrr"
},
"inspection": {
"instrument": "chicago-bacp-r5kz-chrr"
},
"closure": {
"instrument": "chicago-bacp-r5kz-chrr"
}
}
}
}Changes
No recorded changes to this operation across all 1 revision of this API.