This Choreo retrieves a list of the 20 top candidates in terms of contributions received. Results are filtered according to a specified category such as contribution total or debts owed. The list of available categories includes:
Candidate Loan: candidate-loan
Contribution Total: contribution-total
Debts Owed: debts-owed
Disbursements Total: disbursements-total
End Cash: end-cash
Individual Total: individual-total
PAC Total: pac-total
Receipts Total: receipts-total
Refund Total: refund-total
The Choreo makes an HTTP request to the NYTimes Campaign Finance Service, which is described at http://developer.nytimes.com/docs/campaign_finance_api#h3-candidate-leaders.
Here's an example of acceptable inputs:
APIKey: {YOUR API KEY}
CampaignCycle: 2012
Category: contribution-total
The following is a sample of the JSON information returned by this Choreo:
{
"results": [
{
"begin_cash": 2303400,
"name": "OBAMA, BARACK",
"total_from_individuals": 1.69058E8,
"date_coverage_to": "2012-04-30",
"total_disbursements": 1.09463E8,
"total_refunds": 2281500,
"end_cash": 1.15157E8,
"district": "00",
"date_coverage_from": "2011-01-01",
"relative_uri": "/candidates/P80003338.json",
"committee": "/committees/C00431445.json",
"debts_owed": 1200,
"party": "DEM",
"candidate_loans": null,
"total_from_pacs": null,
"status": "I",
"state": null,
"total_contributions": 1.69058E8
},
{
"begin_cash": 4421.95,
"name": "ROMNEY, MITT",
"total_from_individuals": 8.6776096E7,
"date_coverage_to": "2012-03-31",
"total_disbursements": 7.8387504E7,
"total_refunds": 1160620,
"end_cash": 1.00597E7,
"district": "00",
"date_coverage_from": "2011-01-01",
"relative_uri": "/candidates/P80003353.json",
"committee": "/committees/C00431171.json",
"debts_owed": null,
"party": "REP",
"candidate_loans": null,
"total_from_pacs": 623453,
"status": "C",
"state": null,
"total_contributions": 8.73996E7
},
{
"begin_cash": null,
"name": "PAUL, RON",
"total_from_individuals": 3.59026E7,
"date_coverage_to": "2012-03-31",
"total_disbursements": 3.52304E7,
"total_refunds": 157134,
"end_cash": 1780770,
"district": "00",
"date_coverage_from": "2011-01-14",
"relative_uri": "/candidates/P80000748.json",
"committee": "/committees/C00495820.json",
"debts_owed": null,
"party": "REP",
"candidate_loans": null,
"total_from_pacs": 2670.26,
"status": "C",
"state": null,
"total_contributions": 3.59052E7
},
{
"begin_cash": null,
"name": "GREENE, JEFF",
"total_from_individuals": 4036,
"date_coverage_to": "2010-12-31",
"total_disbursements": 2.38729E7,
"total_refunds": null,
"end_cash": null,
"district": "00",
"date_coverage_from": "2010-04-01",
"relative_uri": "/candidates/S0FL00486.json",
"committee": "/committees/C00482315.json",
"debts_owed": 548422,
"party": "DEM",
"candidate_loans": 250000,
"total_from_pacs": null,
"status": "O",
"state": "/seats/FL.json",
"total_contributions": 2.35421E7
},
{
"begin_cash": null,
"name": "GINGRICH, NEWT",
"total_from_individuals": 2.30582E7,
"date_coverage_to": "2012-04-30",
"total_disbursements": 2.26242E7,
"total_refunds": 125191,
"end_cash": 806951,
"district": "00",
"date_coverage_from": "2011-04-01",
"relative_uri": "/candidates/P60003654.json",
"committee": "/committees/C00496497.json",
"debts_owed": 4777010,
"party": "REP",
"candidate_loans": null,
"total_from_pacs": 72795.1,
"status": "C",
"state": null,
"total_contributions": 2.3131E7
},
{
"begin_cash": null,
"name": "RUBIO, MARCO",
"total_from_individuals": 1.93827E7,
"date_coverage_to": "2010-12-31",
"total_disbursements": 2.16383E7,
"total_refunds": 165781,
"end_cash": 103015,
"district": "00",
"date_coverage_from": "2009-01-01",
"relative_uri": "/candidates/S0FL00338.json",
"committee": "/committees/C00458844.json",
"debts_owed": 707398,
"party": "REP",
"candidate_loans": null,
"total_from_pacs": 1260750,
"status": "O",
"state": "/seats/FL.json",
"total_contributions": 2.07384E7
},
{
"begin_cash": null,
"name": "SANTORUM, RICHARD J.",
"total_from_individuals": 2.05138E7,
"date_coverage_to": "2012-03-31",
"total_disbursements": 1.89401E7,
"total_refunds": 13837.7,
"end_cash": 1804100,
"district": "00",
"date_coverage_from": "2011-04-01",
"relative_uri": "/candidates/P20002721.json",
"committee": "/committees/C00496034.json",
"debts_owed": 1989930,
"party": "REP",
"candidate_loans": 20000,
"total_from_pacs": 65424.1,
"status": "C",
"state": null,
"total_contributions": 2.05793E7
},
{
"begin_cash": null,
"name": "PERRY, JAMES R (RICK)",
"total_from_individuals": 2.00477E7,
"date_coverage_to": "2012-04-30",
"total_disbursements": 2.01238E7,
"total_refunds": 612550,
"end_cash": 417207,
"district": "00",
"date_coverage_from": "2011-07-01",
"relative_uri": "/candidates/P20003281.json",
"committee": "/committees/C00500587.json",
"debts_owed": 14463.7,
"party": "REP",
"candidate_loans": null,
"total_from_pacs": 261129,
"status": "C",
"state": null,
"total_contributions": 2.03089E7
},
{
"begin_cash": 3316350,
"name": "REID, HARRY",
"total_from_individuals": 1.38255E7,
"date_coverage_to": "2010-12-31",
"total_disbursements": 2.25486E7,
"total_refunds": 114613,
"end_cash": 160606,
"district": "00",
"date_coverage_from": "2009-01-01",
"relative_uri": "/candidates/S6NV00028.json",
"committee": "/committees/C00204370.json",
"debts_owed": 319091,
"party": "DEM",
"candidate_loans": 99750,
"total_from_pacs": 3513430,
"status": "I",
"state": "/seats/NV.json",
"total_contributions": 1.73816E7
},
{
"begin_cash": null,
"name": "TOOMEY, PATRICK JOSEPH",
"total_from_individuals": 1.49003E7,
"date_coverage_to": "2010-12-31",
"total_disbursements": 1.69981E7,
"total_refunds": 69143,
"end_cash": 196673,
"district": "00",
"date_coverage_from": "2009-04-01",
"relative_uri": "/candidates/S4PA00121.json",
"committee": "/committees/C00461046.json",
"debts_owed": null,
"party": "REP",
"candidate_loans": 53000,
"total_from_pacs": 1621780,
"status": "C",
"state": "/seats/PA.json",
"total_contributions": 1.65768E7
},
{
"begin_cash": 1.05711E7,
"name": "SCHUMER, CHARLES E",
"total_from_individuals": 1.36294E7,
"date_coverage_to": "2010-12-31",
"total_disbursements": 1.81438E7,
"total_refunds": 71600,
"end_cash": 1.01921E7,
"district": "00",
"date_coverage_from": "2009-01-01",
"relative_uri": "/candidates/S8NY00082.json",
"committee": "/committees/C00346312.json",
"debts_owed": null,
"party": "DEM",
"candidate_loans": null,
"total_from_pacs": 2905310,
"status": "I",
"state": "/seats/NY.json",
"total_contributions": 1.65347E7
},
{
"begin_cash": null,
"name": "CAIN, HERMAN",
"total_from_individuals": 1.60229E7,
"date_coverage_to": "2012-03-31",
"total_disbursements": 1.67464E7,
"total_refunds": 52933.3,
"end_cash": 41860.5,
"district": "00",
"date_coverage_from": "2010-12-27",
"relative_uri": "/candidates/P00003608.json",
"committee": "/committees/C00496067.json",
"debts_owed": 450000,
"party": "REP",
"candidate_loans": 675000,
"total_from_pacs": 19332.1,
"status": "C",
"state": null,
"total_contributions": 1.60504E7
},
{
"begin_cash": null,
"name": "WARREN, ELIZABETH",
"total_from_individuals": 1.53657E7,
"date_coverage_to": "2012-03-31",
"total_disbursements": 4882440,
"total_refunds": 92826,
"end_cash": 1.096E7,
"district": "00",
"date_coverage_from": "2011-08-16",
"relative_uri": "/candidates/S2MA00170.json",
"committee": "/committees/C00500843.json",
"debts_owed": null,
"party": "DEM",
"candidate_loans": null,
"total_from_pacs": 307338,
"status": "C",
"state": "/seats/MA.json",
"total_contributions": 1.56731E7
},
{
"begin_cash": 79868.4,
"name": "KIRK, MARK STEVEN",
"total_from_individuals": 1.17369E7,
"date_coverage_to": "2010-12-31",
"total_disbursements": 1.41468E7,
"total_refunds": 129774,
"end_cash": 305799,
"district": "00",
"date_coverage_from": "2009-01-01",
"relative_uri": "/candidates/S0IL00261.json",
"committee": "/committees/C00350785.json",
"debts_owed": null,
"party": "REP",
"candidate_loans": null,
"total_from_pacs": 2364140,
"status": "O",
"state": "/seats/IL.json",
"total_contributions": 1.41446E7
},
{
"begin_cash": 2516120,
"name": "FEINGOLD, RUSSELL D",
"total_from_individuals": 1.26889E7,
"date_coverage_to": "2010-12-31",
"total_disbursements": 1.55441E7,
"total_refunds": 82959,
"end_cash": 919585,
"district": "00",
"date_coverage_from": "2009-01-01",
"relative_uri": "/candidates/S8WI00026.json",
"committee": null,
"debts_owed": null,
"party": "DEM",
"candidate_loans": null,
"total_from_pacs": 973127,
"status": "I",
"state": "/seats/WI.json",
"total_contributions": 1.37078E7
},
{
"begin_cash": null,
"name": "FIORINA, CARLY",
"total_from_individuals": 1.1629E7,
"date_coverage_to": "2010-12-31",
"total_disbursements": 2.26359E7,
"total_refunds": 76771,
"end_cash": null,
"district": "00",
"date_coverage_from": "2009-08-18",
"relative_uri": "/candidates/S0CA00330.json",
"committee": "/committees/C00469924.json",
"debts_owed": null,
"party": "REP",
"candidate_loans": 6789500,
"total_from_pacs": 935015,
"status": "C",
"state": "/seats/CA.json",
"total_contributions": 1.26203E7
},
{
"begin_cash": 1860480,
"name": "BACHMANN, MICHELE",
"total_from_individuals": 1.24644E7,
"date_coverage_to": "2012-03-31",
"total_disbursements": 1.58019E7,
"total_refunds": 40055,
"end_cash": 893557,
"district": "06",
"date_coverage_from": "2011-01-01",
"relative_uri": "/candidates/H6MN06074.json",
"committee": "/committees/C00410118.json",
"debts_owed": 1068570,
"party": "REP",
"candidate_loans": null,
"total_from_pacs": 44535,
"status": "I",
"state": "/seats/MN.json",
"total_contributions": 1.2509E7
},
{
"begin_cash": 1860480,
"name": "BACHMANN, MICHELE",
"total_from_individuals": 1.24644E7,
"date_coverage_to": "2012-03-31",
"total_disbursements": 1.58019E7,
"total_refunds": 40055,
"end_cash": 893557,
"district": "00",
"date_coverage_from": "2011-01-01",
"relative_uri": "/candidates/P20002978.json",
"committee": null,
"debts_owed": 1068570,
"party": "REP",
"candidate_loans": null,
"total_from_pacs": 44535,
"status": "C",
"state": null,
"total_contributions": 1.2509E7
},
{
"begin_cash": null,
"name": "CRIST, CHARLIE",
"total_from_individuals": 1.26324E7,
"date_coverage_to": "2010-12-31",
"total_disbursements": 1.36087E7,
"total_refunds": 221328,
"end_cash": 71745,
"district": "00",
"date_coverage_from": "2009-05-12",
"relative_uri": "/candidates/S6FL00160.json",
"committee": "/committees/C00462135.json",
"debts_owed": 3819,
"party": "NNE",
"candidate_loans": null,
"total_from_pacs": 622291,
"status": "O",
"state": "/seats/FL.json",
"total_contributions": 1.24455E7
},
{
"begin_cash": null,
"name": "BENNET, MICHAEL F",
"total_from_individuals": 9853250,
"date_coverage_to": "2010-12-31",
"total_disbursements": 1.30823E7,
"total_refunds": 58775,
"end_cash": 155517,
"district": "00",
"date_coverage_from": "2009-01-01",
"relative_uri": "/candidates/S0CO00211.json",
"committee": "/committees/C00458398.json",
"debts_owed": 530000,
"party": "DEM",
"candidate_loans": 800000,
"total_from_pacs": 2023780,
"status": "I",
"state": "/seats/CO.json",
"total_contributions": 1.18832E7
}
],
"category": null,
"base_uri": "http://api.nytimes.com/svc/elections/us/v3/finances/2012/",
"copyright": "Copyright (c) 2012 The New York Times Company. All Rights Reserved.",
"cycle": 2012,
"status": "OK"
}