latest
Retrieve the most recent reporting year data for any WGEA dataset. Filter by employer or industry to get current workforce composition, pay gaps, or parental leave metrics.
Instructions
Return rows from the most recent WGEA reporting year for a dataset.
Trims to the single latest reporting_year — useful for "what's the current gender breakdown at CBA?" without having to remember WGEA's annual cadence.
Examples: # Latest workforce composition at CBA resp = await latest("WORKFORCE_COMPOSITION", filters={"employer_name": "Commonwealth Bank"})
# Cap rows (portfolio-standard name)
resp = await latest("WORKFORCE_COMPOSITION",
filters={"anzsic_division": "Mining"}, limit=100)
# Legacy alias still works
resp = await latest("WORKFORCE_COMPOSITION",
filters={"anzsic_division": "Mining"}, max_rows=100)Parameter notes:
- Prefer limit (portfolio-standard; matches asic-mcp's
latest(..., limit) parameter).
- max_rows retained as legacy alias.
- Supplying both raises ValueError — pick one.
- get_data() keeps max_rows unchanged (separate surface, separate
concern).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | Curated dataset ID. | |
| filters | No | Same filter shape as get_data. Useful for narrowing to one employer. | |
| limit | No | Cap on returned rows (portfolio-standard name). Default 2000, max 10000. Mutually exclusive with the legacy `max_rows` alias — supplying both raises ValueError. | |
| max_rows | No | Legacy alias for `limit` — retained for backward compatibility (wgea-mcp <= 0.4.x). Prefer `limit` for cross-sister consistency with asic-mcp's `latest(..., limit)` parameter. Same semantics as `limit`. Supplying both raises ValueError. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | ||
| dataset_name | Yes | ||
| query | No | ||
| reporting_year | No | ||
| period | No | Canonical period bounds {start, end} for cross-sister consumers. Populated alongside the wgea-specific reporting_year. For a single reporting year both bounds match; for multi-year spans they bracket the range. | |
| unit | No | ||
| row_count | No | ||
| records | No | ||
| csv | No | ||
| source | No | Workplace Gender Equality Agency | |
| attribution | No | Source: Workplace Gender Equality Agency. Licensed under Creative Commons Attribution 3.0 Australia (https://creativecommons.org/licenses/by/3.0/au/). Original dataset: https://data.gov.au/data/dataset/wgea-dataset | |
| retrieved_at | Yes | ||
| source_url | Yes | ||
| download_url | No | ||
| did_you_mean | No | ||
| stale | No | ||
| stale_reason | No | ||
| truncated_at | No | ||
| server_version | No |