{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ibanforge/main/json-schema/ibanforge-stats-overview-schema.json",
  "title": "StatsOverview",
  "x-generated": "2026-09-25",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ibanforge-api-keys-api-openapi.yml#/components/schemas/StatsOverview",
  "type": "object",
  "required": [
    "total_operations",
    "by_type",
    "total_revenue_usdc",
    "top_countries",
    "last_7_days"
  ],
  "properties": {
    "total_operations": {
      "type": "integer"
    },
    "by_type": {
      "type": "object",
      "properties": {
        "iban_validate": {
          "type": "object",
          "properties": {
            "total": {
              "type": "integer"
            },
            "valid_count": {
              "type": "integer"
            },
            "success_rate": {
              "type": "number"
            }
          }
        },
        "iban_batch": {
          "type": "object",
          "properties": {
            "total": {
              "type": "integer"
            },
            "valid_count": {
              "type": "integer"
            },
            "success_rate": {
              "type": "number"
            }
          }
        },
        "bic_lookup": {
          "type": "object",
          "properties": {
            "total": {
              "type": "integer"
            },
            "found_count": {
              "type": "integer"
            },
            "hit_rate": {
              "type": "number"
            }
          }
        }
      }
    },
    "total_revenue_usdc": {
      "type": "number",
      "deprecated": true,
      "description": "Deprecated alias for total_revenue_attempted_usdc. Use /admin/revenue for on-chain settled USDC."
    },
    "total_revenue_attempted_usdc": {
      "type": "number",
      "description": "SUM of revenue_usdc in daily_stats. Reflects x402 calls that PASSED the payment middleware verify step, NOT a confirmation of on-chain settlement. For settled USDC see /admin/revenue."
    },
    "revenue_note": {
      "type": "string"
    },
    "top_countries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string"
          },
          "count": {
            "type": "integer"
          }
        }
      }
    },
    "last_7_days": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "total": {
            "type": "integer"
          },
          "revenue": {
            "type": "number"
          }
        }
      }
    }
  }
}