# District

A district is a group of divisions, led by a District Director. It is identified by a number, except F for Founders District and U for clubs that belong to no district.

The district dashboard reports the district's totals and recognition goals, its divisions with their areas and clubs, its history month by month and its prospective clubs. Other endpoints compare a district with the same month last year and rank its clubs by their history.

Base URL: `https://tm-api.devinpearson.me`

## Compare a district's fiscal month with the same month last year

`GET /api/district/{district}/year-comparison`

Returns the district summary figures, totals over the clubs for the district and each division, and every club's figures for a fiscal month and for the same fiscal month of the previous fiscal year. Both sides are monthly snapshots: last year's is that month's final report, this year's the latest report so far.

**Path parameters**

- `district` (string, required): District number/code.

**Query parameters**

- `fiscalYear` (string, optional): Fiscal year to compare. Defaults to the district's latest reported fiscal year.
- `fiscalMonth` (integer, optional): Fiscal month (1 = July) to compare. Defaults to the latest reported month in the fiscal year.

**Returns**

- `success` (enum) One of: `true`.
- `data` (object): A district's reported fiscal month against the same fiscal month last year, from the monthly snapshots. Last year's side is that month's final report; this year's is the latest report so far, so report_date says which day each side reflects.
  - `district` (string)
  - `fiscal_year` (string)
  - `fiscal_month` (integer): Fiscal month (1 = July).
  - `previous_fiscal_year` (string)
  - `report_date` (nullable date): The report day this year's figures reflect.
  - `previous_report_date` (nullable date): The report day last year's figures reflect; null when no clubs were reported then.
  - `summary` (object or nullable enum): District summary figures; null without a district summary this month.
    - `current` (object): The district summary figures for one fiscal month.
      - `paid_clubs` (integer)
      - `paid_club_base` (integer)
      - `active_clubs` (integer)
      - `payments_to_date` (integer)
      - `payment_base` (integer)
      - `october_payments` (integer)
      - `april_payments` (integer)
      - `new_payments` (integer)
      - `late_payments` (integer)
      - `charter_payments` (integer)
      - `distinguished_clubs` (integer)
    - `previous` (object or nullable enum): The same month last year; null when no district summary was reported then.
      - `paid_clubs` (integer)
      - `paid_club_base` (integer)
      - `active_clubs` (integer)
      - `payments_to_date` (integer)
      - `payment_base` (integer)
      - `october_payments` (integer)
      - `april_payments` (integer)
      - `new_payments` (integer)
      - `late_payments` (integer)
      - `charter_payments` (integer)
      - `distinguished_clubs` (integer)
    - `change` (object or nullable enum): This year's figures minus last year's; null when previous is.
      - `paid_clubs` (integer)
      - `paid_club_base` (integer)
      - `active_clubs` (integer)
      - `payments_to_date` (integer)
      - `payment_base` (integer)
      - `october_payments` (integer)
      - `april_payments` (integer)
      - `new_payments` (integer)
      - `late_payments` (integer)
      - `charter_payments` (integer)
      - `distinguished_clubs` (integer)
  - `clubs` (object)
    - `current` (object): A district's or division's totals over its clubs for one fiscal month. Suspended clubs count only as suspended.
      - `clubs` (integer): Clubs that aren't suspended.
      - `suspended_clubs` (integer)
      - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
      - `distinguished_clubs` (integer)
      - `member_base` (integer): Membership base, summed over the clubs.
      - `active_members` (integer)
      - `net_growth` (integer): active_members minus member_base.
      - `clubs_under_8_members` (integer): Clubs below the 8 members needed for good standing.
      - `clubs_at_or_above_base` (integer): Clubs with at least max(base, 8) members.
      - `goals_met` (integer): DCP goals met, summed over the clubs.
      - `clubs_with_no_goals` (integer)
      - `clubs_with_5_plus_goals` (integer)
      - `level_1s` (integer)
      - `level_2s` (integer): Level 2s plus additional Level 2s.
      - `level_3s` (integer)
      - `level_4s` (integer): Level 4s, path completions and DTMs, plus additional ones.
      - `educational_awards` (integer)
      - `new_members` (integer): New and additional new members counted for the DCP.
      - `clubs_with_4_officers_trained_round_1` (integer)
      - `csp_submitted` (integer): Clubs that submitted a Club Success Plan.
    - `previous` (object or nullable enum): The same month last year; null when no club was reported then.
      - `clubs` (integer): Clubs that aren't suspended.
      - `suspended_clubs` (integer)
      - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
      - `distinguished_clubs` (integer)
      - `member_base` (integer): Membership base, summed over the clubs.
      - `active_members` (integer)
      - `net_growth` (integer): active_members minus member_base.
      - `clubs_under_8_members` (integer): Clubs below the 8 members needed for good standing.
      - `clubs_at_or_above_base` (integer): Clubs with at least max(base, 8) members.
      - `goals_met` (integer): DCP goals met, summed over the clubs.
      - `clubs_with_no_goals` (integer)
      - `clubs_with_5_plus_goals` (integer)
      - `level_1s` (integer)
      - `level_2s` (integer): Level 2s plus additional Level 2s.
      - `level_3s` (integer)
      - `level_4s` (integer): Level 4s, path completions and DTMs, plus additional ones.
      - `educational_awards` (integer)
      - `new_members` (integer): New and additional new members counted for the DCP.
      - `clubs_with_4_officers_trained_round_1` (integer)
      - `csp_submitted` (integer): Clubs that submitted a Club Success Plan.
    - `change` (object or nullable enum): This year's figures minus last year's; null when previous is.
      - `clubs` (integer): Clubs that aren't suspended.
      - `suspended_clubs` (integer)
      - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
      - `distinguished_clubs` (integer)
      - `member_base` (integer): Membership base, summed over the clubs.
      - `active_members` (integer)
      - `net_growth` (integer): active_members minus member_base.
      - `clubs_under_8_members` (integer): Clubs below the 8 members needed for good standing.
      - `clubs_at_or_above_base` (integer): Clubs with at least max(base, 8) members.
      - `goals_met` (integer): DCP goals met, summed over the clubs.
      - `clubs_with_no_goals` (integer)
      - `clubs_with_5_plus_goals` (integer)
      - `level_1s` (integer)
      - `level_2s` (integer): Level 2s plus additional Level 2s.
      - `level_3s` (integer)
      - `level_4s` (integer): Level 4s, path completions and DTMs, plus additional ones.
      - `educational_awards` (integer)
      - `new_members` (integer): New and additional new members counted for the DCP.
      - `clubs_with_4_officers_trained_round_1` (integer)
      - `csp_submitted` (integer): Clubs that submitted a Club Success Plan.
  - `divisions` (array of objects)
    - `key` (string): Division letter.
    - `current` (object): A district's or division's totals over its clubs for one fiscal month. Suspended clubs count only as suspended.
      - `clubs` (integer): Clubs that aren't suspended.
      - `suspended_clubs` (integer)
      - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
      - `distinguished_clubs` (integer)
      - `member_base` (integer): Membership base, summed over the clubs.
      - `active_members` (integer)
      - `net_growth` (integer): active_members minus member_base.
      - `clubs_under_8_members` (integer): Clubs below the 8 members needed for good standing.
      - `clubs_at_or_above_base` (integer): Clubs with at least max(base, 8) members.
      - `goals_met` (integer): DCP goals met, summed over the clubs.
      - `clubs_with_no_goals` (integer)
      - `clubs_with_5_plus_goals` (integer)
      - `level_1s` (integer)
      - `level_2s` (integer): Level 2s plus additional Level 2s.
      - `level_3s` (integer)
      - `level_4s` (integer): Level 4s, path completions and DTMs, plus additional ones.
      - `educational_awards` (integer)
      - `new_members` (integer): New and additional new members counted for the DCP.
      - `clubs_with_4_officers_trained_round_1` (integer)
      - `csp_submitted` (integer): Clubs that submitted a Club Success Plan.
    - `previous` (object or nullable enum): The same month last year; null when no club was reported then.
      - `clubs` (integer): Clubs that aren't suspended.
      - `suspended_clubs` (integer)
      - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
      - `distinguished_clubs` (integer)
      - `member_base` (integer): Membership base, summed over the clubs.
      - `active_members` (integer)
      - `net_growth` (integer): active_members minus member_base.
      - `clubs_under_8_members` (integer): Clubs below the 8 members needed for good standing.
      - `clubs_at_or_above_base` (integer): Clubs with at least max(base, 8) members.
      - `goals_met` (integer): DCP goals met, summed over the clubs.
      - `clubs_with_no_goals` (integer)
      - `clubs_with_5_plus_goals` (integer)
      - `level_1s` (integer)
      - `level_2s` (integer): Level 2s plus additional Level 2s.
      - `level_3s` (integer)
      - `level_4s` (integer): Level 4s, path completions and DTMs, plus additional ones.
      - `educational_awards` (integer)
      - `new_members` (integer): New and additional new members counted for the DCP.
      - `clubs_with_4_officers_trained_round_1` (integer)
      - `csp_submitted` (integer): Clubs that submitted a Club Success Plan.
    - `change` (object or nullable enum): This year's figures minus last year's; null when previous is.
      - `clubs` (integer): Clubs that aren't suspended.
      - `suspended_clubs` (integer)
      - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
      - `distinguished_clubs` (integer)
      - `member_base` (integer): Membership base, summed over the clubs.
      - `active_members` (integer)
      - `net_growth` (integer): active_members minus member_base.
      - `clubs_under_8_members` (integer): Clubs below the 8 members needed for good standing.
      - `clubs_at_or_above_base` (integer): Clubs with at least max(base, 8) members.
      - `goals_met` (integer): DCP goals met, summed over the clubs.
      - `clubs_with_no_goals` (integer)
      - `clubs_with_5_plus_goals` (integer)
      - `level_1s` (integer)
      - `level_2s` (integer): Level 2s plus additional Level 2s.
      - `level_3s` (integer)
      - `level_4s` (integer): Level 4s, path completions and DTMs, plus additional ones.
      - `educational_awards` (integer)
      - `new_members` (integer): New and additional new members counted for the DCP.
      - `clubs_with_4_officers_trained_round_1` (integer)
      - `csp_submitted` (integer): Clubs that submitted a Club Success Plan.
  - `club_list` (array of objects): Every club reported in either year.
    - `club_number` (string): Canonical club number, without leading zeros.
    - `club_name` (nullable string)
    - `current` (nullable object): A club's figures for the month in one year.
      - `division` (nullable string)
      - `area` (nullable string)
      - `club_status` (nullable string)
      - `member_base` (integer)
      - `active_members` (integer)
      - `goals_met` (integer)
      - `educational_awards` (integer)
    - `previous` (nullable object): A club's figures for the month in one year.
      - `division` (nullable string)
      - `area` (nullable string)
      - `club_status` (nullable string)
      - `member_base` (integer)
      - `active_members` (integer)
      - `goals_met` (integer)
      - `educational_awards` (integer)
- `timestamp` (timestamp)

**Errors**

- `404`: No clubs reported for the district in that month.
- `422`: Invalid district, fiscalYear, fiscalMonth, or an unsupported query parameter.
- `500`: Internal server error

**Example request**

```bash
curl "https://tm-api.devinpearson.me/api/district/74/year-comparison"
```

**Example response**

```json
{
  "success": true,
  "data": {
    "district": "74",
    "fiscal_year": "2026-2027",
    "fiscal_month": 5,
    "previous_fiscal_year": "2025-2026",
    "report_date": "2026-11-19",
    "previous_report_date": "2026-11-19",
    "summary": {
      "current": {
        "paid_clubs": 0,
        "paid_club_base": 0,
        "active_clubs": 0,
        "payments_to_date": 0,
        "payment_base": 0,
        "october_payments": 0,
        "april_payments": 0,
        "new_payments": 0,
        "late_payments": 0,
        "charter_payments": 0,
        "distinguished_clubs": 0
      },
      "previous": {
        "paid_clubs": 0,
        "paid_club_base": 0,
        "active_clubs": 0,
        "payments_to_date": 0,
        "payment_base": 0,
        "october_payments": 0,
        "april_payments": 0,
        "new_payments": 0,
        "late_payments": 0,
        "charter_payments": 0,
        "distinguished_clubs": 0
      },
      "change": {
        "paid_clubs": 0,
        "paid_club_base": 0,
        "active_clubs": 0,
        "payments_to_date": 0,
        "payment_base": 0,
        "october_payments": 0,
        "april_payments": 0,
        "new_payments": 0,
        "late_payments": 0,
        "charter_payments": 0,
        "distinguished_clubs": 0
      }
    },
    "clubs": {
      "current": {
        "clubs": 0,
        "suspended_clubs": 0,
        "paid_clubs": 0,
        "distinguished_clubs": 0,
        "member_base": 0,
        "active_members": 0,
        "net_growth": 0,
        "clubs_under_8_members": 0,
        "clubs_at_or_above_base": 0,
        "goals_met": 0,
        "clubs_with_no_goals": 0,
        "clubs_with_5_plus_goals": 0,
        "level_1s": 0,
        "level_2s": 0,
        "level_3s": 0,
        "level_4s": 0,
        "educational_awards": 0,
        "new_members": 0,
        "clubs_with_4_officers_trained_round_1": 0,
        "csp_submitted": 0
      },
      "previous": {
        "clubs": 0,
        "suspended_clubs": 0,
        "paid_clubs": 0,
        "distinguished_clubs": 0,
        "member_base": 0,
        "active_members": 0,
        "net_growth": 0,
        "clubs_under_8_members": 0,
        "clubs_at_or_above_base": 0,
        "goals_met": 0,
        "clubs_with_no_goals": 0,
        "clubs_with_5_plus_goals": 0,
        "level_1s": 0,
        "level_2s": 0,
        "level_3s": 0,
        "level_4s": 0,
        "educational_awards": 0,
        "new_members": 0,
        "clubs_with_4_officers_trained_round_1": 0,
        "csp_submitted": 0
      },
      "change": {
        "clubs": 0,
        "suspended_clubs": 0,
        "paid_clubs": 0,
        "distinguished_clubs": 0,
        "member_base": 0,
        "active_members": 0,
        "net_growth": 0,
        "clubs_under_8_members": 0,
        "clubs_at_or_above_base": 0,
        "goals_met": 0,
        "clubs_with_no_goals": 0,
        "clubs_with_5_plus_goals": 0,
        "level_1s": 0,
        "level_2s": 0,
        "level_3s": 0,
        "level_4s": 0,
        "educational_awards": 0,
        "new_members": 0,
        "clubs_with_4_officers_trained_round_1": 0,
        "csp_submitted": 0
      }
    },
    "divisions": [
      {
        "key": "string",
        "current": {
          "clubs": 0,
          "suspended_clubs": 0,
          "paid_clubs": 0,
          "distinguished_clubs": 0,
          "member_base": 0,
          "active_members": 0,
          "net_growth": 0,
          "clubs_under_8_members": 0,
          "clubs_at_or_above_base": 0,
          "goals_met": 0,
          "clubs_with_no_goals": 0,
          "clubs_with_5_plus_goals": 0,
          "level_1s": 0,
          "level_2s": 0,
          "level_3s": 0,
          "level_4s": 0,
          "educational_awards": 0,
          "new_members": 0,
          "clubs_with_4_officers_trained_round_1": 0,
          "csp_submitted": 0
        },
        "previous": {
          "clubs": 0,
          "suspended_clubs": 0,
          "paid_clubs": 0,
          "distinguished_clubs": 0,
          "member_base": 0,
          "active_members": 0,
          "net_growth": 0,
          "clubs_under_8_members": 0,
          "clubs_at_or_above_base": 0,
          "goals_met": 0,
          "clubs_with_no_goals": 0,
          "clubs_with_5_plus_goals": 0,
          "level_1s": 0,
          "level_2s": 0,
          "level_3s": 0,
          "level_4s": 0,
          "educational_awards": 0,
          "new_members": 0,
          "clubs_with_4_officers_trained_round_1": 0,
          "csp_submitted": 0
        },
        "change": {
          "clubs": 0,
          "suspended_clubs": 0,
          "paid_clubs": 0,
          "distinguished_clubs": 0,
          "member_base": 0,
          "active_members": 0,
          "net_growth": 0,
          "clubs_under_8_members": 0,
          "clubs_at_or_above_base": 0,
          "goals_met": 0,
          "clubs_with_no_goals": 0,
          "clubs_with_5_plus_goals": 0,
          "level_1s": 0,
          "level_2s": 0,
          "level_3s": 0,
          "level_4s": 0,
          "educational_awards": 0,
          "new_members": 0,
          "clubs_with_4_officers_trained_round_1": 0,
          "csp_submitted": 0
        }
      }
    ],
    "club_list": [
      {
        "club_number": "113",
        "club_name": "Example Toastmasters Club",
        "current": {
          "division": "A",
          "area": "01",
          "club_status": "string",
          "member_base": 0,
          "active_members": 0,
          "goals_met": 0,
          "educational_awards": 0
        },
        "previous": {
          "division": "A",
          "area": "01",
          "club_status": "string",
          "member_base": 0,
          "active_members": 0,
          "goals_met": 0,
          "educational_awards": 0
        }
      }
    ]
  },
  "timestamp": "2026-11-19T04:30:00.000Z"
}
```

## Get ranked district club historical health

`GET /api/district/{district}/clubs/historical-health`

Returns one complete, single district club-roster snapshot, ordered by finite historical-health score descending. Equal scores are ordered by canonical club number ascending and receive unique 1-based ordinal ranks; null scores are last and unranked. fiscalYear and fiscalMonth select only the current roster snapshot and never filter, cap, or otherwise alter the completed history selected by each reusable analysis. A known district snapshot with no clubs returns 200 and an empty clubs list. Only fiscalYear and fiscalMonth are supported query parameters; latest and unknown query parameters are rejected.

**Path parameters**

- `district` (string, required): District number/code.

**Query parameters**

- `fiscalYear` (string, optional): Roster snapshot fiscal year. Defaults using the district fiscal-year selection rules.
- `fiscalMonth` (integer, optional): Roster snapshot fiscal month. When omitted, the latest eligible month in the resolved fiscal year is selected.

**Returns**

- `success` (enum) One of: `true`.
- `fiscal_year` (string): Fiscal year of the one resolved district roster snapshot.
- `fiscal_month` (integer): Fiscal month of the one resolved district roster snapshot.
- `data` (object)
  - `district` (string)
  - `region` (nullable string)
  - `clubs` (array of objects): Complete resolved roster, including clubs with missing history. A known district snapshot with no clubs returns an empty array.
    - `rank` (nullable integer): Unique 1-based ordinal rank for a finite analysis score; null for unranked null-score clubs.
    - `club_number` (string): Canonical club number without leading zeroes.
    - `club_name` (nullable string)
    - `division` (nullable string)
    - `area` (nullable string)
    - `club_status` (nullable string)
    - `active_members` (nullable number)
    - `distinguished_status` (nullable string)
    - `historical_health_analysis` (object): Reusable completed-programme-year health analysis. It excludes the current and future fiscal years, considers at most five eligible years, and never changes the current club_health_score. The weighted score, recent Distinguished-history class, and membership-risk trajectory answer separate questions.
      - `schema_version` (enum) One of: `1.0`.
      - `config_version` (string): Version of the historical-health calculation configuration. Configuration 2.0 uses a 25-member default sustainability threshold and independent recent-award classification.
      - `status` (enum): `no_history` is the deterministic empty DTO. `insufficient_data` lacks the required scored-component coverage. One of: `available`, `limited_history`, `insufficient_data`, `no_history`.
      - `score` (nullable number): Explainable weighted five-year diagnostic score. It does not determine historical_class and can therefore be lower for a club classified A from recent Distinguished outcomes. Null for no history or insufficient component coverage.
      - `historical_class` (nullable enum): Recent Distinguished-performance class, independent of the weighted score. It is derived from the latest up-to-three completed programme years with recognized award semantics: A is regularly President's/Smedley Distinguished, B is frequently Distinguished or better, C is occasional Distinguished, and D is rare/never Distinguished. Null only when the classification window has insufficient recognized award evidence. One of: `A`, `B`, `C`, `D`.
      - `trajectory` (nullable enum): Membership-risk trajectory. Classification uses actual year-end memberships capped at the configured 25-member sustainability threshold, so changes wholly above that threshold are neutral; raw, uncapped trend metrics remain in trend. Null until at least two observed memberships exist. One of: `Growing`, `Stable`, `Declining`, `Recovering`, `Volatile`.
      - `profile` (nullable enum): Combined independently derived historical class and benchmark-adjusted trajectory; it does not depend on score. Null when either historical_class or trajectory is unavailable. One of: `Healthy & Growing`, `Healthy & Stable`, `Strong but Declining`, `Recovering`, `Volatile`, `Long-Term At Risk`.
      - `years_analyzed` (integer)
      - `period` (object)
        - `requested_max_years` (enum) One of: `5`.
        - `completed_through` (string): Most recent eligible completed fiscal year.
        - `earliest` (nullable string)
        - `latest` (nullable string)
        - `missing_years` (array of strings): Gaps between selected observed fiscal years; no data is inferred for them.
      - `trend` (object)
        - `membership_change_percent_per_year` (nullable number): Raw annualized year-end membership change percentage using actual, uncapped memberships. This metric is context only and is not the trajectory-classification rate.
        - `membership_volatility` (nullable number): Raw coefficient of variation of observed actual, uncapped year-end membership. The benchmark-adjusted volatility used for trajectory classification is exposed in explainability evidence.
        - `latest_year_end_membership` (nullable number): Latest actual, uncapped year-end membership.
      - `yearly` (array of objects)
        - `fiscal_year` (string)
        - `year_end_membership` (nullable number): Actual reported year-end membership; this value is never capped.
        - `membership_change` (nullable number): Actual year-end minus membership base; this raw value is never benchmark-adjusted.
        - `membership_change_percent` (nullable number): Actual raw membership change percentage; this value is never benchmark-adjusted.
        - `at_or_above_20` (nullable boolean, deprecated): Legacy compatibility flag for the former 20-member threshold. Use at_or_above_healthy_membership for the configured sustainability threshold.
        - `at_or_above_healthy_membership` (nullable boolean): Sustainability flag: whether actual year-end membership meets the configured healthy-membership threshold (25 by default in configuration 2.0).
        - `dcp_goals` (nullable number)
        - `distinguished_status` (nullable string)
        - `officer_training_round_1` (nullable number)
        - `officer_training_round_2` (nullable number)
        - `score` (nullable number): Per-year score when at least three scored components including membership sustainability are available.
      - `explainability` (object)
        - `components` (array of objects): Stable component-key detail supporting the diagnostic score. Recent-award classification and benchmark-adjusted trajectory evidence are top-level explainability fields.
          - `key` (enum) One of: `membership_sustainability`, `growth`, `dcp_goals`, `distinguished_status`, `officer_training`.
          - `configured_weight` (number): Configured percentage weight.
          - `effective_weight` (number): Percentage weight after redistribution across observed components.
          - `score` (nullable number): Component score from 0 through 100; null when no usable observations exist.
          - `contribution` (number): Weighted contribution to the historical score, or zero when missing.
          - `observations` (integer)
          - `status` (enum) One of: `scored`, `missing`.
          - `formula` (string)
          - `evidence` (object): Component-specific primitive evidence used by the diagnostic-score calculation, such as the configured sustainability threshold and safe membership declines neutralized for growth scoring. Each value is a number, string, boolean, or null. Recent-award classification and benchmark-adjusted trajectory evidence are separate top-level explainability fields.
        - `recent_award_classification` (object): Top-level evidence for the independent historical_class calculation from recent recognized awards.
          - `classification_window_fiscal_years` (array of strings): Fiscal years in the most recent up-to-three completed-programme-year classification window, ordered oldest to newest.
          - `window_size` (integer): Number of completed programme years in the classification window.
          - `required_frequency` (integer): Recognized award values required to classify the window: ceil(window_size * 2 / 3).
          - `known_years` (integer): Years in the classification window with recognized award semantics, including explicit no-award values.
          - `high_distinguished_years` (integer): Recognized President's Distinguished or Smedley Distinguished years in the classification window.
          - `distinguished_years` (integer): Recognized Distinguished-or-better years in the classification window.
          - `selected_class_rule` (nullable string): Rule that selected the A-D historical class; null when recognized award evidence is insufficient.
        - `benchmark_adjusted_trajectory` (object): Top-level evidence for membership-risk trajectory classification using the benchmark-adjusted membership series.
          - `healthy_membership_threshold` (number): Configured healthy-membership threshold used to cap memberships for trajectory classification.
          - `benchmark_adjusted_membership_series` (array of objects): Observed completed-year memberships after capping each value at healthy_membership_threshold, ordered oldest to newest.
            - `fiscal_year` (string): Completed programme year for this trajectory observation.
            - `membership` (number): Year-end membership capped at healthy_membership_threshold for trajectory classification.
          - `benchmark_adjusted_change_percent_per_year` (nullable number): Average gap-aware annualized change percentage calculated from the benchmark-adjusted membership series; null when no valid transition exists.
          - `benchmark_adjusted_membership_volatility` (nullable number): Coefficient of variation of the benchmark-adjusted membership series; null when it cannot be calculated.
          - `above_threshold_movements_neutralized` (integer): Count of adjacent observed movements whose actual endpoints both met the healthy-membership threshold and therefore become neutral after capping.
        - `reasons` (array of strings): Human-readable calculation disclosures, including why score and historical class may differ, benchmark-adjusted trajectory inputs, and safe declines neutralized at or above the sustainability threshold.
      - `data_quality` (object)
        - `confidence` (enum) One of: `high`, `medium`, `low`, `none`.
        - `excluded_years` (array of objects)
          - `fiscal_year` (string)
          - `reason` (string)
        - `missing_metrics` (array of strings)
        - `warnings` (array of strings)
    - `club_outlook` (object): Which of five groups the club is in: doing_well, improving, steady, declining or definite_worry. From October the current paid count decides first: under 8 paid members is definite_worry, and keeping under 60% of last June's members is declining. Otherwise the 0-100 health score for the last completed programme year decides: 70+ is doing_well; a score up 10+ on the two years before, or more paid members than last June, is improving; anything else is steady. Before October, a score under 40 is definite_worry. Back-tested on October 2024 and 2025: closed or under 8 members by the next June was 1% for doing_well, 8% improving, 8% steady, 6% declining (median -6 members) and 55% definite_worry.
      - `version` (enum) One of: `1`.
      - `category` (nullable enum): Null when the club has no completed year and isn't under 8 paid members after October. One of: `doing_well`, `improving`, `steady`, `declining`, `definite_worry`, `null`.
      - `label` (nullable string)
      - `basis` (enum): renewals once October renewals are in; history before that. One of: `renewals`, `history`.
      - `health_score` (nullable number): 100 minus points for the last completed programme year.
      - `health_score_change` (nullable number): Health score minus the average of the two programme years before it.
      - `scored_year` (nullable string)
      - `paid_members` (nullable number)
      - `last_year_end_members` (nullable number)
      - `retention` (nullable number): Paid members now as a share of last year end's, from October.
      - `reasons` (array of strings): Why the club is in its group, most important first.
      - `points` (array of objects): Points taken off 100 for the scored year, largest first.
        - `key` (enum) One of: `members`, `dcp_goals`, `new_members`, `officer_training`, `renewals`, `members_lost`, `distinguished`.
        - `points` (number)
        - `reason` (string)
- `summary` (object)
  - `total_clubs` (integer)
  - `ranked_clubs` (integer)
  - `unranked_clubs` (integer)
  - `analysis_status_counts` (object)
    - `available` (integer)
    - `limited_history` (integer)
    - `insufficient_data` (integer)
    - `no_history` (integer)
- `metadata` (object)
  - `analysis_current_fiscal_year` (string): Current fiscal year passed to each completed-programme-year analysis; it is independent of the roster snapshot filters.
  - `ranking` (object): Finite scores sort descending. Equal scores use canonical club number ascending, then receive unique ordinal ranks. Null scores sort last and are unranked.
    - `key` (enum) One of: `historical_health_analysis.score`.
    - `direction` (enum) One of: `desc`.
    - `nulls` (enum) One of: `last_unranked`.
    - `tie_breaker` (enum) One of: `normalized_club_number_asc`.
    - `rank_style` (enum) One of: `ordinal`.
- `filters` (object)
  - `district` (string)
  - `fiscalYear` (string)
  - `fiscalMonth` (integer)
- `timestamp` (timestamp)

**Errors**

- `404`: No district snapshot exists for the resolved fiscal year and month.
- `422`: Invalid district, fiscalYear, fiscalMonth, or unsupported query parameter such as latest.
- `500`: Internal server error

**Example request**

```bash
curl "https://tm-api.devinpearson.me/api/district/74/clubs/historical-health"
```

**Example response**

```json
{
  "success": true,
  "fiscal_year": "2026-2027",
  "fiscal_month": 5,
  "data": {
    "district": "74",
    "region": "11",
    "clubs": [
      {
        "rank": 1,
        "club_number": "113",
        "club_name": "Example Toastmasters Club",
        "division": "A",
        "area": "01",
        "club_status": "string",
        "active_members": 0,
        "distinguished_status": "string",
        "historical_health_analysis": {
          "schema_version": "1.0",
          "config_version": "string",
          "status": "available",
          "score": 0,
          "historical_class": "A",
          "trajectory": "Growing",
          "profile": "Healthy & Growing",
          "years_analyzed": 0,
          "period": {
            "requested_max_years": 5,
            "completed_through": "string",
            "earliest": "string",
            "latest": "string",
            "missing_years": []
          },
          "trend": {
            "membership_change_percent_per_year": 0,
            "membership_volatility": 0,
            "latest_year_end_membership": 0
          },
          "yearly": [
            {}
          ],
          "explainability": {
            "components": [],
            "recent_award_classification": {},
            "benchmark_adjusted_trajectory": {},
            "reasons": []
          },
          "data_quality": {
            "confidence": "high",
            "excluded_years": [],
            "missing_metrics": [],
            "warnings": []
          }
        },
        "club_outlook": {
          "version": "1",
          "category": "doing_well",
          "label": "Definite worry",
          "basis": "renewals",
          "health_score": 0,
          "health_score_change": 0,
          "scored_year": "2025-2026",
          "paid_members": 0,
          "last_year_end_members": 0,
          "retention": 0,
          "reasons": [
            "string"
          ],
          "points": [
            {}
          ]
        }
      }
    ]
  },
  "summary": {
    "total_clubs": 0,
    "ranked_clubs": 0,
    "unranked_clubs": 0,
    "analysis_status_counts": {
      "available": 0,
      "limited_history": 0,
      "insufficient_data": 0,
      "no_history": 0
    }
  },
  "metadata": {
    "analysis_current_fiscal_year": "string",
    "ranking": {
      "key": "historical_health_analysis.score",
      "direction": "desc",
      "nulls": "last_unranked",
      "tie_breaker": "normalized_club_number_asc",
      "rank_style": "ordinal"
    }
  },
  "filters": {
    "district": "74",
    "fiscalYear": "2026-2027",
    "fiscalMonth": 5
  },
  "timestamp": "2026-11-19T04:30:00.000Z"
}
```

## Get the district dashboard

`GET /api/district/{district}`

The district's summary totals and recognition goals, its divisions with their areas and clubs, its monthly history, prospective clubs and insights, for the latest fiscal month of the fiscal year or the one requested. Division, area and district educational_ratio values are total awards divided by total member base; average_goals_met is the mean over clubs.

**Path parameters**

- `district` (string, required): District number/code

**Query parameters**

- `fiscalYear` (string, optional): Fiscal year (YYYY-YYYY); defaults to the latest fiscal year with dashboard data
- `fiscalMonth` (integer, optional): Fiscal month (1 = July); defaults to the latest month with data
- `latest` (boolean, optional, default true): Use each record's latest snapshot

**Returns**

- `success` (enum) One of: `true`.
- `fiscal_year` (string)
- `fiscal_month` (integer)
- `data` (object)
  - `district` (string)
  - `region` (nullable string)
  - `fiscal_year` (string)
  - `district_context` (object): District-wide educational and goal benchmarks.
    - `district` (string)
    - `region` (nullable string)
    - `fiscal_year` (string)
    - `fiscal_month` (integer)
    - `educational_awards` (integer)
    - `member_base` (integer)
    - `educational_ratio` (number)
    - `average_goals_met` (number)
  - `divisions` (array of objects)
    - `district` (string)
    - `division` (string)
    - `fiscal_year` (string)
    - `fiscal_month` (integer)
    - `distinguished` (nullable string)
    - `club_base` (nullable integer)
    - `total_dist_clubs` (nullable integer)
    - `total_paid_clubs` (nullable integer)
    - `dist_club_goal_for_dist` (nullable integer)
    - `dist_club_goal_for_select_dist` (nullable integer)
    - `dist_club_goal_for_pres_dist` (nullable integer)
    - `paid_club_goal_for_dist` (nullable integer)
    - `paid_club_goal_for_select_dist` (nullable integer)
    - `paid_club_goal_for_pres_dist` (nullable integer)
    - `total_members` (integer)
    - `clubs_5plus_goals` (integer)
    - `clubs_20plus_members` (integer)
    - `clubs_with_officers_trained_round_1` (integer)
    - `clubs_with_officers_trained_round_2` (integer)
    - `member_base` (integer)
    - `educational_awards` (integer)
    - `levels_completed` (integer)
    - `payments_to_date` (integer)
    - `educational_ratio` (number): Educational awards per member of the base; 0 when the base is 0.
    - `average_goals_met` (number): Mean DCP goals met per club; 0 when there are no clubs.
    - `member_payments` (object): Membership payments to date: renewals by period, new and charter payments, and their total.
      - `october_renewals` (integer)
      - `april_renewals` (integer)
      - `late_renewals` (integer)
      - `total_renewals` (integer)
      - `new_payments` (integer)
      - `charter_payments` (integer)
      - `total_to_date` (integer)
    - `payment_base` (integer): The district's payment base shared out by the division's share of the district member base.
    - `payment_goals` (object): A goal or count for each recognition level.
      - `distinguished` (integer)
      - `select_distinguished` (integer)
      - `presidents_distinguished` (integer)
      - `smedley_distinguished` (integer)
    - `areas` (array of objects)
      - `district` (string)
      - `division` (string)
      - `area` (string)
      - `fiscal_year` (string)
      - `fiscal_month` (integer)
      - `distinguished` (nullable string)
      - `total_dist_clubs` (nullable integer)
      - `total_paid_clubs` (nullable integer)
      - `dist_club_goal_for_dist` (nullable integer)
      - `dist_club_goal_for_select_dist` (nullable integer)
      - `dist_club_goal_for_pres_dist` (nullable integer)
      - `paid_club_goal_for_dist` (nullable integer)
      - `paid_club_goal_for_select_dist` (nullable integer)
      - `paid_club_goal_for_pres_dist` (nullable integer)
      - `total_members` (integer)
      - `clubs_5plus_goals` (integer)
      - `clubs_20plus_members` (integer)
      - `clubs_with_officers_trained_round_1` (integer)
      - `clubs_with_officers_trained_round_2` (integer)
      - `member_base` (integer)
      - `educational_awards` (integer)
      - `levels_completed` (integer)
      - `payments_to_date` (integer)
      - `educational_ratio` (number): Educational awards per member of the base; 0 when the base is 0.
      - `average_goals_met` (number): Mean DCP goals met per club; 0 when there are no clubs.
      - `member_payments` (object): Membership payments to date: renewals by period, new and charter payments, and their total.
        - `october_renewals` (integer)
        - `april_renewals` (integer)
        - `late_renewals` (integer)
        - `total_renewals` (integer)
        - `new_payments` (integer)
        - `charter_payments` (integer)
        - `total_to_date` (integer)
      - `clubs` (array of objects)
        - `club_number` (string)
        - `club_name` (nullable string)
        - `division` (string)
        - `area` (string)
        - `fiscal_year` (string)
        - `fiscal_month` (nullable integer)
        - `active_members` (nullable integer)
        - `member_base` (nullable integer)
        - `goals_met` (nullable integer)
        - `educational_awards` (integer)
        - `educational_ratio` (number): Educational awards per member of the base; 0 when the base is 0.
        - `average_goals_met` (number)
        - `club_status` (nullable string)
        - `distinguished_status` (nullable string)
        - `levels_completed` (integer)
        - `level_1s` (integer)
        - `level_2s` (integer)
        - `add_level_2s` (integer)
        - `level_3s` (integer)
        - `level_4s_path_completions_or_dtm_awards` (integer)
        - `add_level_4s_path_completions_or_dtm_award` (integer)
        - `new_members` (integer)
        - `add_new_members` (integer)
        - `off_list_on_time` (integer)
        - `charter_date` (nullable string)
        - `latitude` (nullable string)
        - `longitude` (nullable string)
        - `meeting_times` (nullable string): When the club meets, as its Find-a-Club listing says
        - `meeting_schedule` (nullable object): The meeting times read into weekdays and weeks of the month at import; null when the club lists none or they haven't been read yet
          - `version` (integer): Parser version that read the text
          - `placeable` (boolean): Whether the rules say which days of a month the club meets
          - `rules` (array of objects)
            - `weekday` (integer): 0 = Sunday … 6 = Saturday
            - `weeks` (enum or array of integers): "every" week, or the nth weekdays of the month (1-5, -1 for the last)
          - `time` (nullable string): Start time as 24-hour "HH:MM"
          - `reason` (nullable enum): Why an unplaceable schedule couldn't be placed One of: `no-day`, `fortnightly`, `monthly-count`, `null`.
        - `october_renewals` (integer)
        - `april_renewals` (integer)
        - `late_renewals` (integer)
        - `new_payments` (integer)
        - `charter_payments` (integer)
        - `total_renewals` (integer)
        - `total_to_date` (integer)
        - `csp_submitted` (nullable enum): True when the club has submitted its Club Success Plan, otherwise null. One of: `true`, `null`.
        - `nov_visit_award` (nullable integer)
        - `may_visit_award` (nullable integer)
        - `off_trained_round_1` (nullable integer)
        - `off_trained_round_2` (nullable integer)
        - `april_renewal_status` (nullable string)
        - `october_renewal_status` (nullable string)
        - `coaches` (array of objects)
          - `coach_name` (nullable string)
          - `coach_achievement` (nullable string)
          - `begin_date` (nullable timestamp)
          - `status` (nullable string)
          - `code` (nullable string)
        - `member_payments` (object): Membership payments to date: renewals by period, new and charter payments, and their total.
          - `october_renewals` (integer)
          - `april_renewals` (integer)
          - `late_renewals` (integer)
          - `total_renewals` (integer)
          - `new_payments` (integer)
          - `charter_payments` (integer)
          - `total_to_date` (integer)
  - `monthly_history` (array of objects)
    - `fiscal_year` (string)
    - `fiscal_month` (integer)
    - `paid_clubs` (integer)
    - `active_clubs` (integer)
    - `payments_to_date` (integer)
    - `payment_base` (integer)
    - `new_payments` (integer)
    - `april_renewals` (integer)
    - `late_renewals` (integer)
    - `charter_payments` (integer)
    - `total_distinguished_clubs` (integer)
    - `select_distinguished_clubs` (integer)
    - `presidents_distinguished_clubs` (integer)
  - `insights` (nullable object or nullable enum): Rule-built insights for the report date; null when no report date is known.
    - `as_of` (date): When the district's club rows for the reported fiscal month were last imported, no later than that month's end.
    - `month` (string)
    - `month_target` (integer): Goals a club should have met by this month.
    - `show_potential_metrics` (boolean): False in April – June, when clubs can become Distinguished outright.
    - `divisions` (array of objects)
      - `division` (string)
      - `distinguished_status` (nullable enum) One of: `D`, `S`, `P`, `null`.
      - `areas` (array of objects)
        - `area` (string)
        - `distinguished_status` (nullable enum) One of: `D`, `S`, `P`, `null`.
        - `visits` (nullable object): The Area Director's club visits in each round (75% of the area's club base); null when the area has no clubs or any club lacks visit data.
          - `nov` (object)
            - `clubs_visited` (integer)
            - `clubs_required` (integer): 75% of the area's club base, rounded up (its clubs when it has no base).
            - `status` (object)
              - `state` (enum) One of: `met`, `notDue`, `missed`.
              - `dueLabel` (string)
          - `may` (object)
            - `clubs_visited` (integer)
            - `clubs_required` (integer): 75% of the area's club base, rounded up (its clubs when it has no base).
            - `status` (object)
              - `state` (enum) One of: `met`, `notDue`, `missed`.
              - `dueLabel` (string)
  - `month_change` (object or nullable enum): The district's totals against the fiscal month before, with each division's change in parts; null when no clubs were reported for the month.
    - `fiscal_year` (string)
    - `fiscal_month` (integer): Fiscal month (1 = July) of the figures.
    - `previous_fiscal_month` (nullable integer): The fiscal month compared with; null in July, which starts the fiscal year.
    - `current` (object): A scope's totals over its clubs for one fiscal month. Suspended clubs count only as suspended.
      - `clubs` (integer): Clubs that aren't suspended.
      - `suspended_clubs` (integer)
      - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
      - `distinguished_clubs` (integer)
      - `active_members` (integer)
      - `goals_met` (integer): DCP goals met, summed over the clubs.
      - `educational_awards` (integer)
      - `new_members` (integer): New and additional new members counted for the DCP.
    - `previous` (object or nullable enum): Last month's totals; null in July or when no clubs were reported last month.
      - `clubs` (integer): Clubs that aren't suspended.
      - `suspended_clubs` (integer)
      - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
      - `distinguished_clubs` (integer)
      - `active_members` (integer)
      - `goals_met` (integer): DCP goals met, summed over the clubs.
      - `educational_awards` (integer)
      - `new_members` (integer): New and additional new members counted for the DCP.
    - `change` (object or nullable enum): This month's totals minus last month's; null when previous is.
      - `clubs` (integer): Clubs that aren't suspended.
      - `suspended_clubs` (integer)
      - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
      - `distinguished_clubs` (integer)
      - `active_members` (integer)
      - `goals_met` (integer): DCP goals met, summed over the clubs.
      - `educational_awards` (integer)
      - `new_members` (integer): New and additional new members counted for the DCP.
    - `clubs_added` (array of strings): Clubs here this month but not last month: chartered or moved in.
    - `clubs_removed` (array of strings): Clubs here last month but not this month: moved out or no longer reported.
    - `parts` (array of objects)
      - `key` (string): The division letter, area number or club number.
      - `current` (object): A scope's totals over its clubs for one fiscal month. Suspended clubs count only as suspended.
        - `clubs` (integer): Clubs that aren't suspended.
        - `suspended_clubs` (integer)
        - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
        - `distinguished_clubs` (integer)
        - `active_members` (integer)
        - `goals_met` (integer): DCP goals met, summed over the clubs.
        - `educational_awards` (integer)
        - `new_members` (integer): New and additional new members counted for the DCP.
      - `previous` (object or nullable enum): Last month's totals; null in July or when no clubs were reported last month.
        - `clubs` (integer): Clubs that aren't suspended.
        - `suspended_clubs` (integer)
        - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
        - `distinguished_clubs` (integer)
        - `active_members` (integer)
        - `goals_met` (integer): DCP goals met, summed over the clubs.
        - `educational_awards` (integer)
        - `new_members` (integer): New and additional new members counted for the DCP.
      - `change` (object or nullable enum): This month's totals minus last month's; null when previous is.
        - `clubs` (integer): Clubs that aren't suspended.
        - `suspended_clubs` (integer)
        - `paid_clubs` (integer): Clubs that aren't suspended with an October or April renewal on record.
        - `distinguished_clubs` (integer)
        - `active_members` (integer)
        - `goals_met` (integer): DCP goals met, summed over the clubs.
        - `educational_awards` (integer)
        - `new_members` (integer): New and additional new members counted for the DCP.
      - `clubs_added` (array of strings): Clubs here this month but not last month: chartered or moved in.
      - `clubs_removed` (array of strings): Clubs here last month but not this month: moved out or no longer reported.
- `summary` (object): The district's totals, programme status and recognition goals for the fiscal month.
  - `total_divisions` (integer)
  - `total_areas` (integer)
  - `paid_clubs` (integer)
  - `active_clubs` (integer)
  - `total_clubs` (integer)
  - `payment_base` (integer)
  - `paid_club_base` (integer)
  - `total_ytd_payments` (nullable integer)
  - `distinguished_clubs` (integer)
  - `member_payments` (object): Membership payments to date: renewals by period, new and charter payments, and their total.
    - `october_renewals` (integer)
    - `april_renewals` (integer)
    - `late_renewals` (integer)
    - `total_renewals` (integer)
    - `new_payments` (integer)
    - `charter_payments` (integer)
    - `total_to_date` (integer)
  - `new_payments` (integer)
  - `april_renewals` (integer)
  - `late_renewals` (integer)
  - `charter_payments` (integer)
  - `payment_growth` (nullable number): Payments to date as a percentage of the payment base.
  - `club_growth` (nullable string)
  - `total_distinguished_clubs` (integer)
  - `total_csps_completed` (integer)
  - `select_distinguished_clubs` (integer)
  - `presidents_distinguished_clubs` (integer)
  - `smedley_distinguished_clubs` (integer)
  - `dsp` (nullable string)
  - `training` (nullable string)
  - `market_analysis` (nullable string)
  - `region_advisor_meetings` (nullable string)
  - `distinguished` (nullable string)
  - `fiscal_year` (string)
  - `fiscal_month` (integer)
  - `member_base` (integer)
  - `educational_awards` (integer)
  - `educational_awards_breakdown` (object): Educational awards by Pathways level, DTMs and Pathways Mentor Program completions.
    - `level_1` (integer)
    - `level_2` (integer)
    - `level_3` (integer)
    - `level_4` (integer)
    - `level_5` (integer)
    - `dtm` (integer)
    - `mentor_program` (integer)
  - `educational_awards_by_pathway` (object): Educational awards by Pathways path name. Only paths with an award appear.
  - `educational_ratio` (number)
  - `average_goals_met` (number)
  - `active_members` (integer)
  - `average_members_per_club` (number)
  - `average_new_members_per_club` (number)
  - `clubs_5plus_goals` (integer)
  - `clubs_20plus_members` (integer)
  - `clubs_trained_r1` (integer)
  - `clubs_trained_r2` (integer)
  - `nov_visit_award` (integer)
  - `may_visit_award` (integer)
  - `monthly_membership_goals` (object or nullable enum): This month's membership payment targets; null when the payment base is 0.
    - `distinguished` (integer)
    - `select_distinguished` (integer)
    - `presidents_distinguished` (integer)
    - `smedley_distinguished` (integer)
  - `monthly_membership_goals_fiscal_month` (nullable integer)
  - `membership_goals` (object): A goal or count for each recognition level.
    - `distinguished` (integer)
    - `select_distinguished` (integer)
    - `presidents_distinguished` (integer)
    - `smedley_distinguished` (integer)
  - `paid_club_goals` (object): A goal or count for each recognition level.
    - `distinguished` (integer)
    - `select_distinguished` (integer)
    - `presidents_distinguished` (integer)
    - `smedley_distinguished` (integer)
  - `distinguished_club_goals` (object): A goal or count for each recognition level.
    - `distinguished` (integer)
    - `select_distinguished` (integer)
    - `presidents_distinguished` (integer)
    - `smedley_distinguished` (integer)
  - `monthly_paid_club_goals` (object or nullable enum): This month's paid club targets.
    - `distinguished` (integer)
    - `select_distinguished` (integer)
    - `presidents_distinguished` (integer)
    - `smedley_distinguished` (integer)
  - `monthly_paid_club_goals_fiscal_month` (nullable integer)
- `prospective_clubs` (array of objects)
  - `club_number` (nullable string)
  - `club_name` (nullable string)
  - `division` (nullable string)
  - `area` (nullable string)
  - `status` (nullable string)
  - `date` (timestamp)
- `monthly_history` (array of objects): The same as data.monthly_history.
  - `fiscal_year` (string)
  - `fiscal_month` (integer)
  - `paid_clubs` (integer)
  - `active_clubs` (integer)
  - `payments_to_date` (integer)
  - `payment_base` (integer)
  - `new_payments` (integer)
  - `april_renewals` (integer)
  - `late_renewals` (integer)
  - `charter_payments` (integer)
  - `total_distinguished_clubs` (integer)
  - `select_distinguished_clubs` (integer)
  - `presidents_distinguished_clubs` (integer)
- `filters` (object)
  - `district` (string)
  - `fiscalYear` (string)
  - `fiscalMonth` (integer): Sent only when the request names a fiscal month.
  - `latest` (boolean)
- `timestamp` (timestamp)

**Errors**

- `404`: No data for the district in the fiscal year
- `422`: Invalid fiscal year or fiscal month
- `500`: Internal server error

**Example request**

```bash
curl "https://tm-api.devinpearson.me/api/district/74"
```

**Example response**

```json
{
  "success": true,
  "fiscal_year": "2026-2027",
  "fiscal_month": 5,
  "data": {
    "district": "74",
    "region": "11",
    "fiscal_year": "2026-2027",
    "district_context": {
      "district": "74",
      "region": "11",
      "fiscal_year": "2026-2027",
      "fiscal_month": 5,
      "educational_awards": 0,
      "member_base": 0,
      "educational_ratio": 0,
      "average_goals_met": 0
    },
    "divisions": [
      {
        "district": "74",
        "division": "A",
        "fiscal_year": "2026-2027",
        "fiscal_month": 5,
        "distinguished": "string",
        "club_base": 0,
        "total_dist_clubs": 0,
        "total_paid_clubs": 0,
        "dist_club_goal_for_dist": 0,
        "dist_club_goal_for_select_dist": 0,
        "dist_club_goal_for_pres_dist": 0,
        "paid_club_goal_for_dist": 0,
        "paid_club_goal_for_select_dist": 0,
        "paid_club_goal_for_pres_dist": 0,
        "total_members": 0,
        "clubs_5plus_goals": 0,
        "clubs_20plus_members": 0,
        "clubs_with_officers_trained_round_1": 0,
        "clubs_with_officers_trained_round_2": 0,
        "member_base": 0,
        "educational_awards": 0,
        "levels_completed": 0,
        "payments_to_date": 0,
        "educational_ratio": 0,
        "average_goals_met": 0,
        "member_payments": {
          "october_renewals": 0,
          "april_renewals": 0,
          "late_renewals": 0,
          "total_renewals": 0,
          "new_payments": 0,
          "charter_payments": 0,
          "total_to_date": 0
        },
        "payment_base": 0,
        "payment_goals": {
          "distinguished": 0,
          "select_distinguished": 0,
          "presidents_distinguished": 0,
          "smedley_distinguished": 0
        },
        "areas": [
          {
            "district": "74",
            "division": "A",
            "area": "01",
            "fiscal_year": "2026-2027",
            "fiscal_month": 5,
            "distinguished": "string",
            "total_dist_clubs": 0,
            "total_paid_clubs": 0,
            "dist_club_goal_for_dist": 0,
            "dist_club_goal_for_select_dist": 0,
            "dist_club_goal_for_pres_dist": 0,
            "paid_club_goal_for_dist": 0,
            "paid_club_goal_for_select_dist": 0,
            "paid_club_goal_for_pres_dist": 0,
            "total_members": 0,
            "clubs_5plus_goals": 0,
            "clubs_20plus_members": 0,
            "clubs_with_officers_trained_round_1": 0,
            "clubs_with_officers_trained_round_2": 0,
            "member_base": 0,
            "educational_awards": 0,
            "levels_completed": 0,
            "payments_to_date": 0,
            "educational_ratio": 0,
            "average_goals_met": 0,
            "member_payments": {},
            "clubs": []
          }
        ]
      }
    ],
    "monthly_history": [
      {
        "fiscal_year": "2026-2027",
        "fiscal_month": 5,
        "paid_clubs": 0,
        "active_clubs": 0,
        "payments_to_date": 0,
        "payment_base": 0,
        "new_payments": 0,
        "april_renewals": 0,
        "late_renewals": 0,
        "charter_payments": 0,
        "total_distinguished_clubs": 0,
        "select_distinguished_clubs": 0,
        "presidents_distinguished_clubs": 0
      }
    ],
    "insights": {
      "as_of": "2026-11-19",
      "month": "string",
      "month_target": 0,
      "show_potential_metrics": true,
      "divisions": [
        {
          "division": "A",
          "distinguished_status": "D",
          "areas": [
            {}
          ]
        }
      ]
    },
    "month_change": {
      "fiscal_year": "2026-2027",
      "fiscal_month": 5,
      "previous_fiscal_month": 1,
      "current": {
        "clubs": 0,
        "suspended_clubs": 0,
        "paid_clubs": 0,
        "distinguished_clubs": 0,
        "active_members": 0,
        "goals_met": 0,
        "educational_awards": 0,
        "new_members": 0
      },
      "previous": {
        "clubs": 0,
        "suspended_clubs": 0,
        "paid_clubs": 0,
        "distinguished_clubs": 0,
        "active_members": 0,
        "goals_met": 0,
        "educational_awards": 0,
        "new_members": 0
      },
      "change": {
        "clubs": 0,
        "suspended_clubs": 0,
        "paid_clubs": 0,
        "distinguished_clubs": 0,
        "active_members": 0,
        "goals_met": 0,
        "educational_awards": 0,
        "new_members": 0
      },
      "clubs_added": [
        "string"
      ],
      "clubs_removed": [
        "string"
      ],
      "parts": [
        {
          "key": "string",
          "current": {
            "clubs": 0,
            "suspended_clubs": 0,
            "paid_clubs": 0,
            "distinguished_clubs": 0,
            "active_members": 0,
            "goals_met": 0,
            "educational_awards": 0,
            "new_members": 0
          },
          "previous": {
            "clubs": 0,
            "suspended_clubs": 0,
            "paid_clubs": 0,
            "distinguished_clubs": 0,
            "active_members": 0,
            "goals_met": 0,
            "educational_awards": 0,
            "new_members": 0
          },
          "change": {
            "clubs": 0,
            "suspended_clubs": 0,
            "paid_clubs": 0,
            "distinguished_clubs": 0,
            "active_members": 0,
            "goals_met": 0,
            "educational_awards": 0,
            "new_members": 0
          },
          "clubs_added": [
            "string"
          ],
          "clubs_removed": [
            "string"
          ]
        }
      ]
    }
  },
  "summary": {
    "total_divisions": 0,
    "total_areas": 0,
    "paid_clubs": 0,
    "active_clubs": 0,
    "total_clubs": 0,
    "payment_base": 0,
    "paid_club_base": 0,
    "total_ytd_payments": 0,
    "distinguished_clubs": 0,
    "member_payments": {
      "october_renewals": 0,
      "april_renewals": 0,
      "late_renewals": 0,
      "total_renewals": 0,
      "new_payments": 0,
      "charter_payments": 0,
      "total_to_date": 0
    },
    "new_payments": 0,
    "april_renewals": 0,
    "late_renewals": 0,
    "charter_payments": 0,
    "payment_growth": 0,
    "club_growth": "string",
    "total_distinguished_clubs": 0,
    "total_csps_completed": 0,
    "select_distinguished_clubs": 0,
    "presidents_distinguished_clubs": 0,
    "smedley_distinguished_clubs": 0,
    "dsp": "string",
    "training": "string",
    "market_analysis": "string",
    "region_advisor_meetings": "string",
    "distinguished": "string",
    "fiscal_year": "2026-2027",
    "fiscal_month": 5,
    "member_base": 0,
    "educational_awards": 0,
    "educational_awards_breakdown": {
      "level_1": 0,
      "level_2": 0,
      "level_3": 0,
      "level_4": 0,
      "level_5": 0,
      "dtm": 0,
      "mentor_program": 0
    },
    "educational_awards_by_pathway": {},
    "educational_ratio": 0,
    "average_goals_met": 0,
    "active_members": 0,
    "average_members_per_club": 0,
    "average_new_members_per_club": 0,
    "clubs_5plus_goals": 0,
    "clubs_20plus_members": 0,
    "clubs_trained_r1": 0,
    "clubs_trained_r2": 0,
    "nov_visit_award": 0,
    "may_visit_award": 0,
    "monthly_membership_goals": {
      "distinguished": 0,
      "select_distinguished": 0,
      "presidents_distinguished": 0,
      "smedley_distinguished": 0
    },
    "monthly_membership_goals_fiscal_month": 0,
    "membership_goals": {
      "distinguished": 0,
      "select_distinguished": 0,
      "presidents_distinguished": 0,
      "smedley_distinguished": 0
    },
    "paid_club_goals": {
      "distinguished": 0,
      "select_distinguished": 0,
      "presidents_distinguished": 0,
      "smedley_distinguished": 0
    },
    "distinguished_club_goals": {
      "distinguished": 0,
      "select_distinguished": 0,
      "presidents_distinguished": 0,
      "smedley_distinguished": 0
    },
    "monthly_paid_club_goals": {
      "distinguished": 0,
      "select_distinguished": 0,
      "presidents_distinguished": 0,
      "smedley_distinguished": 0
    },
    "monthly_paid_club_goals_fiscal_month": 0
  },
  "prospective_clubs": [
    {
      "club_number": "113",
      "club_name": "Example Toastmasters Club",
      "division": "A",
      "area": "01",
      "status": "string",
      "date": "2026-11-19T04:30:00.000Z"
    }
  ],
  "monthly_history": [
    {
      "fiscal_year": "2026-2027",
      "fiscal_month": 5,
      "paid_clubs": 0,
      "active_clubs": 0,
      "payments_to_date": 0,
      "payment_base": 0,
      "new_payments": 0,
      "april_renewals": 0,
      "late_renewals": 0,
      "charter_payments": 0,
      "total_distinguished_clubs": 0,
      "select_distinguished_clubs": 0,
      "presidents_distinguished_clubs": 0
    }
  ],
  "filters": {
    "district": "74",
    "fiscalYear": "2026-2027",
    "fiscalMonth": 5,
    "latest": true
  },
  "timestamp": "2026-11-19T04:30:00.000Z"
}
```
