FEC
Federal Election Commission itemized individual contributions (over $200) to federal candidates, parties and PACs, searched by donor name: donor name, address, employer and occupation, amount and date, recipient committee and candidate, earmark memo, and a link to the filing image.
Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.
- Site:
fec - Version:
1.0.0 - Reads from:
fec.gov
| Action | Description | Listed price |
|---|---|---|
contributions | Search FEC itemized contributions by donor name within one two-year election cycle, optionally narrowed by state, city, ZIP, employer or occupation. Each row is one contribution, newest first: donor name, address, employer and occupation, amount, date and year-to-date total, the recipient committee with its type, party and candidate, the receipt type and earmark memo, and the filing image link. 100 a page. | Billed per request at your plan's rates |
contributions
Search FEC itemized contributions by donor name within one two-year election cycle, optionally narrowed by state, city, ZIP, employer or occupation. Each row is one contribution, newest first: donor name, address, employer and occupation, amount, date and year-to-date total, the recipient committee with its type, party and candidate, the receipt type and earmark memo, and the filing image link. 100 a page.
POST https://request.usestring.ai/v1/integrations/fec/contributionsInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
name | string | Required. The donor's name. LAST, FIRST (such as BUFFETT, WARREN) matches that phrase in the filed name; a surname alone matches every donor carrying it. At least 2 characters. At most 100 characters. |
cycle | integer | The two-year election cycle, named by its even end year such as 2024. Defaults to the current cycle. The FEC times out a name search across all cycles, so one is always sent. At least 1980. |
state | string | Two-letter state of the donor's address, such as NE. Matches ^[A-Za-z]{2}$. |
city | string | City of the donor's address. |
zip | string | ZIP code or its first digits. Matches ^[0-9]{1,9}$. |
employer | string | Words in the employer the donor reported. |
occupation | string | Words in the occupation the donor reported. |
pages | integer | How many pages of 100 contributions to read, newest first, from 1. From 1 to 10. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
subId | string | The FEC's unique id for this line of the filing. |
transactionId | string | null | The filer's own id for the transaction. |
contributorName | string | The donor as filed, LAST, FIRST with any middle name and suffix. |
contributorFirstName | string | null | — |
contributorMiddleName | string | null | — |
contributorLastName | string | null | — |
contributorStreet1 | string | null | — |
contributorStreet2 | string | null | — |
contributorCity | string | null | — |
contributorState | string | null | — |
contributorZip | string | null | — |
contributorEmployer | string | null | — |
contributorOccupation | string | null | — |
entityType | string | null | IND for an individual; ORG, PAC, CCM and others for the rest. |
entityTypeDesc | string | null | — |
amount | number | contribution_receipt_amount, in US dollars. |
date | string | null | contribution_receipt_date, YYYY-MM-DD. |
aggregateYtd | number | null | The donor's total to this committee in the election year so far, as filed. |
committeeId | string | The recipient committee's FEC id. |
committeeName | string | null | — |
committeeType | string | null | committee_type_full, such as PAC - Nonqualified or House. |
committeeDesignation | string | null | designation_full, such as Principal campaign committee or Joint fundraising committee. |
committeeParty | string | null | party_full of the committee, when it has one. |
committeeState | string | null | — |
candidateId | string | null | — |
candidateName | string | null | — |
candidateOffice | string | null | candidate_office_full, such as House, Senate or President. |
candidateOfficeState | string | null | — |
receiptType | string | null | The FEC receipt type code, such as 15E for an earmarked contribution. |
receiptTypeDesc | string | null | — |
memoText | string | null | The filer's memo, such as EARMARKED FOR <committee> for a conduit contribution. |
electionType | string | null | fec_election_type_desc, such as PRIMARY or GENERAL. |
reportType | string | null | The report the line was filed on, such as Q3 or 30G. |
reportYear | integer | null | — |
cycle | integer | two_year_transaction_period. |
filingForm | string | null | — |
imageNumber | string | null | — |
pdfUrl | string | null | The page of the filing this line is on. |
loadDate | string | null | When the FEC loaded the line. |
Example
curl https://request.usestring.ai/v1/integrations/fec/contributions \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "buffett",
"cycle": 2024,
"state": "NE"
}'data starts with these rows:
[
{
"subId": "4121720241080092321",
"transactionId": "SA11AI_661551550",
"contributorName": "BUFFETT-KENNEDY, NOAH",
"contributorFirstName": "NOAH",
"contributorMiddleName": null,
"contributorLastName": "BUFFETT-KENNEDY",
"contributorStreet1": "616 FAIRACRES RD",
"contributorStreet2": null,
"contributorCity": "OMAHA",
"contributorState": "NE",
"contributorZip": "68132",
"contributorEmployer": "SELF",
"contributorOccupation": "LAWYER",
"entityType": "IND",
"entityTypeDesc": "INDIVIDUAL",
"amount": 500,
"date": "2024-10-22",
"aggregateYtd": 500,
"committeeId": "C00401224",
"committeeName": "ACTBLUE",
"committeeType": "Hybrid PAC (with Non-Contribution Account) - Nonqualified",
"committeeDesignation": "Unauthorized",
"committeeParty": null,
"committeeState": "MA",
"candidateId": null,
"candidateName": null,
"candidateOffice": null,
"candidateOfficeState": null,
"receiptType": "24T",
"receiptTypeDesc": "EARMARKED INTERMEDIARY TREASURY OUT",
"memoText": "EARMARKED FOR HARRIS VICTORY FUND (C00744946)",
"electionType": "PRIMARY",
"reportType": "30G",
"reportYear": 2024,
"cycle": 2024,
"filingForm": "F3X",
"imageNumber": "202412059721889488",
"pdfUrl": "https://docquery.fec.gov/cgi-bin/fecimg/?202412059721889488",
"loadDate": "2024-12-18T03:05:56"
}
]Requests and billing
- Requests: 1–3 Web Access requests per result page.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
X (Twitter)
X (Twitter) profiles with bio, location, website and pinned post, an account's posts with permalinks and exact timestamps, its archived older posts and replies, and single posts by ID or URL, read signed out.
ProPublica Nonprofit Explorer
ProPublica Nonprofit Explorer, built on IRS Form 990 filings: people listed as officers, directors, trustees and key employees, with title, organization, city, filing year and compensation; a nonprofit's profile and yearly revenue, expenses, assets and officer pay by EIN; and nonprofit search by name.