Endorsement history
One change to one endorsement: created, updated or deleted, with its values before and after.
- Returned by
GET /v1/endorsements/{id}/history
Good to know
- We have kept history since October 27, 2026. For an endorsement collected before then, the created entry’s time is when we collected it.
choice_labelisnullif the choice has since been removed from the ballot.
Fields
| Field | Type | Meaning | Example |
|---|---|---|---|
at | stringISO 8601 date and time with time zone | When the change was made. For endorsements collected before we kept history (October 27, 2026), created is when we collected it. | 2026-09-19T04:12:08.331Z |
change | string | What happened to the endorsement: created, updated or deleted.created, updated, deleted meanings | created |
changed | array of string | For updated: the fields that changed. Empty otherwise.choice_id, rank, statement, source_url, published_on meanings | ["rank"] |
before | objector null | The values before the change; null for created. | — |
before.choice_id | integer | The choice endorsed. | 20931 |
before.choice_label | stringor null | That choice’s label as printed; null if the choice has since been removed from the ballot. | Jane Doe |
before.rank | integeror null | Ranked choice: the rank; null otherwise. | 2 |
before.statement | stringor null | What the endorser said. | — |
before.source_url | stringor nullURL | Where it was published. | https://sflaborcouncil.org/endorsements |
before.published_on | stringor nullYYYY-MM-DD | When it was published. | 2026-09-18 |
after | objector null | The values after the change; null for deleted. | — |
after.choice_id | integer | The choice endorsed. | 20931 |
after.choice_label | stringor null | That choice’s label as printed; null if the choice has since been removed from the ballot. | Jane Doe |
after.rank | integeror null | Ranked choice: the rank; null otherwise. | 2 |
after.statement | stringor null | What the endorser said. | — |
after.source_url | stringor nullURL | Where it was published. | https://sflaborcouncil.org/endorsements |
after.published_on | stringor nullYYYY-MM-DD | When it was published. | 2026-09-18 |