---
title: "The whole catalog in one response"
method: GET
path: "/catalog"
---

# The whole catalog in one response

`GET /catalog`

## Request

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

One-shot dump for agents that prefer a single ingestion: every book at detail depth plus series, imprints, and concepts.

## Response `200`

The full catalog

- 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
  - `publisher` object
    - `name` string
    - `url` string, uri
    - `description` string
  - `counts` object
    - `books` integer
    - `series` integer
    - `concepts` integer
    - `topics` integer
    - `terms` integer
  - `series` Series[]
    - `name` string
    - `slug` string
    - `tier` string: Short audience label.
    - `blurb` string
    - `order` integer: Curated shelf order.
    - `count` integer
    - `url` string, uri
    - `apiUrl` string, uri
    - `books` BookLink[]
      - `slug` string
      - `title` string
      - `position` integer: 1-based reading order within the series.
      - `url` string, uri
      - `apiUrl` string, uri
  - `imprints` Imprint[]
    - `name` string
    - `count` integer
    - `series` string[]: Slugs of the series this imprint spans.
  - `books` BookDetail[]
    - `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
    - `book` Book: One book. No publication date, page count, or ISBN: the catalog carries no verified source for them and nothing is invented. Amazon URLs are clean /dp/ links; every listed book is buyable there and free to read with Kindle Unlimited when kindleUnlimited is true.
      - `slug` string
      - `title` string
      - `subtitle` string, nullable
      - `author` string, nullable
      - `series` object, nullable
        - `name` string
        - `slug` string
        - `position` integer: 1-based reading order within the series.
      - `imprint` string, nullable
      - `readerLevel` 'beginner' | 'operator' | 'engineer' | 'leader'
      - `flagship` boolean
      - `descriptions` object
        - `hook` string, nullable: A quotable opening line.
        - `oneLiner` string, nullable: Short description.
        - `targetReader` string, nullable: Who the book is for.
        - `namedConcept` string, nullable: The named idea the book teaches.
      - `concept` object, nullable: The question-shaped concept page for this book.
        - `name` string
        - `slug` string
        - `question` string
        - `url` string, uri
      - `amazon` object
        - `kindleAsin` string, nullable
        - `paperbackAsin` string, nullable
        - `kindleUrl` string, uri, nullable
        - `paperbackUrl` string, uri, nullable
      - `prices` object
        - `ebook` Price, nullable: Price for one format. amount is parsed from the display string.
          - `display` string
          - `amount` number, nullable
          - `currency` string, nullable
        - `paperback` Price, nullable: Price for one format. amount is parsed from the display string.
          - `display` string
          - `amount` number, nullable
          - `currency` string, nullable
      - `kindleUnlimited` boolean
      - `coverImage` string, uri, nullable
      - `url` string, uri: Canonical book page.
      - `apiUrl` string, uri
      - `markdownUrl` string, uri: Plain-markdown twin of the book page.
      - `readUrl` string, uri, nullable: Free chapter one, when available.
      - `categories` string[]
      - `companionRepo` string, uri, nullable: Public companion code repository, when the book ships code.
    - `chapters` object[]
      - `number` integer
      - `title` string
    - `totalWords` integer, nullable
    - `claims` object, nullable: Quotable claims from the book with the sources behind them, or null for a book with no ledger yet. Each item's `url` is an anchor on the book page that resolves to that exact claim: quote `claim`, cite `url`.
      - `lastReviewed` string, date
      - `items` object[]
        - `id` string
        - `chapter` integer
        - `claim` string
        - `verbatim` boolean: True when `claim` is the book's own sentence, word for word.
        - `basis` 'external' | 'argument' | 'method' | 'author-experience': What kind of statement this is. A published result, a position the book argues, a method you run yourself, or something the author reports happening on his own system. They are not interchangeable and should not be quoted as if they were.
        - `basisLabel` string
        - `howToQuote` string
        - `basisNote` string, nullable
        - `anchor` string
        - `url` string, uri
        - `sources` object[]
          - `title` string
          - `authors` string, nullable
          - `publisher` string, nullable
          - `date` string, nullable
          - `url` string, uri
          - `establishes` string
          - `doesNotEstablish` string: What the claim would be overreaching to draw from this source. Read it before leaning on the citation.
          - `lastChecked` string, date
          - `checkNote` string, nullable
    - `excerpt` object: The free chapter-one excerpt, when published.
      - `available` boolean
      - `chapterTitle` string, nullable
      - `words` integer, nullable
      - `minutes` integer, nullable
      - `url` string, uri, nullable
      - `markdownUrl` string, uri, nullable
    - `related` object
      - `guide` object, nullable
        - `title` string
        - `slug` string
        - `url` string, uri
      - `fieldNotes` object[]
        - `title` string
        - `slug` string
        - `description` string
        - `url` string, uri
      - `compares` object[]
        - `title` string
        - `slug` string
        - `url` string, uri
      - `seriesNeighbors` object
        - `previous` 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
        - `next` 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
  - `concepts` Concept[]
    - `name` string
    - `slug` string
    - `question` string
    - `shortAnswer` string
    - `url` string, uri
    - `markdownUrl` string, uri: Markdown twin with the full body and FAQ.
    - `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
  - `terms` Term[]
    - `slug` string
    - `term` string
    - `aliases` string[]
    - `kind` 'coined' | 'operational': coined: the house minted the phrase. operational: an industry term whose AI-agent definition the home book supplies.
    - `fieldOfOrigin` string, nullable
    - `definition` string: The book's own sentence, verbatim.
    - `definedIn` object
      - `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
      - `chapter` string
      - `source` 'bible' | 'manuscript'
    - `usedInBooks` BookLink[]
      - `slug` string
      - `title` string
      - `position` integer: 1-based reading order within the series.
      - `url` string, uri
      - `apiUrl` string, uri
    - `checkable` object
      - `claim` string
      - `howToCheck` string
    - `faq` object[]
      - `q` string
      - `a` string
    - `relatedTerms` object[]
      - `slug` string
      - `term` string
      - `url` string, uri
      - `apiUrl` string, uri
    - `url` string, uri
    - `markdownUrl` string, uri
    - `apiUrl` string, uri
    - `lastVerified` string, date
    - `links` HandoffLinks: Where to send a reader next. freeChapter is the complete chapter one, free; Amazon links are bare /dp/ URLs; citeAs is a ready citation line.
      - `glossary` string, uri, nullable
      - `glossaryMarkdown` string, uri, nullable
      - `concept` string, uri, nullable
      - `conceptMarkdown` string, uri, nullable
      - `book` string, uri
      - `bookApi` string, uri
      - `bookMarkdown` string, uri
      - `freeChapter` string, uri, nullable
      - `freeChapterMarkdown` string, uri, nullable
      - `amazonKindle` string, uri, nullable
      - `amazonPaperback` string, uri, nullable
      - `kindleUnlimited` boolean
      - `citeAs` string

---

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