---
title: "The claim ledger: every quotable claim with its basis and sources"
method: GET
path: "/claims"
---

# The claim ledger: every quotable claim with its basis and sources

`GET /claims`

## Request

- Base URL: `https://greenlitbooks.com/api/v1`
- URL: `https://greenlitbooks.com/api/v1/claims`
- Auth: none required

One export of the whole claim ledger. Each claim carries a stable citation URL pointing at the exact fragment on the book page, whether the sentence is the book's own words, what kind of statement it is, and the one-line rule for quoting that kind honestly. Each external source states both what it establishes and what it does not, so a claim cannot be laundered through a real URL. Coverage is partial and the response says so.

## Response `200`

The claim ledger

- object
  - `meta` Meta: Envelope on every response.
    - `version` 'v1'
    - `generatedAt` string, date-time: When this snapshot was produced. Static endpoints stamp it at deploy; search stamps it per request.
    - `source` string, uri
    - `docs` string, uri
    - `openapi` string, uri
  - `counts` object
    - `books` integer
    - `claims` integer
    - `sources` integer
    - `byBasis` object
  - `license` object: The licence the claim records are published under, and what it covers.
    - `name` string
    - `url` string, uri
    - `attribution` string
    - `covers` string
  - `coverage` string: Which books this export does and does not cover, and why.
  - `dataset` object: This export described as a schema.org Dataset, for anyone cataloguing or republishing it. The same node the developers page renders.
  - `books` ClaimBook[]
    - `slug` string
    - `title` string
    - `url` string, uri
    - `apiUrl` string, uri
    - `lastReviewed` string, date
    - `claims` Claim[]
      - `id` string
      - `url` string, uri: The fragment to cite. Stable: an id is never reworded in place.
      - `anchor` string
      - `chapter` integer
      - `claim` string
      - `verbatim` boolean: True when this is the book's own sentence.
      - `basis` 'external' | 'argument' | 'method' | 'author-experience': What kind of statement this is. The four are not interchangeable.
      - `basisLabel` string
      - `quotingRule` string: How this basis may honestly be quoted.
      - `basisNote` string
      - `citation` Citation: The citation for this claim, already written, in the forms people paste. Both carry the fragment URL, so a quote taken from this export attributes itself.
        - `url` string, uri: The fragment the citation points at.
        - `text` string: Ready to paste into prose. The same string the book page renders. It ends with the date the record was last reviewed rather than an access date, because a build-time access date would describe when the page was generated, not when it was read.
        - `bibtex` string: Ready to paste into a .bib file.
        - `key` string: The BibTeX key on its own, for citing in LaTeX.
      - `sources` ClaimSource[]
        - `title` string
        - `authors` string, nullable
        - `publisher` string, nullable
        - `date` string, nullable: Whatever date the source itself states.
        - `url` string, uri
        - `establishes` string
        - `doesNotEstablish` string
        - `lastChecked` string, date
        - `checkNote` string: Present when the check was indirect, naming how it was made.
      - `book` BookLink: Compact pointer to a book, with its reading-order position in its series.
        - `slug` string
        - `title` string
        - `position` integer: 1-based reading order within the series.
        - `url` string, uri
        - `apiUrl` string, uri

---

[API](https://skmtc.dev/greenlitbooks/apis/greenlit-books-api.md) · [All operations](https://skmtc.dev/greenlitbooks/apis/greenlit-books-api/llms.txt) · [OpenAPI document](https://skmtc.dev/greenlitbooks/apis/greenlit-books-api/revisions/7c8b9f94ca1e?raw)