This document provides detailed information about the Notification API endpoints, parameters, and usage examples. For a comprehensive overview of notification features, visit our Notification Guide.

📋 API Endpoints

GET /notifications

Retrieve a list of notification records

  • Parameters: limit (default: 10), offset (default: 0), type (e.g., email, sms, webhook)
  • Response:
    {
      "notifications": [
        {
          "id": "n12345",
          "type": "email",
          "content": "Your account has been updated!",
          "timestamp": "2023-10-05T14:30:00Z"
        }
      ]
    }
    

POST /notifications

Send a new notification

  • Request Body:
    {
      "type": "sms",
      "recipient": "+1234567890",
      "message": "Critical alert: System maintenance in progress"
    }
    

⚠️ Error Codes

Code Description
400 Invalid request parameters
401 Unauthorized access
500 Internal server error

📌 Example Usage

curl -X GET "https://api.example.com/notifications?limit=5"
Notification_API

For more details about notification types, see Notification Types.