List Events with Filters

The GET /events endpoint supports filtering by type, category, date range, location, and more. This recipe covers the most common filter combinations.

Filter by Category

Use the types parameter with a category ID to filter events by type:

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://app.eventconnectors.nl/api/events?types=2.3.1&published=true"

const params = new URLSearchParams({
  types: "2.3.1",
  published: "true",
});

const response = await fetch(
  `https://app.eventconnectors.nl/api/events?${params}`,
  { headers: { Authorization: "Bearer YOUR_API_TOKEN" } }
);

const events = await response.json();

You can filter by multiple types using a comma-separated list: types=2.3.1,2.3.2.

Filter by Date Range

Use eventDateRangeStart and eventDateRangeEnd to filter events active within a date window. Values can be absolute dates (2025-07-01) or relative expressions (now, now+2w, now/d).

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://app.eventconnectors.nl/api/events?eventDateRangeStart=2025-07-01&eventDateRangeEnd=2025-07-31&published=true"

const params = new URLSearchParams({
  eventDateRangeStart: "2025-07-01",
  eventDateRangeEnd: "2025-07-31",
  published: "true",
});

const response = await fetch(
  `https://app.eventconnectors.nl/api/events?${params}`,
  { headers: { Authorization: "Bearer YOUR_API_TOKEN" } }
);

const events = await response.json();

Relative Date Expressions

Expression	Meaning
`now`	Current time
`now+2d`	Two days from now
`now-1w`	One week ago
`now/d`	Start of today (rounds down)
`now+1M/d`	Start of the day one month from now

Units: y (year), M (month), w (week), d (day), h (hour), m (minute).

Filter by City

Use the city parameter to filter events in a specific city:

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://app.eventconnectors.nl/api/events?city=Amsterdam&published=true"

Combining Filters

Filters are combined with AND logic. For example, to find published concerts in Amsterdam this month:

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://app.eventconnectors.nl/api/events?types=2.3.1&city=Amsterdam&eventDateRangeStart=now/M&eventDateRangeEnd=now+1M/d&published=true"

See the API Reference for the full list of query parameters on GET /events.