Skip to main content
GET
/
api
/
v1
/
events
List events
curl --request GET \
  --url https://v2.api.adj.news/api/v1/events \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "event_id": "<string>",
      "name": "<string>",
      "category": "<string>",
      "region": "<string>",
      "election_date": "2023-12-25",
      "status": "<string>",
      "markets_count": 123,
      "description": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "meta": {
    "total": 123,
    "page": 123,
    "per_page": 123,
    "total_pages": 123,
    "has_next": true,
    "has_prev": true
  }
}
List all political events (elections, races) with filtering options.

What Are Events?

Events are containers for related markets (e.g., Senate CO 2026 contains markets for Republican and Democrat wins).

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_date
datetime
Filter by election date (after). Format: ISO 8601.
end_date
datetime
Filter by election date (before). Format: ISO 8601.
page
integer
default:1
Page number.
per_page
integer
default:100
Items per page (1-500).

Response

{
  "data": [
    {
      "event_id": "senate-co-26",
      "name": "Senate CO 2026",
      "category": "senate",
      "region": "CO",
      "election_date": "2026-11-03",
      "status": "active",
      "markets_count": 2,
      "description": "Colorado Senate race 2026"
    },
    {
      "event_id": "pres-2028-party",
      "name": "2028 Presidential Election by Party",
      "category": "presidential",
      "region": "US",
      "election_date": "2028-11-03",
      "status": "active",
      "markets_count": 4,
      "description": "Which party will win the 2028 Presidential Election?"
    }
  ],
  "meta": { "total": 45, "page": 1, "per_page": 100 }
}
FieldTypeDescription
event_idstringUnique identifier
namestringHuman-readable name
categorystringEvent category
regionstringState/region code
election_datedateElection/resolution date
statusstringEvent status
markets_countintegerNumber of linked markets
descriptionstringEvent description

Examples

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

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

# Texas events
curl "https://v2.api.adj.news/api/v1/events?region=TX" \
  -H "Authorization: Bearer YOUR_TOKEN"

Authorizations

Authorization
string
header
required

Auth0 JWT Bearer token

Query Parameters

category
string

Filter by category

region
string

Filter by region/state

status
string

Filter by status

start_date
string<date-time>

Election date after

end_date
string<date-time>

Election date before

page
integer
default:1
per_page
integer
default:100
Required range: x <= 500

Response

200 - application/json

List of events

data
object[]
meta
object