---
title: "Get candidate events"
method: GET
path: "/events/candidates/{profileId}"
tags: ["events"]
---

# Get candidate events

`GET /events/candidates/{profileId}`

Use this endpoint to candidate events.

## Path parameters

- `profileId` string, uuid, required

## Query parameters

- `state` 'PAST' | 'ACTIVE', required

## Response `200`

Successful response.

- EventDetailsResponse[]
  - `id` string, uuid
  - `type` string
  - `title` string
  - `eventHiringState` EventHiringState
    - `stage` string, required
    - `step` string
  - `recruitmentStep` string
  - `sessions` SessionDetails[]
    - `id` string, uuid
    - `title` string
    - `location` string
    - `capacity` integer
    - `attendance` integer
    - `start` string, date-time
    - `end` string, date-time
    - `interviewerIds` EmployeeAttendee[]
      - `id` string, uuid
      - `employeeId` string
      - `status` 'PENDING' | 'TENTATIVE' | 'ACCEPTED' | 'DECLINED' | 'ORGANIZER'
    - `resources` ResourceAttendee[]
      - `id` string, uuid
      - `name` string
      - `email` string
      - `status` 'PENDING' | 'TENTATIVE' | 'ACCEPTED' | 'DECLINED' | 'ORGANIZER'
    - `createdAt` string, date-time
    - `reminders` SessionReminderView[]
      - `id` string
      - `advanceTimesInMinutes` integer
      - `channel` 'SMS' | 'WHATS_APP' | 'EMAIL'
      - `status` 'SCHEDULED' | 'SENDING' | 'SENT' | 'ERROR'
  - `advanceTimeMinutes` integer
  - `invitations` Invitation
    - `email` EmailInvitation
      - `subject` string, required
      - `content` string, required
      - `bccEmployeeIds` string[]
    - `sms` TextInvitation
      - `content` string, required
      - `confirmationMessage` string, required
    - `whatsApp` WhatsappInvitation
      - `enabled` boolean
    - `line` TextInvitation
      - `content` string, required
      - `confirmationMessage` string, required
    - `repeat` RepeatInvitation
      - `intervalInMinutes` integer — Time between invitations resends in minutes. Maximum value is 4320 minutes (3 days).
      - `count` integer — Number of times that invitation will be sent again. Maximum value is 5.
  - `jobId` string, uuid
  - `timezone` string
  - `createdAt` string, date-time
  - `creatorId` string
  - `cancelled` boolean

## Other responses

- `400` — Returned when a request is not valid.
- `401` — Returned when a request was not authenticated.
- `403` — Returned when a caller is not authorized to perform the request.

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/versions/449bdc2516c9/schema)