Skip to main content
Export a filtered list of events as CSV or TSV.

Path Parameters

ext
string
required
File format: csv or tsv.

Query Parameters

category
string
Filter by category: presidential, senate, house, governor, mayoral.
region
string
Filter by region/state (e.g., US, CO, TX).
status
string
Filter by status: active, resolved.
start
datetime
Filter by election date (after). Format: ISO 8601.
end
datetime
Filter by election date (before). Format: ISO 8601.

Response

Returns a file download with Content-Disposition: attachment. Max 10,000 rows. Columns: event_id, name, category, region, election_date, status, markets_count

Examples

# All events as CSV
curl -O "https://v2.api.adj.news/api/v1/export/events.csv" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Senate events as TSV
curl -O "https://v2.api.adj.news/api/v1/export/events.tsv?category=senate" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Save to file
curl "https://v2.api.adj.news/api/v1/export/events.csv?region=TX" \
  -H "Authorization: Bearer YOUR_TOKEN" -o texas_events.csv

Errors

StatusDescription
400Invalid format
401Missing or invalid authorization