---
title: "Trust receipts for a shortlist, in the order asked"
method: GET
path: "/v1/trust/batch"
---

# Trust receipts for a shortlist, in the order asked

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

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.

## Query parameters

- `domains` string, required
- `market` string
- `view` 'receipt' | 'check'

## Headers

- `X-Lodestar-Consumer` string

## Response `200`

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)

## Other responses

- `400`: No domains, or more than the cap
- `402`: Not used while reads are free.
- `503`: record_unavailable: the market named with market could not be read. Retry-After says when to ask again.

---

[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)