/shorts.v1alpha1.PoliticiansService/GetDonationsOverviewGetDonationsOverview
Party-group funding rollups for one financial year, plus the corpus counts and disclosure notes a funding surface must render.
Parameters
Define the version of the Connect protocol
Define the timeout, in ms
Request Body
Verbatim FY label ('2024-25'). Empty selects the latest year held. (proto string)
Party groups returned, ordered by total_receipts_cents desc. Default 25, max 100. (proto int32)
Responses
ingest snapshot (proto google.protobuf.Timestamp)
Crown copyright credit; required by the licence (proto string)
(proto shorts.v1alpha1.FinancialYearOption)
FinancialYearOption is one selectable year, with how much is in it.
The mandatory notes, single-sourced HERE so every surface renders the same words and none can paraphrase them into a claim the data cannot support. right-censoring at the disclosure threshold (proto string)
(proto shorts.v1alpha1.DonationsCorpusCounts)
(proto int32)
(proto int32)
(proto int32)
(proto int32)
(proto int32)
(proto int32)
How many company names the match layer can match against at all. A property of the company metadata, kept as the denominator that makes the matched figures legible, and never to be rendered as a number of donors. (proto int32)
(proto int32)
Donor/payer NAMES appearing in this corpus that resolve to an ASX listing, and the codes they resolve to (exact normalised name or curated alias, never fuzzy). These describe the corpus. They replace `listed_company_match_count`, which published the size of the matching SUBSTRATE — every listed company whose name COULD be matched — as though it were a count of companies found in the data. It read an order of magnitude high. (proto int32)
The member layer, and why it is thin. A member with no row here has NOT been shown to have received nothing — most members never lodge this return. (proto int32)
(proto int32)
A lodged nil return is a publishable fact, not missing data. (proto int32)
(proto int32)
(proto int32)
what the member layer does and does not cover (proto string)
the year actually served (proto string)
(proto shorts.v1alpha1.PartyFundingSummary)
PartyFundingSummary is one party group in one financial year, straight from mv_aec_party_funding. Nothing here is derived: each figure is a sum or a distinct count over lodged returns. The two sides of the ledger are kept apart on purpose. total_receipts_cents is what the party's OWN annual return declares it received; the itemised and declared_donations figures are the transaction-level rows from the recipient side and the donor side respectively. They do not reconcile to each other and must never be presented as if they should.
the 1 Jan 2027 scheme change / break annotation (proto string)
'CC-BY-4.0' (proto string)
figures are as lodged, amendments land continuously (proto string)
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
A list of messages that carry the error details. There is no limit on the number of messages.
Contains an arbitrary serialized message along with a @type that describes the type of the serialized message, with an additional debug field for ConnectRPC error details.
A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
curl -X POST "https://api.shorted.com.au/shorts.v1alpha1.PoliticiansService/GetDonationsOverview" \
-H "Content-Type: application/json" \
-d '{
"financialYear": "string",
"limit": 0
}'curl -X POST "https://api.shorted.com.au/shorts.v1alpha1.PoliticiansService/GetDonationsOverview" \
-H "Content-Type: application/json" \
-d '{
"financialYear": "string",
"limit": 0
}'