openapi: 3.0.3
info: { title: Financial API, version: 1.0.0 }
servers: [ { url: https://your-domain.com/api/v1 } ]
tags: [ { name: Financial } ]
security: [ { bearerAuth: [] } ]

paths:
  /financial/report:
    get:
      tags: [Financial]
      summary: Get financial report data
      parameters:
        - in: query
          name: date_from
          schema: { type: string, format: date }
        - in: query
          name: date_to
          schema: { type: string, format: date }
        - in: query
          name: school_year
          schema: { type: string }
      responses:
        "200": { description: Report data }

  /financial/unpaid-parents:
    get:
      tags: [Financial]
      summary: List unpaid parents with balances
      parameters:
        - in: query
          name: page
          schema: { type: integer, default: 1 }
        - in: query
          name: per_page
          schema: { type: integer, default: 20 }
      responses:
        "200": { description: Unpaid parents list }