{
  "openapi": "3.1.0",
  "info": {
    "title": "Agape Church International — Public Clergy & County Clerk Verification API",
    "version": "1.0.0",
    "summary": "Cryptographic SHA-256 credential verification & U.S. marriage statute open data endpoints.",
    "description": "Public read-only verification API enabling County Clerks, Probate Courts, Vital Records Registrars, and couples to confirm whether Agape Church International issued a specific Credential ID (AG-YYYY-XXXXXX), verify active ecclesiastical standing, and retrieve the U.S. 50-State Marriage Officiant Statute Open Dataset.",
    "contact": {
      "name": "Agape Church International — Office of the Presiding Registrar",
      "url": "https://ordainedministers.org/clerks",
      "email": "registrar@ordainedministers.org"
    },
    "license": {
      "name": "CC BY 4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    }
  },
  "servers": [
    {
      "url": "https://ordainedministers.org",
      "description": "Production Registry & Open Data Server"
    }
  ],
  "paths": {
    "/api/verify-lookup": {
      "get": {
        "operationId": "verifyClergyCredential",
        "summary": "Verify an Agape Registry Credential ID and SHA-256 seal",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "description": "Agape Credential ID formatted as AG-YYYY-XXXXXX",
            "schema": {
              "type": "string",
              "example": "AG-2026-104829"
            }
          },
          {
            "name": "role",
            "in": "query",
            "required": false,
            "description": "Optional caller context (e.g., COUNTY_CLERK_PORTAL)",
            "schema": {
              "type": "string",
              "example": "COUNTY_CLERK_PORTAL"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Verified minister record and SHA-256 cryptographic digest"
          },
          "404": {
            "description": "Credential ID not found in the Agape Registry"
          }
        }
      }
    },
    "/data/us-marriage-officiant-statutes.json": {
      "get": {
        "operationId": "getUsMarriageOfficiantStatutesDataset",
        "summary": "Retrieve the CC BY 4.0 50-State & D.C. Marriage Officiant Statute Dataset",
        "responses": {
          "200": {
            "description": "JSON dataset of all 51 U.S. state-level marriage solemnization statutes"
          }
        }
      }
    }
  }
}