List events

get

https://connect.eventtia.com/api/v3/events

Returns a paginated list of events accessible by the authenticated user. Events are scoped to the user's account and filtered by the user's event-level permissions. Supports sorting via the order parameter and incremental sync via updated_since. Default sort is start_date desc.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

page[number]

integer

Page number (default: 1)

page[size]

integer

Page size (max: 24, default: 24)

order

string

Sort field and direction (e.g. 'start_date desc', 'name asc')

updated_since

string

ISO 8601 datetime -- only return events updated after this timestamp

include

string

Comma-separated relationships to include (e.g. 'attendee_types,account')

name

string

Filter by event name (partial match)

status

string

Filter by time status: 1 (upcoming), 2 (ongoing), 3 (past), 4 (current and upcoming), 5 (recent + current + upcoming)

city_id

integer

Filter by city ID

country_id

integer

Filter by country ID (joins through city)

administrative_area_id

string

Comma-separated administrative area IDs to filter by

start_date_upper_bound

string

Only events with start_date on or before this value (ISO 8601)

start_date_lower_bound

string

Only events with start_date on or after this value (ISO 8601)

end_date_upper_bound

string

Only events with end_date on or before this value (ISO 8601)

end_date_lower_bound

string

Only events with end_date on or after this value (ISO 8601)

date_range_start

string

Start of a date range filter (ISO 8601). Must be used with date_range_end

date_range_end

string

End of a date range filter (ISO 8601). Must be used with date_range_start

active_status

string

Filter by active flag (true or false)

attendance_mode

string

Filter by attendance mode

event_group_id

integer

Filter by event group ID

created_by_id

integer

Filter events created by a specific user ID

template

integer

Filter events cloned from a specific template event ID

excluded_ids

string

Comma-separated event IDs to exclude from results

Responses

401

Unauthorized - missing or invalid token

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Paginated list of events