GET
/
v2
/
history
Get Notification History
curl --request GET \
  --url https://alerts-api.dial.to/v2/history \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Dialect-Client-Key: <x-dialect-client-key>'
{
  "alerts": [
    {
      "id": "<string>",
      "timestamp": "2024-02-20T15:30:00.000Z",
      "title": "<string>",
      "body": "<string>",
      "image": "https://www.dialect.to/favicon.ico",
      "actions": [
        {
          "type": "<string>",
          "label": "<string>",
          "url": "<string>"
        }
      ],
      "topic": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "Product Announcements",
        "slug": "product-announcements"
      },
      "app": {
        "id": "255d6163-7e25-43e9-a188-c2f8d0980a4a",
        "name": "Dialect",
        "icon": "https://dialect-file-storage.s3.us-west-2.amazonaws.com/avatars/dialect-logo.png"
      }
    }
  ],
  "summary": {
    "unreadCount": 5,
    "lastRead": {
      "timestamp": "2024-02-20T15:30:00.000Z"
    }
  },
  "limit": 10,
  "cursor": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication for subscriber calls

Headers

​
X-Dialect-Client-Key
string
required

Client Key used to uniquely identify the client

Example:

"dk_gyh2eqzfkc4mhp5eiahnndkz"

Query Parameters

​
appId
string<uuid>

Application ID

Example:

"255d6163-7e25-43e9-a188-c2f8d0980a4a"

​
limit
number
default:10

Pagination limit

Required range: 1 <= x <= 20
Example:

10

​
cursor
string

Pagination cursor

Response

200
application/json

Notification history retrieved with detailed alert data

The response is of type object.