---
title: "/events"
method: GET
path: "/events"
---

# /events

`GET /events`

## Request

- Base URL: `https://api.securevan.com/v4`
- URL: `https://api.securevan.com/v4/events`
- Auth: HTTP basic

Find Events

*Description*

Use this endpoint to find Events available in the current context using a number of filter options.

*Request*

This endpoint accepts [standard pagination parameters](https://everyaction.readme.io/reference#pagination) and returns a standard paginated response.

By default, this endpoint returns 10 records per request. A maximum of 50 records per request is allowed via the `$top` parameter.

Valid [expansion](https://everyaction.readme.io/reference#expansion) properties are: `locations`, `codes`, `shifts`, `roles`, `notes`. Note that the number of `$expand` sections requested may impact the speed with which this endpoint will respond.

The endpoint takes the optional filter parameters as described below

## Query parameters

- `codeIds` string
- `eventTypeIds` string
- `inRepetitionWithEventId` integer
- `startingAfter` string, date
- `startingBefore` string, date
- `districtFieldValue` string
- `createdByCommitteeId` integer
- `$expand` string
- `$top` integer

## Response `200`

200

- object
  - `items` object[]
    - `eventId` integer
    - `name` string
    - `shortName` string
    - `description` string
    - `startDate` string
    - `endDate` string
    - `eventType` object
      - `eventTypeId` integer
      - `name` string
    - `isOnlyEditableByCreatingUser` boolean
    - `isPubliclyViewable` unknown
    - `locations` unknown
    - `codes` unknown
    - `notes` unknown
    - `shifts` object[]
      - `eventShiftId` integer
      - `name` string
      - `startTime` string
      - `endTime` string
    - `roles` unknown
    - `districtFieldValue` string
    - `voterRegistrationBatches` unknown
    - `createdDate` string
  - `nextPageLink` string
  - `count` integer

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `4f2049fba5af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ngpvan/apis/van-crm/changes/events/get.md)

---

[API](https://skmtc.dev/ngpvan/apis/van-crm.md) - [All operations](https://skmtc.dev/ngpvan/apis/van-crm/llms.txt) - [OpenAPI document](https://skmtc.dev/ngpvan/apis/van-crm/revisions/4f2049fba5af?raw)