Notifications Endpoints

List Notifications

Retrieve system notifications filtered by type.

GET /notifications/list

Query Parameters:

Parameter	Type	Required	Description
notification_type	string	Yes	Type of notification: inventory_alerts, price_alerts, or restock_alerts
page	integer	No	Page number for pagination

Plus an account selection parameter.

Example Request:

curl -X GET "https://app.sellerlegend.com/api/notifications/list?account_title=My Store US&notification_type=inventory_alerts" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Response:

{
  "data": [
    {
      "id": 1234,
      "type": "inventory_alerts",
      "title": "Low Stock Alert",
      "message": "MY-SKU-001 has only 5 units remaining in FBA",
      "severity": "high",
      "sku": "MY-SKU-001",
      "created_at": "2025-01-15T08:30:00Z",
      "read": false
    }
  ]
}

Response Fields:

Field	Type	Description
id	integer	Notification ID
type	string	Notification type
title	string	Notification title
message	string	Detailed notification message
severity	string	Alert severity: low, medium, or high
sku	string	Related product SKU (if applicable)
created_at	string	ISO 8601 timestamp
read	boolean	Whether the notification has been read

Python SDK:

from sellerlegend_api import SellerLegendClient

client = SellerLegendClient(access_token="YOUR_ACCESS_TOKEN")

notifications = client.notifications.list(
    account_title="My Store US",
    notification_type="inventory_alerts"
)

for notification in notifications['data']:
    status = "Read" if notification['read'] else "Unread"
    print(f"[{status}] {notification['title']}: {notification['message']}")

Notification Types

Type	Description
inventory_alerts	Low stock, out-of-stock, and stranded inventory alerts
price_alerts	Buy Box price changes, competitor price changes
restock_alerts	Restock reminders based on velocity and lead times