Uslobbying Search Lobbyists
uslobbying_search_lobbyistsRead-onlyIdempotent
Find lobbyists by name or registrant in mode search, then retrieve filing-scoped evidence with mode activity, lobbyist_id and filing_year. Pass an evidence filing_uuid to uslobbying_search_filings for the complete filing. Covered positions are disclosed text, not verified present employment. Activity mode checks the requested lobbyist locally. Follow next_cursor for all results.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | search (default) finds identities by name or registrant; activity requires lobbyist_id and filing_year. Omit with cursor. | |
| name | No | Lobbyist identity name substring. | |
| cursor | No | Continue the original scope; other query fields may be omitted. | |
| client_id | No | Optional activity client relationship record ID from candidates[].id in uslobbying_get_client_profile resolve mode; candidates[].client_id is secondary. | |
| max_pages | No | Source pages per call; positive integers clamp to five, default one for discovery, five for analysis. | |
| page_size | No | Upstream rows per page; positive integers clamp to 25, default 25. | |
| filing_year | No | Required report year in activity mode. | |
| lobbyist_id | No | Required in activity mode. | |
| record_path | No | JSON Pointer to a stored value; empty selects the root. | |
| record_limit | No | Maximum object entries or array items, clamped to 25; text fragments use the response byte budget. | |
| record_handle | No | Tenant/tool-bound deferred record handle. | |
| record_offset | No | Key, item or Unicode-code-point offset. | |
| registrant_id | No | Registrant identity ID. | |
| registrant_name | No | Registrant identity name substring. | |
| covered_positions_only | No | Activity only: require this lobbyist’s nonblank covered-position disclosure. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Resolved operation. | |
| error | No | Present when the call failed. Absent on success. | |
| offset | No | Final record delivery offset. | |
| source | No | Official source system. | |
| notices | No | Limitations and success notices. | |
| coverage | No | Acquisition progress, independent of delivery. | |
| evidence | No | Matched filing-based participant evidence in activity mode. | |
| lobbyists | No | Complete identity records in search mode. | |
| truncated | No | More of the parent value remains available through record windows. | |
| attribution | No | Required verbatim attribution for LDA data. | |
| next_cursor | No | Next acquisition or output window cursor. | |
| retrieved_at | No | Retrieval ISO timestamp. | |
| record_window | No | Lossless stored parent window. | |
| total_records | No | Exact final record count when known. | |
| record_handles | No | Deferred complete parents. | |
| retrieval_tool | No | Tool that retrieves this parent. | |
| 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. | |
| records_deferred | No | Oversized parents available through handles. | |
| records_returned | No | Complete records delivered in this window. | |
| cursor_expires_at | No | Continuation expiry ISO timestamp. | |
| effective_filters | No | Normalized effective scope. | |
| snapshot_source_urls | No | Official snapshot URLs. | |
| snapshot_retrieved_at | No | FARA snapshot retrieval timestamp. | |
| snapshot_last_modified | No | Upstream Last-Modified header. |