Uslobbying Get Contributions
uslobbying_get_contributionsRetrieve complete semiannual LD-203 reports, contributions, PAC relationships and certifications, preserving original and amended reports. Child predicates must match the same item; full parent contribution lists and matched_item_indexes remain available. Report counts are not donation counts and no cross-report donation total is inferred.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "uslobbying_get_contributions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payee | No | Case-insensitive literal payee substring. | |
| cursor | No | Continue the original scope; omit the other fields or repeat them unchanged, since a changed value (page_size included) fails cursor_invalid. Only max_pages may change per call. | |
| honoree | No | Case-insensitive literal honoree substring. | |
| max_pages | No | Most upstream pages fetched per call, at most 5; larger values clamp and are disclosed in delivery_limits. Discovery fetches only while fewer than page_size matches are pending. Default one for discovery, five for analysis. | |
| page_size | No | Whole LD-203 reports delivered per call, each with its complete contribution list: default 10, at most 25; larger values clamp to it and are disclosed in delivery_limits. Not the upstream page size; a page is short only at the end of the result or while acquisition is still collecting. | |
| amount_max | No | Inclusive local same-item maximum exact decimal USD; complete parent lists remain available. | |
| amount_min | No | Inclusive local same-item minimum exact decimal USD; complete parent lists remain available. | |
| contributor | No | Case-insensitive literal contributor substring. | |
| filing_year | No | Required first-call reporting year, 2008 through current UTC year. | |
| lobbyist_id | No | Lobbyist filer ID. | |
| filing_period | No | Semiannual period. | |
| lobbyist_name | No | Lobbyist name upstream search. | |
| registrant_id | No | Registrant ID. | |
| registrant_name | No | Registrant name upstream search. | |
| contribution_type | No | Official feca, he, me, ple or pic payment code. | |
| contribution_date_after | No | Inclusive earliest item calendar date. | |
| contribution_date_before | No | Inclusive latest item calendar date. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| offset | No | Records delivered before this window. | |
| source | No | Official source system. | |
| notices | No | Limitations and success notices. | |
| reports | No | Full parent reports and complete child lists. | |
| coverage | No | Acquisition progress, independent of delivery. | |
| truncated | No | More data is available through next_cursor; no source data was discarded. | |
| attribution | No | Required verbatim attribution for LDA data. | |
| next_cursor | No | Next acquisition or output window cursor. | |
| retrieved_at | No | Retrieval ISO timestamp. | |
| total_records | No | Exact final record count when known. | |
| delivery_limits | No | Clamped controls for this call; an empty map means no clamp. Immediate cursor replay retains its original values. | |
| output_complete | No | Whether all result rows have been delivered. | |
| amendment_policy | No | Amendments remain separate reports. | |
| records_returned | No | Whole records delivered in this window. | |
| cursor_expires_at | No | Continuation expiry ISO timestamp. | |
| effective_filters | No | Normalized effective scope. | |
| item_count_in_batch | No | Items in returned complete parent lists. | |
| snapshot_source_urls | No | Official snapshot URLs. | |
| report_count_in_batch | No | Complete parent reports returned. | |
| snapshot_retrieved_at | No | FARA snapshot retrieval timestamp. | |
| snapshot_last_modified | No | Upstream Last-Modified header. |