---
title: "Find events"
method: GET
path: "/events"
tags: ["Event Scheduling API:Events"]
---

# Find events

`GET /events`

## Query parameters

- `Title` string
- `StartDate` string, date-time
- `EndDate` string, date-time
- `EventType` string
- `EventSubTypeIds` integer[]
- `OrganizerId` integer
- `EventIds` integer[]
- `JobIds` integer[]
- `CandidateIds` integer[]
- `ContactIds` integer[]
- `UserIds` integer[]
- `CreatedBy` integer
- `Embed` string[]
- `Offset` integer
- `Limit` integer

## Response `200`

List of events matching the specified criteria

- EventListRepresentation
  - `items` EventModel[], nullable
    - `eventId` integer
    - `eventType` 'Interview' | 'Meeting', string
    - `eventSubType` EventSubTypeModel
      - `eventSubTypeId` integer
      - `eventTypeId` 'Interview' | 'Meeting', string
      - `description` string, nullable
    - `title` string, nullable
    - `startTimeUtc` string, date-time
    - `endTimeUtc` string, date-time
    - `timeZone` string, nullable
    - `videoConferenceUrl` string, nullable
    - `description` string, nullable
    - `organizer` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `job` JobOrderSummaryModel
      - `jobId` integer, required
      - `jobTitle` string, nullable
      - `location` JobOrderLocationModel
        - `locationId` integer, required
        - `name` string, required
        - `area` JobOrderLocationAreaModel
          - `areaId` integer, required
          - `name` string, required
      - `company` CompanyNameModel
        - `companyId` integer, required — Unique identifier for the company
        - `name` string, nullable — Company name
        - `status` StatusModel
          - `statusId` integer, required
          - `name` string, required
          - `active` boolean
          - `default` boolean
        - `owner` UserNameModel
          - `userId` integer, required
          - `firstName` string, nullable
          - `lastName` string, nullable
          - `position` string, nullable
          - `email` string, nullable
          - `phone` string, nullable
          - `mobile` string, nullable
          - `inactive` boolean
          - `deleted` boolean
      - `contact` ContactNameModel
        - `contactId` integer, required — Unique identifier for the contact
        - `firstName` string, nullable — First name
        - `lastName` string, nullable — Last name
        - `position` string, nullable — Position or job title
        - `salutation` string, nullable — Salutation/honorific/title
        - `unsubscribed` boolean
        - `email` string, nullable — Primary email address
        - `phone` string, nullable — Phone number
        - `mobile` string, nullable — Mobile/cell number
        - `mobileNormalized` string, nullable — Mobile/cell normalized number
        - `inactive` boolean — Contact is no longer with the company
        - `status` StatusModel
          - `statusId` integer, required
          - `name` string, required
          - `active` boolean
          - `default` boolean
        - `owner` UserNameModel
          - `userId` integer, required
          - `firstName` string, nullable
          - `lastName` string, nullable
          - `position` string, nullable
          - `email` string, nullable
          - `phone` string, nullable
          - `mobile` string, nullable
          - `inactive` boolean
          - `deleted` boolean
      - `status` StatusModel
        - `statusId` integer, required
        - `name` string, required
        - `active` boolean
        - `default` boolean
      - `source` string, nullable
      - `userFavourite` boolean, nullable
      - `owner` UserNameModel
        - `userId` integer, required
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `position` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `mobile` string, nullable
        - `inactive` boolean
        - `deleted` boolean
      - `createdBy` UserNameModel
        - `userId` integer, required
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `position` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `mobile` string, nullable
        - `inactive` boolean
        - `deleted` boolean
      - `createdAt` string, date-time, nullable
      - `updatedBy` UserNameModel
        - `userId` integer, required
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `position` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `mobile` string, nullable
        - `inactive` boolean
        - `deleted` boolean
      - `updatedAt` string, date-time, nullable
      - `closedBy` UserNameModel
        - `userId` integer, required
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `position` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `mobile` string, nullable
        - `inactive` boolean
        - `deleted` boolean
      - `closedAt` string, date-time, nullable
      - `requisitionId` integer, nullable
    - `contacts` ContactNameModel[], nullable
      - `contactId` integer, required — Unique identifier for the contact
      - `firstName` string, nullable — First name
      - `lastName` string, nullable — Last name
      - `position` string, nullable — Position or job title
      - `salutation` string, nullable — Salutation/honorific/title
      - `unsubscribed` boolean
      - `email` string, nullable — Primary email address
      - `phone` string, nullable — Phone number
      - `mobile` string, nullable — Mobile/cell number
      - `mobileNormalized` string, nullable — Mobile/cell normalized number
      - `inactive` boolean — Contact is no longer with the company
      - `status` StatusModel
        - `statusId` integer, required
        - `name` string, required
        - `active` boolean
        - `default` boolean
      - `owner` UserNameModel
        - `userId` integer, required
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `position` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `mobile` string, nullable
        - `inactive` boolean
        - `deleted` boolean
    - `candidates` CandidateNameModel[], nullable
      - `candidateId` integer, required — Candidate Id
      - `firstName` string, nullable — First name
      - `lastName` string, nullable — Last name
      - `email` string, nullable — Primary email address
      - `phone` string, nullable — Contact phone number
      - `mobile` string, nullable — Mobile/cell number
      - `mobileNormalized` string, nullable — Mobile/cell normalized number
      - `contactMethod` string, nullable — Preferred contact method
      - `salutation` string, nullable — Salutation/honorific/title
      - `unsubscribed` boolean
      - `address` AddressModel
        - `street` string[], nullable
        - `city` string, nullable
        - `state` string, nullable
        - `postalCode` string, nullable
        - `country` string, nullable
        - `countryCode` string, nullable
      - `status` StatusModel
        - `statusId` integer, required
        - `name` string, required
        - `active` boolean
        - `default` boolean
      - `rating` string, nullable — Internal rating of the candidate
      - `source` string, nullable — The source of the candidate
      - `seeking` 'Yes' | 'Maybe' | 'No', string
    - `users` UserNameModel[], nullable
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `createdBy` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `createdAtUtc` string, date-time
    - `updatedBy` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `updatedAtUtc` string, date-time
    - `companyAddress` CompanyAddressModel
      - `addressId` string, uuid, required
      - `name` string, nullable
      - `street` string[], nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postalCode` string, nullable
      - `country` string, nullable
      - `countryCode` string, nullable
      - `phone` string, nullable
      - `fax` string, nullable
      - `url` string, uri, nullable
    - `address` EventAddressModel
      - `street` string, nullable
      - `suburb` string, nullable
      - `state` string, nullable
      - `postcode` string, nullable
      - `country` string, nullable
  - `totalCount` integer, required
  - `pageNumber` integer
  - `pageSize` integer
  - `links` PageLinks
    - `first` string, uri, nullable
    - `prev` string, uri, nullable
    - `next` string, uri, nullable
    - `last` string, uri, nullable

## Other responses

- `422` — Validation error

---

[API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/revisions/9f43f6a6ee6e/schema)