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.

get/v1/trust

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

domainstring
Example:oasisheating.com
phonestring
Example:+17735550100

E.164 or 10-digit US number; punctuation ignored.

licensestring
Example:2981486

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.

addressstring
Example:123 N Main St, Chicago, IL 60601

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.

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

Trust receipt (DRAFT); with view=check, the compact TrustCheck

OR

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.