Skip to main content

Retrieve Notification Settings

Retrieves the current notification settings of the project

HTTP Request

GET/api/settings/notifications

Authorization

Authorization

  • Required: Yes
  • Permission: Staff with NotificationsSettingsPermission or Admin
  • Permission Code: 1036
  • Authentication: Token authentication

Example Requests

1import requests
2
3# Retrieve notification settings
4response = requests.get('http://www.example.com/api/settings/notifications', 
5  headers={'Authorization': 'Token <your_api_key>'}
6)
7print(response.json())

Response Fields

FieldTypeDescription
notifications_sms_notifier_dataObjectSMS notifier details with `id` and `name` fields
notifications_email_notifier_dataObjectEmail notifier details with `id` and `name` fields
notifications_otp_code_lenIntegerLength of OTP codes (default: 5)
notifications_otp_ttlIntegerOTP code time-to-live in seconds (default: 120)

Notifier Data Object Structure

Both notifications_sms_notifier_data and notifications_email_notifier_data contain:

FieldTypeDescription
idIntegerNotifier ID
nameStringNotifier display name

Example Response

{
"notifications_sms_notifier_data": {
"id": 1,
"name": "melipayamak"
},
"notifications_email_notifier_data": null,
"notifications_otp_code_len": 5,
"notifications_otp_ttl": 120
}