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 \
  --header 'Authorization: Bearer <token>'
{
  "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
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

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
​
sortOrder
enum<string> | null

Sort direction.

Available options:
ascending
​
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[]