---
title: "Assistant-read aggregates for one business this edition"
method: GET
path: "/v1/reads"
---

# Assistant-read aggregates for one business this edition

`GET /v1/reads`

## Request

- Base URL: `https://api.lodestarstamp.com`
- URL: `https://api.lodestarstamp.com/v1/reads`
- 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`

read_count and distinct_consumers only. Does not increment. /v1/trust increments asynchronously after the receipt is sent.

## Query parameters

- `domain` string
- `license` string
- `market` string

## Response `200`

Aggregates only

## Other responses

- `400`: Missing identifier
- `404`: Not on the record
- `503`: record_unavailable: a market that might hold the business could not be read. With market, the market named; without it, a market asked in the fall-through while no market that could be read holds the business. Not a finding either way; 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)