Data dictionaries

Endorser track record

How the choices one endorser backed did: contests, picks, wins, losses, win rate and average vote share, in total and by contest kind, election stage and election.

Returned by

GET /v1/endorsers/{slug}/record

Shapes

The full record is in GET /v1/endorsers/{slug}/record. The shorter forms in each set of counts leave some fields out; a field that isn’t in every form says where it is.

How it connects

• Worked out from the endorser’s endorsements and each endorsed choice’s result (votes, vote_pct, winner), so it only counts contests you can read.
• The same eleven counts repeat in totals and in each row of by_kind, by_stage and elections.

Good to know

• Only top picks count: a ranked-choice endorsement’s first choice, every candidate of a vote-for-N slate, and the Yes or No on a measure. picks can therefore be more than contests.
• A pick is undecided until its choice’s result.winner is true or false: no result yet, a party-reported result with no counts, or a runoff still to come.
• win_rate describes the endorser’s picks. It does not show that an endorsement changed an outcome: endorsers often back incumbents and favorites, which is why incumbent_picks and non_incumbent_picks are counted apart.
• In a primary, won means the candidate advanced or was nominated.

Fields

Download every dictionary as CSV or JSON.

Sample (JSON)

One endorser track record as the API returns it, in GET /v1/endorsers/{slug}/record. More in the sample data.

{
  "endorser": {
    "id": 512,
    "slug": "sf-labor-council",
    "name": "San Francisco Labor Council",
    "category": {
      "slug": "labor",
      "name": "Labor"
    },
    "state": "CA"
  },
  "totals": {
    "contests": 84,
    "picks": 97,
    "won": 61,
    "lost": 22,
    "undecided": 14,
    "win_rate": 0.735,
    "avg_vote_pct": 54.812,
    "incumbent_picks": 31,
    "incumbent_won": 29,
    "non_incumbent_picks": 58,
    "non_incumbent_won": 28
  },
  "by_kind": [
    {
      "kind": "candidate",
      "contests": 66,
      "picks": 79,
      "won": 47,
      "lost": 20,
      "undecided": 12,
      "win_rate": 0.701,
      "avg_vote_pct": 52.307,
      "incumbent_picks": 31,
      "incumbent_won": 29,
      "non_incumbent_picks": 58,
      "non_incumbent_won": 28
    },
    {
      "kind": "measure",
      "contests": 18,
      "picks": 18,
      "won": 14,
      "lost": 2,
      "undecided": 2,
      "win_rate": 0.875,
      "avg_vote_pct": 63.918,
      "incumbent_picks": 0,
      "incumbent_won": 0,
      "non_incumbent_picks": 0,
      "non_incumbent_won": 0
    }
  ],
  "by_stage": [
    {
      "stage": "primary",
      "contests": 30,
      "picks": 34,
      "won": 21,
      "lost": 12,
      "undecided": 1,
      "win_rate": 0.636,
      "avg_vote_pct": 47.551,
      "incumbent_picks": 11,
      "incumbent_won": 11,
      "non_incumbent_picks": 20,
      "non_incumbent_won": 9
    },
    {
      "stage": "general",
      "contests": 54,
      "picks": 63,
      "won": 40,
      "lost": 10,
      "undecided": 13,
      "win_rate": 0.8,
      "avg_vote_pct": 58.649,
      "incumbent_picks": 20,
      "incumbent_won": 18,
      "non_incumbent_picks": 38,
      "non_incumbent_won": 19
    }
  ],
  "elections": [
    {
      "election": {
        "slug": "ca-2026-11-03-general",
        "name": "California General Election",
        "date": "2026-11-03",
        "type": "general"
      },
      "contests": 54,
      "picks": 63,
      "won": 40,
      "lost": 10,
      "undecided": 13,
      "win_rate": 0.8,
      "avg_vote_pct": 58.649,
      "incumbent_picks": 20,
      "incumbent_won": 18,
      "non_incumbent_picks": 38,
      "non_incumbent_won": 19
    },
    {
      "election": {
        "slug": "ca-2026-06-02-primary",
        "name": "California Primary Election",
        "date": "2026-06-02",
        "type": "primary"
      },
      "contests": 30,
      "picks": 34,
      "won": 21,
      "lost": 12,
      "undecided": 1,
      "win_rate": 0.636,
      "avg_vote_pct": 47.551,
      "incumbent_picks": 11,
      "incumbent_won": 11,
      "non_incumbent_picks": 20,
      "non_incumbent_won": 9
    }
  ]
}

endorser_slug,election_slug,election_name,election_date,election_type,contests,picks,won,lost,undecided,win_rate,avg_vote_pct,incumbent_picks,incumbent_won,non_incumbent_picks,non_incumbent_won
sf-labor-council,ca-2026-11-03-general,California General Election,2026-11-03,general,54,63,40,10,13,0.8,58.649,20,18,38,19
sf-labor-council,ca-2026-06-02-primary,California Primary Election,2026-06-02,primary,30,34,21,12,1,0.636,47.551,11,11,20,9