Skip to main content

List All email Notifier Patterns

List all email notifiers patterns

HTTP Request​

GET/api/notifications/notifiers/email/:id/patterns

Authorization​

Authorization

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

Path Parameters​

ParameterTypeRequiredDescription
idIntegerYesUnique ID of the email notifier

Query Parameters​

ParameterTypeDefaultDescription
limitinteger—Number of results to return per page.
offsetinteger—Number of results to skip before returning results.
searchstring—Search term to lookup results by `id`, `name`, `description`, `from_email`, `subject`, `body_text`, `body_html`
orderingstring—Order results by (`id`, `name`, `from_email`, `subject` , `created_at`, `updated_at`
id_mininteger—Minimum ID of the email notifier.
id_maxinteger—Maximum ID of the email notifier.
created_datestring—Exact creation date (`YYYY-MM-DD`).
updated_datestring—Exact last update date (`YYYY-MM-DD`).
created_fromstring—Start date for email notifiers created after this date (`YYYY-MM-DD`).
updated_fromstring—Start date for email notifieres updated after this date (`YYYY-MM-DD`).
created_tostring—End date for email notifiers created before this date (`YYYY-MM-DD`).
updated_tostring—End date for email notifiers updated before this date (`YYYY-MM-DD`).
has_descriptionboolean—filters patterns with/without description
has_from_emailboolean—filters patterns with/without from_email field
has_body_htmlboolean—filters patterns with/without body_html
from_emailboolean—filters pattens by their from_email

Example Requests​

1import requests
2
3# List all email notifiers
4response = requests.get('http://www.example.com/api/notifications/notifiers/email/1/patterns',
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 EmailNotifier objects

EmailNotifier Object Data Structure

FieldTypeDescription
idIntegerUnique ID of the email pattern.
nameStringName of the email pattern (unique over the specific email notifier)
descriptionStringExtra descrtiption of the email pattern (nullable)
from_emailStringfrom email of the pattern (nullable)
subjectStringSubject of the email
body_textStringText body of the email pattern
body_htmlStringHtml body of the email pattern (nullable)
created_atString (ISO 8601)Timestamp when the email pattern was created.
updated_atString (ISO 8601)Timestamp when the email pattern was last updated.

Example Response​

{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 2,
"name": "otp_code",
"description": "used for sending otp codes",
"from_email": "info@hamgam.online",
"subject": "hamgam otp code",
"body_text": "Your sign in otp code is {0}",
"body_html": null,
"created_at": "2025-12-28T18:13:33.402412Z",
"updated_at": "2025-12-28T18:13:33.402419Z"
},
{
"id": 3,
"name": "order_status_changed",
"description": "used for sending status changes",
"from_email": "info@hamgam.online",
"subject": "hamgam order status changed",
"body_text": "Order number {0} is in {1} status",
"body_html": null,
"created_at": "2025-12-28T18:14:22.251792Z",
"updated_at": "2025-12-28T18:14:22.251799Z"
}
]
}