latest
Retrieve data for the most recent WGEA reporting year. Filter by employer or industry to get current workforce composition, pay gap actions, or parental leave policies.
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 |
|---|---|---|---|
| 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. | |
| filters | No | Same filter shape as get_data. Useful for narrowing to one employer. | |
| 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. | |
| dataset_id | Yes | Curated dataset ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| csv | No | ||
| unit | No | ||
| query | No | ||
| stale | 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. | |
| source | No | Workplace Gender Equality Agency | |
| records | No | ||
| row_count | No | ||
| dataset_id | Yes | ||
| source_url | Yes | ||
| 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 | |
| dataset_name | Yes | ||
| did_you_mean | No | ||
| download_url | No | ||
| retrieved_at | Yes | ||
| stale_reason | No | ||
| truncated_at | No | ||
| reporting_year | No | ||
| server_version | No |