String docs
Site integrations

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
ActionDescriptionListed price
contributionsSearch 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/contributions

Input

Unknown fields are rejected.

FieldTypeDescription
namestringRequired. 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.
cycleintegerThe 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.
statestringTwo-letter state of the donor's address, such as NE. Matches ^[A-Za-z]{2}$.
citystringCity of the donor's address.
zipstringZIP code or its first digits. Matches ^[0-9]{1,9}$.
employerstringWords in the employer the donor reported.
occupationstringWords in the occupation the donor reported.
pagesintegerHow 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:

FieldTypeDescription
subIdstringThe FEC's unique id for this line of the filing.
transactionIdstring | nullThe filer's own id for the transaction.
contributorNamestringThe donor as filed, LAST, FIRST with any middle name and suffix.
contributorFirstNamestring | null—
contributorMiddleNamestring | null—
contributorLastNamestring | null—
contributorStreet1string | null—
contributorStreet2string | null—
contributorCitystring | null—
contributorStatestring | null—
contributorZipstring | null—
contributorEmployerstring | null—
contributorOccupationstring | null—
entityTypestring | nullIND for an individual; ORG, PAC, CCM and others for the rest.
entityTypeDescstring | null—
amountnumbercontribution_receipt_amount, in US dollars.
datestring | nullcontribution_receipt_date, YYYY-MM-DD.
aggregateYtdnumber | nullThe donor's total to this committee in the election year so far, as filed.
committeeIdstringThe recipient committee's FEC id.
committeeNamestring | null—
committeeTypestring | nullcommittee_type_full, such as PAC - Nonqualified or House.
committeeDesignationstring | nulldesignation_full, such as Principal campaign committee or Joint fundraising committee.
committeePartystring | nullparty_full of the committee, when it has one.
committeeStatestring | null—
candidateIdstring | null—
candidateNamestring | null—
candidateOfficestring | nullcandidate_office_full, such as House, Senate or President.
candidateOfficeStatestring | null—
receiptTypestring | nullThe FEC receipt type code, such as 15E for an earmarked contribution.
receiptTypeDescstring | null—
memoTextstring | nullThe filer's memo, such as EARMARKED FOR <committee> for a conduit contribution.
electionTypestring | nullfec_election_type_desc, such as PRIMARY or GENERAL.
reportTypestring | nullThe report the line was filed on, such as Q3 or 30G.
reportYearinteger | null—
cycleintegertwo_year_transaction_period.
filingFormstring | null—
imageNumberstring | null—
pdfUrlstring | nullThe page of the filing this line is on.
loadDatestring | nullWhen 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.