# Get top clubs by educational awards ratio

`GET /api/reports/top-educational-awards-ratio`

Retrieve clubs with the highest ratio of educational awards to members

**Query parameters**

- `district` (string, optional, default 74): District to rank; defaults to 74
- `fiscalYear` (string, optional): Fiscal year (YYYY-YYYY); defaults to the current fiscal year
- `date` (date, optional): Rank as of the fiscal month this date falls in (YYYY-MM-DD)
- `division` (string, optional): Only clubs in this division
- `area` (string, optional): Only clubs in this area
- `minBase` (integer, optional, default 1): Smallest July 1 member base a club needs to be ranked
- `minAwards` (integer, optional, default 1): Fewest educational awards a club needs to be ranked
- `limit` (integer, optional, default 10): Number of top clubs to return (default: 10)

**Returns**

- `data` (array of objects)
  - `rank` (integer)
  - `club_number` (string)
  - `club_name` (string)
  - `division` (string)
  - `area` (string)
  - `educational_awards` (integer)
  - `july_1_base` (number)
  - `ratio` (number)
  - `awards_breakdown` (object)
    - `level_1s` (number)
    - `level_2s` (number)
    - `additional_level_2s` (number)
    - `level_3s` (number)
    - `level_4s` (number)
    - `additional_level_4s` (number)
- `summary` (object)
  - `total_clubs_analyzed` (integer)
  - `total_clubs_returned` (integer)
  - `analysis_date` (date)
  - `overall_statistics` (object)
  - `top_performer` (nullable object)
  - `division_summary` (array of objects)
- `filters` (object)
- `timestamp` (timestamp)

**Errors**

- `422`: A path or query parameter has an invalid value
- `500`: Internal server error

**Example request**

```bash
curl "https://tm-api.devinpearson.me/api/reports/top-educational-awards-ratio"
```

**Example response**

```json
{
  "data": [
    {
      "rank": 0,
      "club_number": "113",
      "club_name": "Example Toastmasters Club",
      "division": "A",
      "area": "01",
      "educational_awards": 0,
      "july_1_base": 0,
      "ratio": 0,
      "awards_breakdown": {
        "level_1s": 0,
        "level_2s": 0,
        "additional_level_2s": 0,
        "level_3s": 0,
        "level_4s": 0,
        "additional_level_4s": 0
      }
    }
  ],
  "summary": {
    "total_clubs_analyzed": 0,
    "total_clubs_returned": 0,
    "analysis_date": "2026-11-19",
    "overall_statistics": {},
    "top_performer": {},
    "division_summary": [
      {}
    ]
  },
  "filters": {},
  "timestamp": "2026-11-19T04:30:00.000Z"
}
```
