Get Notification Scheme

GET {{baseUrl}}/rest/api/3/notificationscheme/:id?expand=<string>

Returns a notification scheme, including the list of events and the recipients who will receive notifications for those events.

Permissions required: Permission to access Jira, however the user must have permission to administer at least one project associated with the notification scheme.

Request Params

KeyDatatypeRequiredDescription
expandstringUse expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:
  • all Returns all expandable information.
  • field Returns information about any custom fields assigned to receive an event.
  • group Returns information about any groups assigned to receive an event.
  • notificationSchemeEvents Returns a list of event associations. This list is returned for all expandable information.
  • projectRole Returns information about any project roles assigned to receive an event.
  • user Returns information about any users assigned to receive an event. |

RESPONSES

status: OK

{&quot;expand&quot;:&quot;notificationSchemeEvents,user,group,projectRole,field,all&quot;,&quot;id&quot;:10100,&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/notificationscheme&quot;,&quot;name&quot;:&quot;notification scheme name&quot;,&quot;description&quot;:&quot;description&quot;,&quot;notificationSchemeEvents&quot;:[{&quot;event&quot;:{&quot;id&quot;:1,&quot;name&quot;:&quot;Issue created&quot;,&quot;description&quot;:&quot;Event published when an issue is created&quot;},&quot;notifications&quot;:[{&quot;id&quot;:1,&quot;notificationType&quot;:&quot;Group&quot;,&quot;parameter&quot;:&quot;jira-administrators&quot;,&quot;group&quot;:{&quot;name&quot;:&quot;jira-administrators&quot;,&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/group?groupname=jira-administrators&quot;},&quot;expand&quot;:&quot;group&quot;},{&quot;id&quot;:2,&quot;notificationType&quot;:&quot;CurrentAssignee&quot;},{&quot;id&quot;:3,&quot;notificationType&quot;:&quot;ProjectRole&quot;,&quot;parameter&quot;:&quot;10360&quot;,&quot;projectRole&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/project/MKY/role/10360&quot;,&quot;name&quot;:&quot;Developers&quot;,&quot;id&quot;:10360,&quot;description&quot;:&quot;A project role that represents developers in a project&quot;,&quot;actors&quot;:[{&quot;id&quot;:10240,&quot;displayName&quot;:&quot;jira-developers&quot;,&quot;type&quot;:&quot;atlassian-group-role-actor&quot;,&quot;name&quot;:&quot;jira-developers&quot;,&quot;actorGroup&quot;:{&quot;name&quot;:&quot;jira-developers&quot;,&quot;displayName&quot;:&quot;jira-developers&quot;}},{&quot;id&quot;:10241,&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;type&quot;:&quot;atlassian-user-role-actor&quot;,&quot;actorUser&quot;:{&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;}}],&quot;scope&quot;:{&quot;type&quot;:&quot;PROJECT&quot;,&quot;project&quot;:{&quot;id&quot;:&quot;10000&quot;,&quot;key&quot;:&quot;KEY&quot;,&quot;name&quot;:&quot;Next Gen Project&quot;}}},&quot;expand&quot;:&quot;projectRole&quot;},{&quot;id&quot;:4,&quot;notificationType&quot;:&quot;EmailAddress&quot;,&quot;parameter&quot;:&quot;rest-developer@atlassian.com&quot;,&quot;emailAddress&quot;:&quot;rest-developer@atlassian.com&quot;},{&quot;id&quot;:5,&quot;notificationType&quot;:&quot;User&quot;,&quot;parameter&quot;:&quot;5b10a2844c20165700ede21g&quot;,&quot;user&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g&quot;,&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;,&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;active&quot;:false},&quot;expand&quot;:&quot;user&quot;},{&quot;id&quot;:6,&quot;notificationType&quot;:&quot;GroupCustomField&quot;,&quot;parameter&quot;:&quot;customfield_10101&quot;,&quot;field&quot;:{&quot;id&quot;:&quot;customfield_10101&quot;,&quot;key&quot;:&quot;customfield_10101&quot;,&quot;name&quot;:&quot;New custom field&quot;,&quot;untranslatedName&quot;:&quot;New custom field&quot;,&quot;custom&quot;:true,&quot;orderable&quot;:true,&quot;navigable&quot;:true,&quot;searchable&quot;:true,&quot;clauseNames&quot;:[&quot;cf[10101]&quot;,&quot;New custom field&quot;],&quot;schema&quot;:{&quot;type&quot;:&quot;project&quot;,&quot;custom&quot;:&quot;com.atlassian.jira.plugin.system.customfieldtypes:project&quot;,&quot;customId&quot;:10101}},&quot;expand&quot;:&quot;field&quot;}]},{&quot;event&quot;:{&quot;id&quot;:20,&quot;name&quot;:&quot;Custom event&quot;,&quot;description&quot;:&quot;Custom event that is published together with an issue created event&quot;,&quot;templateEvent&quot;:{&quot;id&quot;:1,&quot;name&quot;:&quot;Issue created&quot;,&quot;description&quot;:&quot;Event published when an issue is created&quot;}},&quot;notifications&quot;:[{&quot;id&quot;:1,&quot;notificationType&quot;:&quot;Group&quot;,&quot;parameter&quot;:&quot;jira-administrators&quot;,&quot;group&quot;:{&quot;name&quot;:&quot;jira-administrators&quot;,&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/group?groupname=jira-administrators&quot;},&quot;expand&quot;:&quot;group&quot;},{&quot;id&quot;:2,&quot;notificationType&quot;:&quot;CurrentAssignee&quot;},{&quot;id&quot;:3,&quot;notificationType&quot;:&quot;ProjectRole&quot;,&quot;parameter&quot;:&quot;10360&quot;,&quot;projectRole&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/project/MKY/role/10360&quot;,&quot;name&quot;:&quot;Developers&quot;,&quot;id&quot;:10360,&quot;description&quot;:&quot;A project role that represents developers in a project&quot;,&quot;actors&quot;:[{&quot;id&quot;:10240,&quot;displayName&quot;:&quot;jira-developers&quot;,&quot;type&quot;:&quot;atlassian-group-role-actor&quot;,&quot;name&quot;:&quot;jira-developers&quot;,&quot;actorGroup&quot;:{&quot;name&quot;:&quot;jira-developers&quot;,&quot;displayName&quot;:&quot;jira-developers&quot;}},{&quot;id&quot;:10241,&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;type&quot;:&quot;atlassian-user-role-actor&quot;,&quot;actorUser&quot;:{&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;}}],&quot;scope&quot;:{&quot;type&quot;:&quot;PROJECT&quot;,&quot;project&quot;:{&quot;id&quot;:&quot;10000&quot;,&quot;key&quot;:&quot;KEY&quot;,&quot;name&quot;:&quot;Next Gen Project&quot;}}},&quot;expand&quot;:&quot;projectRole&quot;},{&quot;id&quot;:4,&quot;notificationType&quot;:&quot;EmailAddress&quot;,&quot;parameter&quot;:&quot;rest-developer@atlassian.com&quot;,&quot;emailAddress&quot;:&quot;rest-developer@atlassian.com&quot;},{&quot;id&quot;:5,&quot;notificationType&quot;:&quot;User&quot;,&quot;parameter&quot;:&quot;5b10a2844c20165700ede21g&quot;,&quot;user&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g&quot;,&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;,&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;active&quot;:false},&quot;expand&quot;:&quot;user&quot;},{&quot;id&quot;:6,&quot;notificationType&quot;:&quot;GroupCustomField&quot;,&quot;parameter&quot;:&quot;customfield_10101&quot;,&quot;field&quot;:{&quot;id&quot;:&quot;customfield_10101&quot;,&quot;key&quot;:&quot;customfield_10101&quot;,&quot;name&quot;:&quot;New custom field&quot;,&quot;untranslatedName&quot;:&quot;New custom field&quot;,&quot;custom&quot;:true,&quot;orderable&quot;:true,&quot;navigable&quot;:true,&quot;searchable&quot;:true,&quot;clauseNames&quot;:[&quot;cf[10101]&quot;,&quot;New custom field&quot;],&quot;schema&quot;:{&quot;type&quot;:&quot;project&quot;,&quot;custom&quot;:&quot;com.atlassian.jira.plugin.system.customfieldtypes:project&quot;,&quot;customId&quot;:10101}},&quot;expand&quot;:&quot;field&quot;}]}]}