Skip to main content
GET
/
v1
/
prediction
/
candidates
/
{candidateId}
/
totals
Get candidate totals
curl --request GET \
  --url https://api.aries.com/v1/prediction/candidates/{candidateId}/totals
{
  "pagination": {
    "page": 1,
    "perPage": 20,
    "pages": 1,
    "count": 1
  },
  "results": [
    {
      "candidateId": "H0CA12034",
      "cycle": 2024,
      "electionFull": false,
      "coverageStartDate": "2024-01-01",
      "coverageEndDate": "2024-03-31",
      "receipts": 4200000.78,
      "disbursements": 3150000.45,
      "individualContributions": 2500000.12,
      "individualItemizedContributions": 1900000.33,
      "individualUnitemizedContributions": 600000,
      "otherPoliticalCommitteeContributions": 210000,
      "politicalPartyCommitteeContributions": 85000,
      "candidateContribution": 50000,
      "operatingExpenditures": 2750000,
      "contributionRefunds": 12000,
      "loansReceived": 250000,
      "debtsOwedByCommittee": 120000.5,
      "debtsOwedToCommittee": 10000,
      "cashOnHandBeginningPeriod": 1400000,
      "cashOnHandEndPeriod": 2450000.12,
      "federalFunds": 0,
      "transfersFromOtherAuthorizedCommittee": 50000,
      "transfersToOtherAuthorizedCommittee": 10000,
      "netContributions": 4150000.78,
      "netOperatingExpenditures": 2738000,
      "offsetsToOperatingExpenditures": 5000,
      "lastReportYear": 2024,
      "lastReportTypeFull": "Quarterly report",
      "lastCashOnHandEndPeriod": 2450000.12,
      "lastDebtsOwedByCommittee": 120000.5
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Parameter notes

  • candidateId path parameter is required.
  • Use sortOrder only with sortBy; valid sort orders are ascending and descending.
  • perPage maps to upstream per_page, and electionFull maps to upstream election_full.

Path Parameters

​
candidateId
string
required

Candidate identifier.

Query Parameters

​
page
integer | null

Page number for pagination.

​
perPage
integer | null

Number of results to return per page.

​
electionFull
boolean | null

When true, return the full election period instead of a single two-year cycle.

​
cycle
integer[]

Filter by one or more filing cycles.

​
sortBy
enum<string> | null

Field to sort by.

Available options:
cycle,
receipts,
disbursements,
coverageStartDate,
coverageEndDate,
individualContributions,
individualItemizedContributions,
individualUnitemizedContributions,
otherPoliticalCommitteeContributions,
politicalPartyCommitteeContributions,
candidateContribution,
operatingExpenditures,
contributionRefunds,
loansReceived,
debtsOwedByCommittee,
debtsOwedToCommittee,
cashOnHandBeginningPeriod,
cashOnHandEndPeriod,
federalFunds,
transfersFromOtherAuthorizedCommittee,
transfersToOtherAuthorizedCommittee,
netContributions,
netOperatingExpenditures,
offsetsToOperatingExpenditures,
lastReportYear,
lastReportTypeFull,
lastCashOnHandEndPeriod,
lastDebtsOwedByCommittee,
candidateId
​
sortOrder
enum<string> | null

Sort direction.

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 null values after non-null values when sorting.

Response

Successful response

​
pagination
object
​
results
object[]