Skip to main content
GET
/
v1
/
prediction
/
independent-expenditures
List independent expenditures
curl --request GET \
  --url https://api.aries.com/v1/prediction/independent-expenditures \
  --header 'Authorization: Bearer <token>'
{ "pagination": { "pages": 1, "perPage": 20, "count": 1, "isCountExact": true, "lastIndexes": { "lastIndex": "1704067200|789012", "sortNullOnly": false } }, "results": [ { "actionCode": "E", "actionCodeFull": "Independent expenditure", "amendmentIndicator": "N", "amendmentNumber": 0, "candidateId": "P80001571", "candidateName": "Jordan Lee", "candidateOffice": "P", "candidateParty": "DEM", "committeeId": "C00765432", "disseminationDate": "2024-10-15", "electionType": "G", "electionTypeFull": "General", "expenditureAmount": 50000, "expenditureDate": "2024-10-14", "expenditureDescription": "Television advertising", "filingDate": "2024-10-15", "filingForm": "F5", "formLineNumber": "24E", "imageNumber": "202410159612345680", "isNotice": true, "memoedSubtotal": false, "mostRecent": true, "officeTotalYtd": 1250000, "payeeName": "Broadcast Media LLC", "pdfUrl": "https://example.com/independent-expenditure.pdf", "reportType": "24", "reportYear": 2024, "scheduleType": "SE", "subId": "3234567890", "supportOpposeIndicator": "S", "transactionId": "SE24E.98765" } ] }

Parameter notes

  • Use candidateOffice values H, S, or P.
  • Use three-letter party codes in candidateParty, such as DEM or REP.
  • Use candidateOfficeDistrict as a two-digit string. Send 00 for President, Senate, or at-large House seats.
  • When paginating sorted results, send lastIndex with the matching lastExpenditureDate, lastExpenditureAmount, lastOfficeTotalYtd, or lastSupportOpposeIndicator value from the previous response.

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

imageNumber
string[]

Unique image number for the page where the filing item appears.

minImageNumber
string | null

Lowest image number to include when filtering filing pages.

maxImageNumber
string | null

Highest image number to include when filtering filing pages.

minAmount
number | null

Return only records with an expenditure amount greater than or equal to this value.

maxAmount
number | null

Return only records with an expenditure amount less than or equal to this value.

minDate
string | null

Earliest reporting date to include. Only records after this date are returned.

maxDate
string | null

Latest reporting date to include. Only records before this date are returned.

candidateOffice
string[]

Federal office the candidate is running for. Use H for House, S for Senate, or P for President.

candidateParty
string[]

Three-letter party code for the candidate, such as DEM or REP.

candidateOfficeState
string[]

Two-letter state or territory code for the candidate office, such as CA or TX.

candidateOfficeDistrict
string[]

Two-digit House district for the office the candidate is running for. Use 00 for President, Senate, or at-large House candidates.

cycle
integer[]

Two-year election cycle. Use the ending even year, for example 2024 for the 2023-2024 cycle.

committeeId
string[]

Committee or filer ID. These typically start with C followed by eight digits.

candidateId
string[]

Candidate ID. The first letter indicates office (P, H, or S), followed by cycle and location information.

filingForm
string[]

Underlying filing form for the record, such as F5 or F24.

lastExpenditureDate
string | null

When paging results sorted by expenditureDate, send the expenditureDate value from the last row of the previous page together with lastIndex.

lastExpenditureAmount
number | null

When paging results sorted by expenditureAmount, send the expenditureAmount value from the last row of the previous page together with lastIndex.

lastOfficeTotalYtd
number | null

When paging results sorted by officeTotalYtd, send the officeTotalYtd value from the last row of the previous page together with lastIndex.

payeeName
string[]

Name of the person or entity that received the payment.

supportOpposeIndicator
string[]

Whether the spending supports or opposes a candidate. Use S for support or O for oppose.

lastSupportOpposeIndicator
string | null

When paging results sorted by supportOpposeIndicator, send the supportOpposeIndicator value from the last row of the previous page together with lastIndex.

isNotice
boolean[]

Whether the filing was submitted as a 24-hour or 48-hour notice.

minDisseminationDate
string | null

Return only records distributed after this date.

maxDisseminationDate
string | null

Return only records distributed before this date.

minFilingDate
string | null

Return only filings received after this date.

maxFilingDate
string | null

Return only filings received before this date.

mostRecent
boolean | null

When true, limit results to records from the newest filing or most recently filed amendment.

spenderKeywords
string[]

Keyword search across spender name or spender ID.

formLineNumber
string[]

Form and line number in FORM-LINENUMBER format, for example F24-24E.

perPage
integer | null

Number of results to return per page. Defaults to 20.

lastIndex
string | null

Keyset cursor from pagination.lastIndexes.lastIndex in the previous response.

sortBy
enum<string> | null

Field used for sorting and keyset pagination. Wrapper-supported values are expenditureDate, expenditureAmount, and loadDate.

Available options:
expenditureDate,
expenditureAmount,
loadDate
sortOrder
enum<string> | null

Sort direction. Use ascending or descending. If omitted, descending order is used.

Available options:
ascending,
descending
sortHideNull
boolean | null

Hide rows where the sorted field is null.

sortNullOnly
boolean | null

Return only rows where the sorted field is null.

sortNullsLast
boolean | null

Place rows with null sort values after non-null values.

Response

Successful response

pagination
object
results
object[]