> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "List events"
description: "Get all political events with filtering"
api: "GET /api/v1/events"
gridGap: 30
---

<Aside full>
  <RequestExample>
    ```bash title="cURL" lines=false
    curl -X GET "https://api.adjacent.markets/api/v1/events" \
      -H "Authorization: Bearer <token>"
    ```
  </RequestExample>
</Aside>

<OpenAPIEndpoint {...{"method":"get","path":"/api/v1/events","summary":"List events","description":"Get all political events with filtering","parameters":[{"name":"category","in":"query","description":"Filter by category","schema":{"type":"string"}},{"name":"region","in":"query","description":"Filter by region/state","schema":{"type":"string"}},{"name":"start","in":"query","description":"Election date after","schema":{"type":"string","format":"date-time"}},{"name":"end","in":"query","description":"Election date before","schema":{"type":"string","format":"date-time"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":[{"status":"200","description":"List of events","schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"event_id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"region":{"type":["string","null"]},"election_date":{"type":["string","null"],"format":"date"},"markets_count":{"type":"integer"},"description":{"type":["string","null"]},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"total_pages":{"type":"integer"},"has_next":{"type":"boolean"},"has_prev":{"type":"boolean"}}}}},"examples":[]}],"security":[{"name":"bearerAuth","type":"http","scheme":"bearer","in":"header","description":"Clerk JWT Bearer token"}],"servers":[{"url":"https://api.adjacent.markets","description":"API server"}]}} />