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
limitintegerNumber of results to return per page.
offsetintegerNumber of results to skip before returning results.
searchstringSearch term to lookup results by `id`, `name`, `description`, `from_email`, `subject`, `body_text`, `body_html`
orderingstringOrder results by (`id`, `name`, `from_email`, `subject` , `created_at`, `updated_at`
id_minintegerMinimum ID of the email notifier.
id_maxintegerMaximum ID of the email notifier.
created_datestringExact creation date (`YYYY-MM-DD`).
updated_datestringExact last update date (`YYYY-MM-DD`).
created_fromstringStart date for email notifiers created after this date (`YYYY-MM-DD`).
updated_fromstringStart date for email notifieres updated after this date (`YYYY-MM-DD`).
created_tostringEnd date for email notifiers created before this date (`YYYY-MM-DD`).
updated_tostringEnd date for email notifiers updated before this date (`YYYY-MM-DD`).
has_descriptionbooleanfilters patterns with/without description
has_from_emailbooleanfilters patterns with/without from_email field
has_body_htmlbooleanfilters patterns with/without body_html
from_emailbooleanfilters 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"
}
]
}