{
  "schema_version": "sg_data_download_metadata.v1",
  "id": "sg-bip-status",
  "name": "Bitcoin Improvement Proposals by status",
  "description": "Every BIP’s status in the BIP repository’s own words, and the changes the desk has seen.",
  "page": "https://satoshigazette.org/data/network/protocol",
  "dictionary": "https://satoshigazette.org/data/dictionary#sg-bip-status",
  "version": "1.0.0",
  "latest": {
    "date": "2026-10-03T14:43:42Z",
    "block_height": null
  },
  "snapshot": "bitcoin/bips at commit 927b6de · read 3 Oct 2026",
  "licence": {
    "name": "CC BY 4.0",
    "title": "Creative Commons Attribution 4.0 International",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "covers": "Satoshi Gazette’s compilation, selection and annotations in the files offered for download.",
    "upstream": "Upstream records keep their own terms, stated per dataset. The Gazette’s articles stay under copyright."
  },
  "cite": "Satoshi Gazette Data Desk, Bitcoin Improvement Proposals by status (sg-bip-status), version 1.0.0, data through 3 Oct 2026. https://satoshigazette.org/data/downloads/sg-bip-status.json",
  "sources": [
    {
      "label": "BIPs index at the commit read",
      "url": "https://github.com/bitcoin/bips/blob/927b6de9915c9262615a6399de51b200f81e5aa4/README.mediawiki"
    },
    {
      "label": "BIP 3, which sets the statuses",
      "url": "https://github.com/bitcoin/bips/blob/master/bip-0003.md"
    },
    {
      "label": "Repository commits feed",
      "url": "https://github.com/bitcoin/bips/commits/master.atom"
    }
  ],
  "source_terms": "The BIPs repository carries no licence of its own. BIP 3, itself BSD-2-Clause, accepts only freely licensed BIPs and has each new one name its licence in its preamble; some older BIPs name none. The BIPs repository is public on GitHub and is read without an account: its commits feed and its raw files only. Each BIP names its own licence in its preamble where it has one. The desk keeps facts from the index and the preambles (number, title, layer, type, status, the date a number was assigned, the BIPs a preamble names as replaced or as a proposed replacement, and a count of author lines) and none of a BIP's text.",
  "files": {
    "json": {
      "url": "https://satoshigazette.org/data/downloads/sg-bip-status.json",
      "media_type": "application/json",
      "bytes": 56223,
      "sha256": "e8901995d2ad65a8958b6576ca267b379d3bcebd4622c83fec7f9c7a7a19505c"
    },
    "csv": {
      "url": "https://satoshigazette.org/data/downloads/sg-bip-status.csv",
      "media_type": "text/csv",
      "bytes": 53929,
      "sha256": "bd9daf28952b31dedc52a1e0ef0363e8ce3fbd88097766084d538301a1ede892",
      "row_is": "One row per BIP the repository’s index links, by number. The recorded status changes and the numbers allocated without a document are in the JSON.",
      "columns": [
        {
          "name": "number",
          "note": "The BIP’s number."
        },
        {
          "name": "file",
          "note": "The BIP’s own file in the repository."
        },
        {
          "name": "title",
          "note": "The Title header of the BIP’s preamble."
        },
        {
          "name": "layer",
          "note": "The Layer header; empty when the preamble names none."
        },
        {
          "name": "type",
          "note": "The Type header: Specification, Informational or Process."
        },
        {
          "name": "status",
          "note": "The Status header: Draft, Complete, Deployed or Closed. The repository’s label, not an endorsement and not an activation."
        },
        {
          "name": "authors",
          "note": "Lines in the Authors header; one line can name more than one person."
        },
        {
          "name": "assigned",
          "note": "The Assigned header: the date the number was assigned."
        },
        {
          "name": "replaces",
          "note": "BIP numbers in the Replaces header, separated by spaces."
        },
        {
          "name": "proposed_replacement",
          "note": "BIP numbers in the Proposed-Replacement header, separated by spaces."
        },
        {
          "name": "held",
          "note": "true when the last read could not read the row; its fields are then what the desk last recorded."
        },
        {
          "name": "held_since",
          "note": "The day the hold began; empty when the row is not held."
        },
        {
          "name": "held_reason",
          "note": "Why the row is held; empty when it is not."
        },
        {
          "name": "commit",
          "note": "The repository commit the rows were read at."
        },
        {
          "name": "url",
          "note": "The BIP’s file on GitHub at that commit."
        }
      ]
    }
  },
  "csv_absent": null,
  "notes": [
    "The JSON also holds every status change the desk has recorded and the numbers the index lists without a document. A status is the BIP repository’s label for a document: not an endorsement, and not an activation."
  ]
}
