US Senate financial disclosures (eFD) · Search reports
efdsearch-senate-gov/financial-disclosures/search_reportsFind companies, people and contact details with US Senate financial disclosures (eFD) · Search reports from Alexandria through one Spiral API key. Find Senate financial disclosure filings (PTRs, annual reports, extensions, blind trusts, paper filings) by Senator or candidate name, state, report type or date, and obtain report_id values for get_report. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
acknowledge_use_prohibitions required | true or false | — | Must be true: the caller affirms the prohibitions on obtaining and using financial disclosure reports in 5 U.S.C. app. 105(c) (no unlawful or commercial use other than by news media, no credit rating, no solicitation of money). The program submits the site's acknowledgement only on the caller's behalf after this affirmation. |
sort_by | one of first_name, last_name, filer, report, date_received | date_received | Sort column. Default date_received. |
sort_dir | one of asc, desc | desc | Sort direction. Default desc (newest first). |
last_name | text | — | Filer last name, prefix match as on the site (for example 'Warren'). |
page_size | number 1 to 100 | 25 | Rows per page, 1-100 (the site's maximum). |
first_name | text | — | Filer first name, prefix match. |
filer_types | list | — | Restrict to filer types (site codes 1, 4, 5). Empty or absent: all. |
filter_text | text | — | Free-text filter applied by the site across all result columns (the DataTables search box); records_filtered reflects it. |
continuation | text | — | Opaque cursor from a previous page's meta.page.next_cursor (the next start offset). Pattern: ^\d{1,7}$. |
report_types | list | — | Restrict to report types: annual (Annual and Candidate reports incl. amendments, code 7), ptr (Periodic Transaction Reports, 11), extension (Due Date Extension notices, 10), blind_trust (14), other (Other Documents, 15). Empty or absent: all. |
submitted_to | text | — | Latest date received, YYYY-MM-DD (inclusive, through 23:59:59). Default: open-ended. Pattern: ^\d{4}-\d{2}-\d{2}$. |
senator_state | text | — | Two-letter state code of the Senator's seat. Pattern: ^[A-Za-z]{2}$. |
submitted_from | text | — | Earliest date received, YYYY-MM-DD (inclusive). Default 2012-01-01, the site's minimum. Pattern: ^\d{4}-\d{2}-\d{2}$. |
candidate_state | text | — | Two-letter state code of the candidate's race. Pattern: ^[A-Za-z]{2}$. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "efdsearch-senate-gov/financial-disclosures/search_reports",
"input": {
"acknowledge_use_prohibitions": false
}
}'Frequently asked questions
How much does US Senate financial disclosures (eFD) · Search reports cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use US Senate financial disclosures (eFD) · Search reports through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "efdsearch-senate-gov/financial-disclosures/search_reports"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use US Senate financial disclosures (eFD) · Search reports?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use US Senate financial disclosures (eFD) · Search reports?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.