---
title: "Find all supported notification types along with applicable roles and channels they can be delivered."
method: GET
path: "/notification-types"
tags: ["notification-types"]
---

# Find all supported notification types along with applicable roles and channels they can be delivered.

`GET /notification-types`

## Request

- Base URL: `https://api.smartrecruiters.com/notification-preferences`
- URL: `https://api.smartrecruiters.com/notification-preferences/notification-types`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Client credentials
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `notification_preferences:read`
  - API key in header `x-smarttoken`

## Response `200`

Successfully retrieved all supported notification types

- NotificationTypeViewExternal[]
  - `type` 'ADDED_TO_HIRING_TEAM' | 'ASSESSMENT_RESULTS' | 'ASSESSMENT_UPDATED' | 'CANDIDATE_APPLIED' | 'CANDIDATE_DEFERRED' | 'CANDIDATE_OFFERED' | 'CANDIDATE_RATED' | 'CANDIDATE_RE_ENGAGED' | 'CANDIDATE_REPLIED_TO_EMAIL' | 'CANDIDATE_REPLIED_TO_SMART_MESSAGE' | 'CANDIDATE_WITHDRAWN' | 'COMMENTS_ON_MENTIONED_POSTS' | 'COMMENTS_ON_MY_POSTS' | 'EMAIL_FROM_COLLEAGUE_TO_CANDIDATE_WITHIN_CONVERSATION' | 'EVENT_MANAGEMENT_DAILY_DIGEST' | 'EVENT_MANAGEMENT_SESSION_SCHEDULED' | 'FEEDBACK_IS_SUBMITTED_BY_INTERVIEWER' | 'INTERVIEW_ACCEPTED_BY_CANDIDATE' | 'INTERVIEW_CANCELLED_BY_CANDIDATE' | 'INTERVIEW_FEEDBACK' | 'INTERVIEW_INVITATION' | 'INTERVIEW_REMINDER' | 'NEW_HIRES' | 'NEW_HIRING_TEAM_MEMBERS' | 'SELF_SCHEDULING_NO_SLOTS_AVAILABLE_INTERVIEWER' | 'SELF_SCHEDULING_NO_SLOTS_AVAILABLE_JOB_CREATOR' | 'UPCOMING_INTERVIEWS' | 'WEEKLY_DIGEST', required: Type of notification
  - `supportedRoles` string[], required: Set of supported hiring team roles for this notification type
  - `supportedChannels` string[], required: List of supported notification channels for this notification type

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/smartrecruiters/apis/notifications-engine-public-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/notifications-engine-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/notifications-engine-public-api/revisions/ff109dcd0e22?raw)