{
  "openapi": "3.1.0",
  "info": {
    "title": "JIL Sovereign HTTP API",
    "version": "2026-10-21",
    "summary": "Routes measured on the API host, plus the repository operations the live catalog names.",
    "description": "Operated by JIL Sovereign Technologies, Inc. (Delaware). Phone +1 (855) 572-9636. Measured 2026-10-21 on https://api.jilsovereign.com. The companion PDF is https://jilsovereign.com/openapi/jilsovereign-api.pdf. Topic YAML paths on the API host returned HTTP 404. The files on https://jilsovereign.com/openapi/ are the repository specifications those paths name. The repository catalog also names areb and pieb. The live catalog response did not include them, and GET /v1/catalog/areb and GET /v1/catalog/pieb returned HTTP 404. They are not paths in this document. The root apis array includes ava. GET /v1/catalog/ava returned HTTP 404. ava is not a catalog topic. Empty-endpoint topics (insuredaudit, pre-clearance, federal-grants, phantom-employee) stay out of this path list. Their repository files are on the website and are labeled discovery-only in the PDF. Authorization measured on the root document: scheme hybrid-pq-signature, algorithms ed25519, ml-dsa-65, headers X-API-Key, X-API-Timestamp, X-API-Nonce, X-API-Signature, X-API-PQ-Signature, challenge METHOD\\nORIGINAL_URL\\nSHA256(body)\\nTIMESTAMP\\nNONCE, enforced true. No sample signature and no key are printed. The catalog says self-serve topics use POST /v1/subscribe and Stripe. No subscribe request was sent, and no price is printed. This document is not a public L1 JSON-RPC API.",
    "contact": {
      "name": "JIL Sovereign Technologies, Inc.",
      "url": "https://jilsovereign.com/developers"
    }
  },
  "servers": [
    {
      "url": "https://api.jilsovereign.com",
      "description": "Measured API host."
    }
  ],
  "paths": {
    "/": {
      "get": {
        "operationId": "get_root",
        "summary": "Gateway discovery.",
        "description": "Measured 2026-10-21. HTTP 200, application/json, 590 bytes. The apis array includes ava. ava is not a catalog topic.",
        "responses": {
          "200": {
            "description": "Measured root document.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "service": "JIL Sovereign API Gateway",
                  "base_url": "https://api.jilsovereign.com",
                  "docs": "https://api.jilsovereign.com/docs",
                  "catalog": "https://api.jilsovereign.com/v1/catalog",
                  "console": "https://developers.jilsovereign.com",
                  "auth": {
                    "scheme": "hybrid-pq-signature",
                    "algorithms": [
                      "ed25519",
                      "ml-dsa-65"
                    ],
                    "headers": [
                      "X-API-Key",
                      "X-API-Timestamp",
                      "X-API-Nonce",
                      "X-API-Signature",
                      "X-API-PQ-Signature"
                    ],
                    "challenge": "METHOD\\nORIGINAL_URL\\nSHA256(body)\\nTIMESTAMP\\nNONCE",
                    "enforced": true
                  },
                  "apis": [
                    "asset-intelligence",
                    "igaming",
                    "kyc",
                    "payment-integrity",
                    "attestyx",
                    "metering",
                    "courtchain",
                    "ava"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/health": {
      "get": {
        "operationId": "get_health",
        "summary": "Gateway health.",
        "description": "Measured 2026-10-21. HTTP 200.",
        "responses": {
          "200": {
            "description": "Measured health body.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "status": "ok",
                  "service": "api-gateway"
                }
              }
            }
          }
        }
      }
    },
    "/ready": {
      "get": {
        "operationId": "get_ready",
        "summary": "Gateway readiness.",
        "description": "Measured 2026-10-21. HTTP 200. Same body as /health.",
        "responses": {
          "200": {
            "description": "Measured readiness body.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "status": "ok",
                  "service": "api-gateway"
                }
              }
            }
          }
        }
      }
    },
    "/docs": {
      "get": {
        "operationId": "get_docs",
        "summary": "HTML reference page.",
        "description": "Measured 2026-10-21. HTTP 200, text/html, 6211 bytes, title JIL Sovereign API Reference. The page has no OpenAPI link. The only hrefs are https://developers.jilsovereign.com and /.",
        "responses": {
          "200": {
            "description": "HTML page. No OpenAPI document is embedded."
          }
        }
      }
    },
    "/v1/catalog": {
      "get": {
        "operationId": "get_catalog",
        "summary": "Public topic catalog.",
        "description": "Measured 2026-10-21. HTTP 200, application/json, 5474 bytes. Eleven topics. Plan objects on this list use quota and blurb. A topic detail uses monthlyQuota and priceEnv. priceEnv is an environment-variable name and is not printed. No price is printed. GET /v1/catalog/areb, /v1/catalog/pieb, and /v1/catalog/ava each returned HTTP 404 and {\"error\":\"unknown topic\"}.",
        "responses": {
          "200": {
            "description": "Measured catalog, topics reduced to their discovery fields. The saved list body is the source of the PDF.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "service": "JIL Sovereign API",
                  "base_url": "https://api.jilsovereign.com",
                  "discovery": "GET /v1/catalog (public)",
                  "authorization": {
                    "model": "per-consumer subscription",
                    "self_serve": "Self-serve topics: POST /v1/subscribe to pay via Stripe; your credential is auto-issued on payment, no approval.",
                    "request_access": "Request-access topics: contact JIL Sovereign; provisioned per engagement.",
                    "scheme": "hybrid-pq-signature (Ed25519 + ML-DSA-65)"
                  },
                  "topics": [
                    {
                      "id": "asset-intelligence",
                      "title": "Asset Intelligence",
                      "status": "available",
                      "access": "self-serve",
                      "endpoint_count": 1,
                      "openapi": "/openapi/asset-intelligence.yaml"
                    },
                    {
                      "id": "igaming",
                      "title": "iGaming Pre-Payment Integrity",
                      "status": "available",
                      "access": "self-serve",
                      "endpoint_count": 1,
                      "openapi": "/openapi/igaming.yaml"
                    },
                    {
                      "id": "kyc",
                      "title": "KYC / KYB",
                      "status": "available",
                      "access": "self-serve",
                      "endpoint_count": 8,
                      "openapi": "/openapi/kyc.yaml"
                    },
                    {
                      "id": "payment-integrity",
                      "title": "Payment Integrity",
                      "status": "available",
                      "access": "request-access",
                      "endpoint_count": 4,
                      "openapi": "/openapi/payment-integrity.yaml"
                    },
                    {
                      "id": "attestyx",
                      "title": "Attestyx",
                      "status": "available",
                      "access": "request-access",
                      "endpoint_count": 1,
                      "openapi": "/openapi/attestyx.yaml"
                    },
                    {
                      "id": "insuredaudit",
                      "title": "InsuredAudit",
                      "status": "request-access",
                      "access": "request-access",
                      "endpoint_count": 0,
                      "openapi": "/openapi/insuredaudit.yaml"
                    },
                    {
                      "id": "pre-clearance",
                      "title": "JIL Corridor (Pre-Clearance)",
                      "status": "request-access",
                      "access": "request-access",
                      "endpoint_count": 0,
                      "openapi": "/openapi/pre-clearance.yaml"
                    },
                    {
                      "id": "federal-grants",
                      "title": "Federal Grants Integrity",
                      "status": "request-access",
                      "access": "request-access",
                      "endpoint_count": 0,
                      "openapi": "/openapi/federal-grants.yaml"
                    },
                    {
                      "id": "phantom-employee",
                      "title": "Phantom Employee Detection",
                      "status": "request-access",
                      "access": "request-access",
                      "endpoint_count": 0,
                      "openapi": "/openapi/phantom-employee.yaml"
                    },
                    {
                      "id": "metering",
                      "title": "Usage Metering & Billing",
                      "status": "available",
                      "access": "request-access",
                      "endpoint_count": 5,
                      "openapi": "/openapi/metering.yaml"
                    },
                    {
                      "id": "courtchain",
                      "title": "CourtChain (CREB Record Anchor)",
                      "status": "available",
                      "access": "request-access",
                      "endpoint_count": 2,
                      "openapi": "/openapi/courtchain.yaml"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/catalog/{id}": {
      "get": {
        "operationId": "get_catalog_topic",
        "summary": "One catalog topic.",
        "description": "Measured 2026-10-21. GET /v1/catalog/asset-intelligence returned HTTP 200. The detail plan objects add priceEnv and monthlyQuota. Those environment-variable names are not printed. Unknown ids measured the same day (areb, pieb, ava) returned HTTP 404.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "One topic object. A full example is not repeated here because it carries priceEnv."
          },
          "404": {
            "description": "Unknown topic.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "error": "unknown topic"
                }
              }
            }
          }
        }
      }
    },
    "/openapi/{topic}.yaml": {
      "get": {
        "operationId": "get_topic_yaml_on_the_api_host",
        "summary": "The API host does not serve these files.",
        "description": "Measured 2026-10-21. Every catalog openapi path returned HTTP 404, application/json, 92 bytes. The copies on https://jilsovereign.com/openapi/ are the repository specifications.",
        "parameters": [
          {
            "name": "topic",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "404": {
            "description": "Measured body.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "error": "unknown endpoint",
                  "hint": "GET https://api.jilsovereign.com/ lists available APIs"
                }
              }
            }
          }
        }
      }
    },
    "/v1/intel/inquiry": {
      "post": {
        "operationId": "post_asset-intelligence_v1_intel_inquiry",
        "summary": "Run one asset-intelligence inquiry (type selects the engine)",
        "description": "Repository specification JIL Sovereign Asset-Intelligence API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/asset-intelligence.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/asset-intelligence.yaml. The request body MUST carry a `type`. Remaining properties are the payload for that inquiry type. Plan entitlement for `type` is enforced before dispatch; a plan that lacks the type returns 403.",
        "responses": {
          "200": {
            "description": "Specification example. screen",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "inquiry": "screen",
                  "licensee": "Acme Investigations LLC",
                  "result": {
                    "address": "0xabc...",
                    "status": "KNOWN_SERVICE",
                    "risk": "low",
                    "owner": "Coinbase",
                    "category": "exchange",
                    "sanctioned": false,
                    "badActor": false,
                    "custodian": true,
                    "sources": [
                      "jil-seed",
                      "ofac"
                    ],
                    "reasons": [
                      "matched known-service label"
                    ]
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "examples": {
                "spec_1": {
                  "summary": "screen: Screen a single address",
                  "value": {
                    "type": "screen",
                    "address": "0xabc...",
                    "chainId": 1
                  }
                },
                "spec_2": {
                  "summary": "prepayment: Pre-payment wallet decision",
                  "value": {
                    "type": "prepayment",
                    "event": "deposit",
                    "chain": "ETH",
                    "address": "0xabc...",
                    "amountUsd": 5000
                  }
                },
                "spec_3": {
                  "summary": "trace: Trace counterparties",
                  "value": {
                    "type": "trace",
                    "address": "0xabc...",
                    "chainId": 1,
                    "depth": 2,
                    "direction": "both"
                  }
                },
                "spec_4": {
                  "summary": "discover: Discover assets for a named subject",
                  "value": {
                    "type": "discover",
                    "subjectId": "subj-001",
                    "subjectName": "Jane Roe",
                    "jurisdictions": [
                      "US-DE"
                    ]
                  }
                },
                "spec_5": {
                  "summary": "cluster: Cluster addresses under common control",
                  "value": {
                    "type": "cluster",
                    "chain": "BTC",
                    "address": "bc1q...",
                    "maxAddresses": 500
                  }
                },
                "spec_6": {
                  "summary": "creb: Generate a CREB bundle (enterprise)",
                  "value": {
                    "type": "creb",
                    "planId": "plan-001",
                    "clusterId": "cl-001"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/igaming/pre-payment": {
      "post": {
        "operationId": "post_igaming_v1_igaming_pre-payment",
        "summary": "Synchronous pre-payment wallet decision (ALLOW / REVIEW / BLOCK)",
        "description": "Repository specification JIL Sovereign iGaming Pre-Payment API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/igaming.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/igaming.yaml. Call inline before settling a deposit/withdrawal. `address` and `chain` are required. `chain` accepts ETH or BTC (SOL is not supported for this decision). Supply `knownPlayerAddresses` to run the multi-accounting check against the operator's other player wallets.",
        "responses": {
          "200": {
            "description": "Specification example. review",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "decision": "REVIEW",
                  "risk": "medium",
                  "reasons": [
                    "funded via mixer-adjacent address",
                    "2 linked player accounts"
                  ],
                  "sanctions": "CLEAR",
                  "clusterAccounts": 3,
                  "linkedPlayerAccounts": [
                    "0xdef...",
                    "0x123..."
                  ],
                  "sourceOfFunds": {
                    "firstFunder": "0x999...",
                    "funderLabel": "unknown EOA",
                    "mixerFunded": true
                  },
                  "event": "deposit",
                  "playerId": "player-7781",
                  "address": "0xabc...",
                  "chain": "ETH",
                  "generatedAt": "2026-06-08T12:00:00Z",
                  "latencyMs": 412,
                  "warnings": []
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "examples": {
                "spec_1": {
                  "summary": "deposit: Deposit decision with multi-accounting check",
                  "value": {
                    "event": "deposit",
                    "playerId": "player-7781",
                    "chain": "ETH",
                    "address": "0xabc...",
                    "amountUsd": 5000,
                    "knownPlayerAddresses": [
                      "0xdef...",
                      "0x123..."
                    ],
                    "engagementId": "eng-2026-09",
                    "permissiblePurpose": "AML/KYC pre-transaction screening"
                  }
                },
                "spec_2": {
                  "summary": "withdrawal: Minimal withdrawal decision",
                  "value": {
                    "event": "withdrawal",
                    "chain": "BTC",
                    "address": "bc1q..."
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/kyc/verify": {
      "post": {
        "operationId": "post_kyc_v1_kyc_verify",
        "summary": "Individual KYC verification (sanctions screen + risk score + decision)",
        "description": "Repository specification JIL Sovereign KYC / KYB Verification version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/kyc.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/kyc.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/kyb/verify": {
      "post": {
        "operationId": "post_kyc_v1_kyb_verify",
        "summary": "Business KYB verification (BEC + BID + sanctions -> combined risk)",
        "description": "Repository specification JIL Sovereign KYC / KYB Verification version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/kyc.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/kyc.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/kyc/tier": {
      "post": {
        "operationId": "post_kyc_v1_kyc_tier",
        "summary": "Risk-based verification tiering (returns the minimum tier required)",
        "description": "Repository specification JIL Sovereign KYC / KYB Verification version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/kyc.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/kyc.yaml. Runs the free in-house checks (sanctions/PEP + email/domain BEC signals), scores risk 0-100, and decides the minimum verification tier so the paid doc+biometric vendor is only triggered for flagged or high-value subjects. Tier 0 = clear (in-house sufficient), Tier 1 = authoritative database match, Tier 2 = gov-ID document auth + liveness selfie. A sanctions hit returns action `reject`. At least one of `fullName` or `email` is required.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/kyc/sanctions": {
      "post": {
        "operationId": "post_kyc_v1_kyc_sanctions",
        "summary": "Sanctions / PEP screening (Yente / OpenSanctions with OFAC fallback)",
        "description": "Repository specification JIL Sovereign KYC / KYB Verification version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/kyc.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/kyc.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/kyc/bec": {
      "post": {
        "operationId": "post_kyc_v1_kyc_bec",
        "summary": "Business Email Compromise / vendor-impersonation check",
        "description": "Repository specification JIL Sovereign KYC / KYB Verification version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/kyc.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/kyc.yaml. Combines RDAP domain age + MX/SPF/DMARC + lookalike detection + disposable-email blocklist into a BEC risk score.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/kyc/bid": {
      "post": {
        "operationId": "post_kyc_v1_kyc_bid",
        "summary": "Business Identity Document validation (registry + LEI + jurisdiction)",
        "description": "Repository specification JIL Sovereign KYC / KYB Verification version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/kyc.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/kyc.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/payments/pre-screen": {
      "post": {
        "operationId": "post_kyc_v1_payments_pre-screen",
        "summary": "Pre-screen a payment instruction (IBAN/BIC validity + corridor risk)",
        "description": "Repository specification JIL Sovereign KYC / KYB Verification version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/kyc.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/kyc.yaml. Validates the destination IBAN (MOD-97) and SWIFT BIC (ISO 9362), assesses the cross-border corridor risk, and returns an action.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/payment-integrity/attestations": {
      "post": {
        "operationId": "post_payment-integrity_v1_payment-integrity_attestations",
        "summary": "Create a pre-settlement attestation (deterministic PASS / REVIEW / BLOCK / ESCALATE verdict)",
        "description": "Repository specification JIL Sovereign Payment Integrity Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/payment-integrity.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/payment-integrity.yaml. Scores a payment, payout, refund, or account event before money moves. Runs sanctions screening, reputation-graph lookup, bad-actor matching, device/IP intelligence, and velocity in parallel, then returns a sealed deterministic verdict. Idempotent on the `Idempotency-Key` header (a replay returns the original response with `X-Idempotent-Replay: true`).",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "examples": {
                "spec_1": {
                  "summary": "trusted_purchase: Established account, US card, clean history",
                  "value": {
                    "event_type": "PAYMENT_PURCHASE",
                    "merchant_id": "epic-games",
                    "external_transaction_id": "txn_10293",
                    "user": {
                      "user_id": "u_good",
                      "account_age_days": 900,
                      "prior_chargeback_count": 0,
                      "prior_purchase_count": 50
                    },
                    "payment": {
                      "amount": 19.99,
                      "currency": "USD",
                      "payment_method_type": "CARD",
                      "card_country": "US"
                    },
                    "network": {
                      "ip_address": "203.0.113.10",
                      "country": "US"
                    },
                    "context": {
                      "channel": "WEB"
                    }
                  }
                },
                "spec_2": {
                  "summary": "sanctioned_wallet: Crypto payout to an OFAC-listed address",
                  "value": {
                    "event_type": "WALLET_PAYOUT",
                    "merchant_id": "epic-games",
                    "external_transaction_id": "txn_55012",
                    "payment": {
                      "amount": 5000,
                      "currency": "USD",
                      "payment_method_type": "CRYPTO_WALLET"
                    },
                    "wallet": {
                      "wallet_address": "0x8589427373d6d84e98730d7795d8f6f8731fda16",
                      "blockchain": "Ethereum"
                    },
                    "network": {
                      "ip_address": "203.0.113.77",
                      "country": "US"
                    },
                    "context": {
                      "channel": "API"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/payment-integrity/reputation/check": {
      "post": {
        "operationId": "post_payment-integrity_v1_payment-integrity_reputation_check",
        "summary": "Look up the trust / risk reputation of one or more entities",
        "description": "Repository specification JIL Sovereign Payment Integrity Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/payment-integrity.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/payment-integrity.yaml. Returns the current reputation projection (reputation score, risk score, status, reason codes, last-seen) for each requested entity. Entities are users, devices, IPs, wallets, payment methods, creators, or hashed contact identifiers.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "examples": {
                "spec_1": {
                  "summary": "two_entities",
                  "value": {
                    "entities": [
                      {
                        "entity_type": "USER",
                        "entity_id": "u_bad"
                      },
                      {
                        "entity_type": "WALLET",
                        "entity_id": "0x8589427373d6d84e98730d7795d8f6f8731fda16"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/payment-integrity/bad-actors": {
      "post": {
        "operationId": "post_payment-integrity_v1_payment-integrity_bad-actors",
        "summary": "Record (upsert) a known bad actor in the reputation graph",
        "description": "Repository specification JIL Sovereign Payment Integrity Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/payment-integrity.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/payment-integrity.yaml. Adds or updates a bad-actor record keyed by entity type and id. The record feeds future attestations as a hard signal. Returns CREATED or UPDATED.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "examples": {
                "spec_1": {
                  "summary": "confirmed_fraud",
                  "value": {
                    "entity_type": "WALLET",
                    "entity_id": "0x8589427373d6d84e98730d7795d8f6f8731fda16",
                    "reason_code": "CONFIRMED_FRAUD",
                    "severity": "CRITICAL",
                    "source": "chargeback-ops"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/payment-integrity/creb": {
      "post": {
        "operationId": "post_payment-integrity_v1_payment-integrity_creb",
        "summary": "Assemble a Court Ready Evidence Bundle (CREB) for a payment-integrity case",
        "description": "Repository specification JIL Sovereign Payment Integrity Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/payment-integrity.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/payment-integrity.yaml. Queues a CREB for a confirmed-fraud, chargeback, sanctions, refund-abuse, or legal-response case. The bundle assembles the attestation record, the rule-execution trace, the evidence index, and a cryptographic chain of custody, seals it with a deterministic bundle hash, and anchors it on CourtChain under FRE 902(14). Returns 202 with a creb_id; the bundle is retrievable shortly after via GET /v1/payment-integrity/creb/{id}.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "examples": {
                "spec_1": {
                  "summary": "confirmed_fraud_creb",
                  "value": {
                    "attestation_id": "att_3f9c1d2e4b5a6c7d8e9f01",
                    "case_type": "CONFIRMED_FRAUD",
                    "requested_formats": [
                      "PDF",
                      "JSON"
                    ],
                    "requester": "siu-desk"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/attestyx/api/v1/settle": {
      "post": {
        "operationId": "post_attestyx_v1_attestyx_api_v1_settle",
        "summary": "Clear a settlement in one call (deterministic approved / denied / hold verdict)",
        "description": "Repository specification JIL Sovereign Attestyx Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/attestyx.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/attestyx.yaml. The main client endpoint. Runs sender + recipient credential checks and settlement-policy evaluation in parallel, stores the attestation, and on approval issues a finality receipt and records the metering fee. Emits a signed settlements.requested event so the fan-out check services produce sub-verdicts that the aggregator correlates into a court-portable bundle.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "examples": {
                "spec_1": {
                  "summary": "cross_border",
                  "value": {
                    "tx_id": "tx_88210",
                    "sender_id": "party_us_4471",
                    "sender_country": "US",
                    "recipient_id": "party_de_9930",
                    "recipient_country": "DE",
                    "amount_usd": 125000,
                    "corridor": "US-DE",
                    "client_id": "acme-treasury"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/attestyx/api/v1/attestations": {
      "post": {
        "operationId": "post_attestyx_v1_attestyx_api_v1_attestations",
        "summary": "Enqueue an attestation for async pipeline processing",
        "description": "Repository specification JIL Sovereign Attestyx Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/attestyx.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/attestyx.yaml. Inserts a pending attestation row and emits attestations.requested for the per-node Kafka worker. Returns 202 with a poll_url. Receipts become available once the pipeline drains.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/attestyx/api/v1/attestations/{attestationId}/rerun": {
      "post": {
        "operationId": "post_attestyx_v1_attestyx_api_v1_attestations_attestationId_rerun",
        "summary": "Re-run a prior attestation against the delta of still-unverified required checks",
        "description": "Repository specification JIL Sovereign Attestyx Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/attestyx.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/attestyx.yaml. Computes required_checks (caller override or vendor-declared) minus the checks that already passed on the latest run, bumps run_sequence, and emits the delta. Rejects with 400 if the delta is empty.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/attestyx/api/v1/engagements": {
      "post": {
        "operationId": "post_attestyx_v1_attestyx_api_v1_engagements",
        "summary": "Provision a per-customer engagement (returns a scoped API key once)",
        "description": "Repository specification JIL Sovereign Attestyx Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/attestyx.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/attestyx.yaml. Creates an engagement with a frozen snapshot of the LOB profile's T1/T2 check codes, T2 evidence packs, and T3 CREB template (engagement immutability boundary). Returns a scoped bearer API key exactly once; the server stores only its SHA-256 hash. Requires admin auth.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "examples": {
                "spec_1": {
                  "summary": "by_profile",
                  "value": {
                    "client_id": "state-mfcu-tx",
                    "lob_profile_id": "prof_medicaid_um",
                    "engagement_label": "TX MFCU 2026 retro PI",
                    "company_name": "Texas MFCU",
                    "billing_contact_email": "ops@example.gov"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/attestyx/api/v1/plans/{plan_id}/authorize": {
      "post": {
        "operationId": "post_attestyx_v1_attestyx_api_v1_plans_plan_id_authorize",
        "summary": "Authorize a subset of clusters for Tier 2 spend",
        "description": "Repository specification JIL Sovereign Attestyx Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/attestyx.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/attestyx.yaml. Customer approves specific clusters with a budget cap and an authorizer attestation. Requires the engagement-scoped bearer key (or admin).",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/attestyx/api/v1/plans/{plan_id}/crebs/{cluster_id}": {
      "post": {
        "operationId": "post_attestyx_v1_attestyx_api_v1_plans_plan_id_crebs_cluster_id",
        "summary": "Generate a Court Ready Evidence Bundle (CREB) for one cluster",
        "description": "Repository specification JIL Sovereign Attestyx Attestation API version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/attestyx.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/attestyx.yaml. Assembles and seals a CREB for the cluster (Merkle root, CourtChain anchor, SDV upload). Requires admin or the engagement-scoped bearer key for the plan's engagement.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/metering/consume": {
      "post": {
        "operationId": "post_metering_v1_metering_consume",
        "summary": "Consume one report from the customer's prepaid block (idempotent on artifact_sha256)",
        "description": "Repository specification JIL Sovereign Usage Metering & Billing version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/metering.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/metering.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/metering/cases": {
      "post": {
        "operationId": "post_metering_v1_metering_cases",
        "summary": "Open a CREB case (links the CourtChain anchor of the cryptographic CREB record)",
        "description": "Repository specification JIL Sovereign Usage Metering & Billing version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/metering.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/metering.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/metering/cases/{id}/agree": {
      "post": {
        "operationId": "post_metering_v1_metering_cases_id_agree",
        "summary": "Record the agreed lawsuit amount and bill creb_pct% of it",
        "description": "Repository specification JIL Sovereign Usage Metering & Billing version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/metering.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/metering.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/metering/cases/{id}/settle": {
      "post": {
        "operationId": "post_metering_v1_metering_cases_id_settle",
        "summary": "Record the settlement amount and bill creb_pct% of it",
        "description": "Repository specification JIL Sovereign Usage Metering & Billing version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/metering.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/metering.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/metering/tracker/{clientId}": {
      "get": {
        "operationId": "get_metering_v1_metering_tracker_clientId",
        "summary": "Per-customer site tracker (reports purchased/used/remaining + case status + CREB fee accrual)",
        "description": "Repository specification JIL Sovereign Usage Metering & Billing version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/metering.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/metering.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/courtchain/anchor": {
      "post": {
        "operationId": "post_courtchain_v1_courtchain_anchor",
        "summary": "Anchor a CREB record (bundle hash + metadata) to the JIL L1",
        "description": "Repository specification JIL Sovereign CourtChain (CREB Record Anchor) version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/courtchain.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/courtchain.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    },
    "/v1/courtchain/anchor/{id}": {
      "get": {
        "operationId": "get_courtchain_v1_courtchain_anchor_id",
        "summary": "Read back an anchored CREB record receipt",
        "description": "Repository specification JIL Sovereign CourtChain (CREB Record Anchor) version 2026.06.08. Live catalog endpoint. The API host returned HTTP 404 for /openapi/courtchain.yaml on 2026-10-21. The specification file is https://jilsovereign.com/openapi/courtchain.yaml. No additional specification text.",
        "responses": {
          "200": {
            "description": "See the specification file. A response is included below only when the file publishes an example."
          }
        }
      }
    }
  }
}
