{
  "openapi": "3.0.3",
  "info": {
    "title": "Regence Credit File Assembly \u00b7 local evaluation API",
    "version": "0.1.0",
    "description": "Independent module; no KYC/bank service required. Loopback-only fictional-data POC without institutional authentication. Not an Oracle/Finacle native contract."
  },
  "servers": [
    {
      "url": "http://127.0.0.1:8784"
    }
  ],
  "paths": {
    "/api/config": {
      "get": {
        "summary": "Module configuration; no KYC dependency",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        }
      }
    },
    "/api/cases": {
      "get": {
        "summary": "List locally stored cases",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        }
      },
      "post": {
        "summary": "Create an independent credit case",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": []
              }
            }
          }
        }
      }
    },
    "/api/sample": {
      "post": {
        "summary": "Load fictional sample evidence",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mismatch": {
                    "type": "boolean"
                  }
                },
                "required": []
              }
            }
          }
        }
      }
    },
    "/api/cases/{caseId}": {
      "get": {
        "summary": "Retrieve case, evidence metadata and history",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        }
      }
    },
    "/api/cases/{caseId}/details": {
      "post": {
        "summary": "Save officer-verified borrower and financial inputs",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "fields": {
                    "type": "object",
                    "properties": {
                      "borrower": {
                        "type": "string"
                      },
                      "registration": {
                        "type": "string"
                      },
                      "purpose": {
                        "type": "string"
                      },
                      "currency": {
                        "type": "string"
                      },
                      "period": {
                        "type": "string"
                      },
                      "amount": {
                        "type": "string"
                      },
                      "tenor": {
                        "type": "string"
                      },
                      "revenue": {
                        "type": "string"
                      },
                      "currentAssets": {
                        "type": "string"
                      },
                      "currentLiabilities": {
                        "type": "string"
                      },
                      "ebit": {
                        "type": "string"
                      },
                      "interest": {
                        "type": "string"
                      },
                      "debt": {
                        "type": "string"
                      },
                      "equity": {
                        "type": "string"
                      },
                      "operatingCash": {
                        "type": "string"
                      },
                      "debtService": {
                        "type": "string"
                      }
                    },
                    "required": []
                  },
                  "verified": {
                    "type": "boolean"
                  },
                  "dueDiligenceConfirmed": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "version",
                  "fields",
                  "verified"
                ]
              }
            }
          }
        }
      }
    },
    "/api/cases/{caseId}/config": {
      "post": {
        "summary": "Configure case evidence requirements; KYC reference is optional",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "required": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "application",
                        "due_diligence",
                        "financials",
                        "statements",
                        "supporting"
                      ]
                    }
                  },
                  "kycEnabled": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "version",
                  "required"
                ]
              }
            }
          }
        }
      }
    },
    "/api/cases/{caseId}/kyc-reference": {
      "post": {
        "summary": "Attach an officer-entered reference; not authenticated approval",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "reference": {
                    "type": "object",
                    "properties": {
                      "caseId": {
                        "type": "string"
                      },
                      "source": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "caseId",
                      "source"
                    ]
                  }
                },
                "required": [
                  "version",
                  "reference"
                ]
              }
            }
          }
        }
      }
    },
    "/api/cases/{caseId}/documents": {
      "post": {
        "summary": "Upload and locally extract evidence",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "node": {
                    "type": "string",
                    "enum": [
                      "application",
                      "due_diligence",
                      "financials",
                      "statements",
                      "supporting"
                    ]
                  },
                  "name": {
                    "type": "string"
                  },
                  "content": {
                    "type": "string",
                    "format": "byte",
                    "description": "Base64; decoded limit10MB. PDF/PNG/JPEG/TXT/CSV."
                  }
                },
                "required": [
                  "version",
                  "node",
                  "name",
                  "content"
                ]
              }
            }
          }
        }
      }
    },
    "/api/cases/{caseId}/documents/{documentId}": {
      "post": {
        "summary": "Confirm document review/reconciliation, or remove evidence",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "reviewed": {
                    "type": "boolean"
                  },
                  "note": {
                    "type": "string"
                  },
                  "remove": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "version"
                ]
              }
            }
          }
        }
      },
      "get": {
        "summary": "Download original evidence bytes",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        }
      }
    },
    "/api/cases/{caseId}/process": {
      "post": {
        "summary": "Compute deterministic checks, clear prior review and model draft",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "required": [
                  "version"
                ]
              }
            }
          }
        }
      }
    },
    "/api/cases/{caseId}/review": {
      "post": {
        "summary": "Record human disposition; acceptance blocked by findings",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "reviewer": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 100
                  },
                  "outcome": {
                    "type": "string",
                    "enum": [
                      "accepted",
                      "further_evidence",
                      "escalated"
                    ]
                  },
                  "note": {
                    "type": "string",
                    "minLength": 15,
                    "maxLength": 2000
                  }
                },
                "required": [
                  "version",
                  "reviewer",
                  "outcome",
                  "note"
                ]
              }
            }
          }
        }
      }
    },
    "/api/cases/{caseId}/advisory": {
      "post": {
        "summary": "Explicit optional loopback model draft; no change to checks or approval",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "question": {
                    "type": "string",
                    "enum": [
                      "missing",
                      "ratios",
                      "memo"
                    ]
                  }
                },
                "required": [
                  "version",
                  "question"
                ]
              }
            }
          }
        }
      }
    },
    "/api/cases/{caseId}/memo": {
      "get": {
        "summary": "Download printable HTML memorandum",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        }
      }
    },
    "/api/cases/{caseId}/export": {
      "get": {
        "summary": "Download ZIP of memorandum, record and original evidence",
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Case/config/list or downloadable file; create returns201."
          },
          "201": {
            "description": "Created case/sample."
          },
          "400": {
            "description": "Invalid body, blocked review, unsupported/unconfigured adapter or extraction error."
          },
          "403": {
            "description": "POST requires matching browser Origin."
          },
          "404": {
            "description": "Unknown case/document/path."
          },
          "409": {
            "description": "Case version changed; reload before retry."
          },
          "503": {
            "description": "Service/extraction/model unavailable."
          }
        }
      }
    },
    "/api/cases/{caseId}/agent": {
      "post": {
        "summary": "Start read-only tool-selecting credit evidence agent",
        "description": "Requires fictional=true and current case version. Returns jobId. No approval or bank write tools.",
        "responses": {
          "202": {
            "description": "Agent queued"
          },
          "409": {
            "description": "Stale case version"
          }
        },
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/api/cases/{caseId}/agent/{jobId}": {
      "get": {
        "summary": "Poll case-scoped agent events and advisory draft",
        "responses": {
          "200": {
            "description": "RUNNING, COMPLETE, FAILED or STALE"
          }
        },
        "parameters": [
          {
            "name": "caseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "jobId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    }
  }
}