Trust receipts for a shortlist, in the order asked

Up to 20 domains per call. Results are returned in the order asked and never sorted: facts about each business, not a comparison between them. A domain not on the record is a not_found result, not an error. Without market, a domain on the record in no market that could be read, while a market that might hold it could not be, is an unavailable result naming that market; the rest of the shortlist answers. With market, a market that cannot be read answers 503.

get/v1/trust/batch

Request

  • Base URL: https://api.lodestarstamp.com
  • URL: https://api.lodestarstamp.com/v1/trust/batch
  • 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

domainsstring required
Example:oasisheating.com,myheroair.com
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.

view'receipt' | 'check'

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

X-Lodestar-Consumerstring
Example:my-booking-agent

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

Batch of receipts (each result is a TrustReceipt, not_found, or unavailable); how_to_read rides the envelope once. With view=check each ok result is a TrustCheck body (without schema, api, draft and note, which ride the envelope)

Changes

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