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