blocks-transformer/response_schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "application_id": {
      "type": "string",
      "description": "Unique identifier for the application"
    },
    "prediction": {
      "type": "number",
      "description": "Model's predicted probability score"
    },
    "grade": {
      "type": "string",
      "description": "HD Model Grade"
    },
    "reason_codes": {
      "type": "array",
      "description": "List of reason codes explaining the model decision",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": ["string", "null"],
            "description": "Feature or score reason code"
          },
          "rank": {
            "type": ["string", "null"],
            "description": "Rank of importance (1 to 4)"
          },
          "description": {
            "type": ["string", "null"],
            "description": "Human-readable explanation for the reason"
          }
        },
        "required": ["code", "rank", "description"]
      },
      "minItems": 1,
      "maxItems": 4
    }
  },
  "required": [
    "application_id",
    "prediction",
    "grade",
    "reason_codes"
  ]
}