Skip to main content

List All SMS Notifiers

List all sms notifiers.

HTTP Request

GET/api/notifications/notifiers/sms

Authorization

Authorization

  • Required: Yes
  • Permission: Staff with SMSNotifierPermission or Admin
  • Permission Code: 2812
  • Authentication: Token-based (Authorization: Token <your_api_key>)

Query Parameters

ParameterTypeDefaultDescription
limitintegerNumber of results to return per page.
offsetintegerNumber of results to skip before returning results.
searchstringSearch term to lookup results by`id`, `name`
orderingstringOrder results by (`id`, `name`, `backend`, `created_at`, `updated_at`
id_minintegerMinimum ID of the sms notifier.
id_maxintegerMaximum ID of the sms notifier.
created_datestringExact creation date (`YYYY-MM-DD`).
updated_datestringExact last update date (`YYYY-MM-DD`).
created_fromstringStart date for sms notifiers created after this date (`YYYY-MM-DD`).
updated_fromstringStart date for sms notifieres updated after this date (`YYYY-MM-DD`).
created_tostringEnd date for sms notifiers created before this date (`YYYY-MM-DD`).
updated_tostringEnd date for sms notifiers updated before this date (`YYYY-MM-DD`).
backendStringFilter by backend type of the sms notifier (choices: `melipayamak`, `ippanel`)
has_settingsBooleanFilter sms notifiers with/without defined settings

Example Requests

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

Object Structure

FieldTypeDescription
countIntegerTotal number of categories
nextStringURL for the next page of results
previousStringURL for the previous page of results
resultsArray[Object]Array of SMSNotifier objects

SMSNotifier Object Data Structure

FieldTypeDescription
idIntegerUnique ID of the sms notifier.
nameStringName of the sms notifier
backendStringName of the sms notifier backend
settingsJsonFieldJson key-value settings required for each notifier
created_atString (ISO 8601)Timestamp when the sms notifier was created.
updated_atString (ISO 8601)Timestamp when the sms notifier was last updated.

Example Response

{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 2,
"name": "ippanel_one",
"backend": "ippanel",
"settings": {
"key": "someippanelkey"
},
"created_at": "2025-11-22T13:35:15.990097Z",
"updated_at": "2025-11-22T13:35:15.990101Z"
},
{
"id": 1,
"name": "melipayamak",
"backend": "melipayamak",
"settings": {
"key": "value"
},
"created_at": "2025-11-22T13:34:54.742799Z",
"updated_at": "2025-11-28T15:18:44.765581Z"
}
]
}