{
  "openapi": "3.1.0",
  "info": {
    "title": "U.S. Religious Institution Evidence Atlas",
    "version": "2026-08-22",
    "description": "Keyless static access to reviewed institution records, official-action records, typed aggregate measurements, coverage gaps, and evidence lineage. Fetch once and filter locally; hosting-layer throttling or abuse controls may still apply.",
    "license": {
      "name": "CC BY 4.0",
      "identifier": "CC-BY-4.0"
    }
  },
  "servers": [
    {
      "url": "/",
      "description": "Current origin"
    }
  ],
  "paths": {
    "/religious-accountability/data.json": {
      "get": {
        "operationId": "getReligiousInstitutionEvidenceAtlas",
        "summary": "Fetch the complete versioned evidence atlas",
        "responses": {
          "200": {
            "description": "Complete dataset; no authentication or pagination required.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "/religious-accountability/schema.json"
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/action-records.ndjson": {
      "get": {
        "operationId": "getReligiousInstitutionActionRecordsNdjson",
        "summary": "Fetch one complete action record per JSON line",
        "responses": {
          "200": {
            "description": "55 newline-delimited action records. Validate each line against #/properties/action_records/items in the JSON Schema.",
            "content": {
              "application/x-ndjson": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/x-ndjson",
                  "description": "A newline-delimited text stream. Parse each non-empty line as one JSON value."
                },
                "x-ndjson-item-schema": {
                  "$ref": "/religious-accountability/schema.json#/properties/action_records/items"
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/institution-records.ndjson": {
      "get": {
        "operationId": "getReligiousInstitutionRecordsNdjson",
        "summary": "Fetch one CMS religious-classification institution record per JSON line",
        "responses": {
          "200": {
            "description": "1,240 newline-delimited CMS QIES and iQIES institution records. Validate each line against #/properties/institution_records/items in the JSON Schema.",
            "content": {
              "application/x-ndjson": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/x-ndjson",
                  "description": "A newline-delimited text stream. Parse each non-empty line as one JSON value."
                },
                "x-ndjson-item-schema": {
                  "$ref": "/religious-accountability/schema.json#/properties/institution_records/items"
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/sources.json": {
      "get": {
        "operationId": "getReligiousInstitutionOfficialSourceRegistry",
        "summary": "Fetch the deduplicated government and first-party source reverse index",
        "responses": {
          "200": {
            "description": "All 125 reviewed URLs with stable source IDs and reverse links to records, collections, action IDs, agencies, labels, and publishers.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "api_version",
                    "publication",
                    "dataset_id",
                    "boundary",
                    "count",
                    "sources"
                  ],
                  "properties": {
                    "api_version": {
                      "$ref": "/religious-accountability/schema.json#/properties/api_version"
                    },
                    "publication": {
                      "$ref": "/religious-accountability/schema.json#/properties/publication"
                    },
                    "dataset_id": {
                      "$ref": "/religious-accountability/schema.json#/properties/dataset/properties/id"
                    },
                    "boundary": {
                      "$ref": "/religious-accountability/schema.json#/properties/official_source_registry/properties/boundary"
                    },
                    "count": {
                      "type": "integer",
                      "const": 125
                    },
                    "sources": {
                      "$ref": "/religious-accountability/schema.json#/properties/official_source_registry/properties/entries"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/schema.json": {
      "get": {
        "operationId": "getReligiousInstitutionEvidenceAtlasSchema",
        "summary": "Fetch the JSON Schema",
        "responses": {
          "200": {
            "description": "JSON Schema 2020-12 contract.",
            "content": {
              "application/schema+json": {
                "schema": {
                  "$ref": "https://json-schema.org/draft/2020-12/schema"
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/openapi.json": {
      "get": {
        "operationId": "getReligiousInstitutionEvidenceAtlasOpenApi",
        "summary": "Fetch this OpenAPI 3.1 discovery document",
        "responses": {
          "200": {
            "description": "Complete OpenAPI 3.1 document for the static machine endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "https://spec.openapis.org/oas/3.1/schema/2022-10-07"
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/manifest.json": {
      "get": {
        "operationId": "getReligiousInstitutionEvidenceAtlasReleaseManifest",
        "summary": "Fetch endpoint hashes, byte counts, version, and release provenance",
        "responses": {
          "200": {
            "description": "Release manifest for independently verifying the seven data and contract artifacts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "schemaVersion",
                    "artifact",
                    "apiVersion",
                    "publicationStatus",
                    "public",
                    "releaseDate",
                    "canonicalBaseUrl",
                    "backendEvidenceCommit",
                    "projectionAuthorization",
                    "provenance",
                    "files",
                    "remoteWritesPerformed"
                  ],
                  "properties": {
                    "schemaVersion": {
                      "type": "integer",
                      "const": 1
                    },
                    "artifact": {
                      "type": "string",
                      "const": "religious-accountability-agent-api"
                    },
                    "apiVersion": {
                      "type": "string",
                      "const": "2026-08-22"
                    },
                    "publicationStatus": {
                      "type": "string",
                      "const": "PUBLISHED"
                    },
                    "public": {
                      "type": "boolean",
                      "const": true
                    },
                    "releaseDate": {
                      "type": "string",
                      "format": "date"
                    },
                    "canonicalBaseUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "backendEvidenceCommit": {
                      "type": "string",
                      "pattern": "^[a-f0-9]{40}$"
                    },
                    "projectionAuthorization": {
                      "type": "object",
                      "required": [
                        "displayedActionRecords",
                        "institutionRecords",
                        "institutionCollections",
                        "officialSourceRegistryEntries",
                        "evidenceHashes",
                        "institutionOnly",
                        "naturalPersonRecordsIncluded",
                        "badActorLabelAllowed",
                        "corruptionClaimAllowed",
                        "misconductInferenceAllowed",
                        "religiousSectorCensusClaimAllowed",
                        "presentStatusInferenceAllowed"
                      ],
                      "properties": {
                        "displayedActionRecords": {
                          "type": "integer",
                          "const": 55
                        },
                        "institutionRecords": {
                          "type": "integer",
                          "const": 1240
                        },
                        "institutionCollections": {
                          "type": "integer",
                          "const": 3
                        },
                        "officialSourceRegistryEntries": {
                          "type": "integer",
                          "const": 125
                        },
                        "evidenceHashes": {
                          "type": "integer",
                          "const": 141
                        },
                        "institutionOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "naturalPersonRecordsIncluded": {
                          "type": "boolean",
                          "const": false
                        },
                        "badActorLabelAllowed": {
                          "type": "boolean",
                          "const": false
                        },
                        "corruptionClaimAllowed": {
                          "type": "boolean",
                          "const": false
                        },
                        "misconductInferenceAllowed": {
                          "type": "boolean",
                          "const": false
                        },
                        "religiousSectorCensusClaimAllowed": {
                          "type": "boolean",
                          "const": false
                        },
                        "presentStatusInferenceAllowed": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "historicalSourcePackageState",
                        "releaseAuthorizationIsSeparate",
                        "locatorIntegrityRule",
                        "backendEvidencePackages",
                        "frontendHoldPackages",
                        "displayedEvidenceHashes",
                        "metadataGaps",
                        "publicationAuthorizationSha256",
                        "publicationAuthorizationUrl",
                        "receiptBindingsSha256",
                        "receiptBindingsUrl",
                        "vendoredEvidenceManifestSha256",
                        "vendoredEvidenceManifestUrl"
                      ],
                      "properties": {
                        "historicalSourcePackageState": {
                          "type": "string",
                          "const": "HOLD"
                        },
                        "releaseAuthorizationIsSeparate": {
                          "type": "boolean",
                          "const": true
                        },
                        "locatorIntegrityRule": {
                          "type": "string",
                          "const": "The public provenance endpoints emit the exact source-file bytes. Verify every retrieved file matches its adjacent SHA-256 value before use."
                        },
                        "backendEvidencePackages": {
                          "type": "integer",
                          "const": 55
                        },
                        "frontendHoldPackages": {
                          "type": "integer",
                          "const": 2
                        },
                        "displayedEvidenceHashes": {
                          "type": "integer",
                          "const": 141
                        },
                        "metadataGaps": {
                          "type": "integer",
                          "const": 0
                        },
                        "publicationAuthorizationSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "publicationAuthorizationUrl": {
                          "type": "string",
                          "format": "uri"
                        },
                        "receiptBindingsSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "receiptBindingsUrl": {
                          "type": "string",
                          "format": "uri"
                        },
                        "vendoredEvidenceManifestSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "vendoredEvidenceManifestUrl": {
                          "type": "string",
                          "format": "uri"
                        }
                      },
                      "additionalProperties": false
                    },
                    "files": {
                      "type": "object",
                      "minProperties": 7,
                      "maxProperties": 7,
                      "additionalProperties": {
                        "type": "object",
                        "required": [
                          "name",
                          "url",
                          "bytes",
                          "sha256"
                        ],
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "bytes": {
                            "type": "integer",
                            "minimum": 1
                          },
                          "sha256": {
                            "type": "string",
                            "pattern": "^[a-f0-9]{64}$"
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "remoteWritesPerformed": {
                      "type": "boolean",
                      "const": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/publication.json": {
      "get": {
        "operationId": "getReligiousInstitutionEvidenceAtlasPublicationAuthorization",
        "summary": "Fetch the byte-exact public projection authorization",
        "responses": {
          "200": {
            "description": "Exact source-file bytes for the publication authorization. Verify the response against provenance.publicationAuthorizationSha256 in manifest.json.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/receipt-bindings.json": {
      "get": {
        "operationId": "getReligiousInstitutionEvidenceAtlasReceiptBindings",
        "summary": "Fetch the byte-exact evidence receipt bindings",
        "responses": {
          "200": {
            "description": "Exact source-file bytes for the receipt bindings. Verify the response against provenance.receiptBindingsSha256 in manifest.json.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/evidence-manifest.json": {
      "get": {
        "operationId": "getReligiousInstitutionEvidenceAtlasEvidenceManifest",
        "summary": "Fetch the byte-exact vendored evidence manifest",
        "responses": {
          "200": {
            "description": "Exact source-file bytes for the vendored evidence manifest. Verify the response against provenance.vendoredEvidenceManifestSha256 in manifest.json.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/religious-accountability/agents.txt": {
      "get": {
        "operationId": "getReligiousInstitutionEvidenceAtlasAgentInstructions",
        "summary": "Fetch concise agent interpretation rules",
        "responses": {
          "200": {
            "description": "Plain-text discovery and safety contract.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}