{
  "info": {
    "name": "Get Bible · Bookmarks API v1",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Generated from https://bookmarks.getbible.net/v1/openapi.json. Public requests start with no authentication. For optional partner access, select Bearer Token in this collection's Authorization tab and enter a token issued for this domain. Never export or share credentials. Catalogue examples are prefilled; requests labeled Error behavior intentionally demonstrate a documented failure. GET and POST search samples are ready to run."
  },
  "auth": {
    "type": "noauth"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://bookmarks.getbible.net/v1",
      "type": "string"
    },
    {
      "key": "id",
      "value": "adultery",
      "type": "string"
    },
    {
      "key": "book",
      "value": "2",
      "type": "string"
    },
    {
      "key": "chapter",
      "value": "20",
      "type": "string"
    },
    {
      "key": "locale",
      "value": "en",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Discover the catalogue and resource paths",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/index.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "index.json"
          ],
          "query": []
        },
        "description": "Resource paths are relative to this directory. counts.verses counts topic-to-verse associations, not distinct verses. checksum is the SHA-256 of the exact all.json bytes. catalog_version increments when that content checksum changes; documentation-only changes do not increment it. schema_version describes the payload format.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "Download the complete catalogue and all translations",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/all.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "all.json"
          ],
          "query": []
        },
        "description": "Contains all topic metadata and verse coordinates, plus every locale's names. This is the content document hashed by index.json. No Scripture text is included.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "Download every topic with its verse coordinates",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/catalog.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "catalog.json"
          ],
          "query": []
        },
        "description": "The same topics array as all.json, without locale documents. Verse coordinates are translation-independent [book, chapter, verse] triples in the 66-book Protestant canon, sorted without duplicates within a topic. No Scripture text is included.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "List topics with verse counts",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/topics.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "topics.json"
          ],
          "query": []
        },
        "description": "Topic summaries use an integer verses count instead of the coordinate arrays returned by catalog.json and individual topic files. Use the stable id to request a topic. Names and aliases are English display text, not alternative URL identifiers.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "Read one topic and its translated names",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/topics/{{id}}.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "topics",
            "{{id}}.json"
          ],
          "query": []
        },
        "description": "Returns metadata, all verse coordinates, and names keyed by the locales that translate this topic. English (en) is always included. For a missing translation the client should display the English name. Deleted or unknown topic ids have no file.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "Find topics associated with verses in a book",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/verses/{{book}}.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "verses",
            "{{book}}.json"
          ],
          "query": []
        },
        "description": "A file exists for each of the 66 books. chapters maps chapter-number strings to verse-number strings to sorted topic-id arrays. Only linked chapters and verses appear in the maps. An empty chapters object means no associations in the book.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "Find topics associated with verses in a chapter",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/verses/{{book}}/{{chapter}}.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "verses",
            "{{book}}",
            "{{chapter}}.json"
          ],
          "query": []
        },
        "description": "Every valid canonical chapter has a file, even when verses is empty. Keys are verse numbers as strings; values are sorted topic-id arrays. A missing verse key means no associations. A chapter beyond the selected book's chapter count has no file.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "List available locales and translation coverage",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/locales.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "locales.json"
          ],
          "query": []
        },
        "description": "Each entry gives the locale code, its English language name (null if unrecorded), and the number of topic names translated. English (en) is always complete; other locales may translate only part of the catalogue.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "Read topic names for one locale",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/locales/{{locale}}.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "locales",
            "{{locale}}.json"
          ],
          "query": []
        },
        "description": "topics maps stable topic ids to translated names. name is omitted when no language name is recorded. en is derived from the English topic names and is always present. Other locales may be partial. Clients must implement English fallback; requesting an unavailable locale does not automatically return English.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "Read SHA-256 hashes for the generated files",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/checksums.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "checksums.json"
          ],
          "query": []
        },
        "description": "files maps relative paths to SHA-256 hashes of the exact published bytes. Includes index.json and openapi.json; excludes checksums.json itself to avoid self-reference. Use this manifest to verify downloads from the same build.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    },
    {
      "name": "Read this OpenAPI description",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/openapi.json",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "openapi.json"
          ],
          "query": []
        },
        "description": "Generated with the API on every build. Describes the available GET routes, path parameters, response schemas and examples. Response schemas are embedded with local references so schema resolution does not require another download.\n\nSource contract: https://bookmarks.getbible.net/v1/openapi.json\nRunnable catalogue examples are prefilled. Optional filters are disabled unless needed to provide search text. You can change collection variables or request parameters. Full-translation requests may download large documents."
      },
      "response": []
    }
  ]
}
