Get and manage account notifications

View all notifications sent to your account, with options to filter for unread messages and paginate through your alerts to stay updated on important events and service updates.

Account & Settings Account

Context

Related endpoints

PUT /api/notifications/{id} Update your notification settings GET /api/notifications/{id} Get account notifications POST /api/notifications/{id} Create website monitoring and notifications

Query Parameters

limit string required · Example: 25

offset string required · Example: 0

Headers

Accept Example

Content-Type Example

Responses

200

data object required

data.notifications array<object> required · Example: []

data.total integer required · Example: 0

data.unreadCount integer required · Example: 0

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/notifications

For AI assistants

cURL

curl -X GET "https://cloud.hostup.se/api/notifications?limit=25&offset=0" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "notifications": [],
    "total": 0,
    "unreadCount": 0
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "notifications": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "total": {
          "type": "integer"
        },
        "unreadCount": {
          "type": "integer"
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}