# Notifications

Use these endpoints for interacting with Notifications.

 - [GET /api/v1/notification-audiences/](https://docs.jiko.io/products/customer-api/reference/notifications/list_notification_audiences_api_v1_notification_audiences__get.md): This endpoint lists the notification audiences for your team — who receives each notification type that supports a configurable audience. Every configurable type is returned, whether or not your team
 - [GET /api/v1/notification-audiences/{notification_type}/](https://docs.jiko.io/products/customer-api/reference/notifications/get_notification_audience_api_v1_notification_audiences__notification_type___get.md): This endpoint returns the notification audience for a single notification type — who on your team receives it. If your team has not configured this type, the platform default is returned with `is_defa
 - [PUT /api/v1/notification-audiences/{notification_type}/](https://docs.jiko.io/products/customer-api/reference/notifications/set_notification_audience_api_v1_notification_audiences__notification_type___put.md): This endpoint replaces who, on your team, receives one notification type. The request body must contain a `SetCustomerNotificationAudienceRequest` object. `roles` and `user_ids` are additive: the audi
 - [DELETE /api/v1/notification-audiences/{notification_type}/](https://docs.jiko.io/products/customer-api/reference/notifications/delete_notification_audience_api_v1_notification_audiences__notification_type___delete.md): This endpoint clears your team's configured audience for one notification type, reverting it to the platform default. This is different from setting an audience with empty `roles` and `user_ids`, whic
 - [GET /api/v1/notifications/](https://docs.jiko.io/products/customer-api/reference/notifications/list_notifications_api_v1_notifications__get.md): This endpoint lists all notifications for a customer. You can filter by status (`READ` or `UNREAD`). It returns a paginated list of `CustomerNotification` objects.
 - [GET /api/v1/notifications/{notification_id}/](https://docs.jiko.io/products/customer-api/reference/notifications/get_notification_api_v1_notifications__notification_id___get.md): This endpoint retrieves a single notification by its `notification_id`, and returns a `CustomerNotification` object.
 - [PATCH /api/v1/notifications/{notification_id}/](https://docs.jiko.io/products/customer-api/reference/notifications/patch_notification_api_v1_notifications__notification_id___patch.md): This endpoint allows you to update the status of a notification, for example, to mark it as read. The request body must contain an `UpdateCustomerNotificationStatus` object. It returns the updated `Cu