---
title: "List message log entries"
method: GET
path: "/v1/message_logs"
tags: ["Logs"]
---

# List message log entries

`GET /v1/message_logs`

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/message_logs`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/message_logs/get.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Retrieve all message log entries.

## Query parameters

- `messageID` string
- `changeType` 'CampaignEvaluationTreeChanged' | 'CampaignNotification' | 'CouponCreated' | 'CouponUpdated' | 'CouponDeleted' | 'AsyncCouponsCreated' | 'CouponsDeleted' | 'CouponsUpdated' | 'CouponCodeExpiring' | 'StrikethroughPrice' | 'LoyaltyPointsAdded' | 'LoyaltyPointsDeducted' | 'LoyaltyPointsExpiring' | 'LoyaltyPointsPendingToActive' | 'LoyaltyAddedDeductedPointsBalances' | 'LoyaltyCardAddedDeductedPointsBalances' | 'TierWillDowngrade' | 'TierUpgrade' | 'TierDowngrade' | 'LoyaltyCardPointsAdded' | 'LoyaltyCardPointsDeducted' | 'LoyaltyCardPointsExpiring'
- `notificationIDs` string
- `createdBefore` string, date-time
- `createdAfter` string, date-time
- `cursor` string, byte
- `pageSize` integer
- `period` '15m' | '30m' | '1h' | '4h' | '1d' | '2d'
- `isSuccessful` boolean
- `entityType` 'application' | 'loyalty_program' | 'webhook', required
- `applicationId` number
- `campaignId` number
- `loyaltyProgramId` integer
- `responseCode` integer
- `webhookIDs` string

## Response `200`

OK

- MessageLogEntries
  - `nextCursor` string, byte: The next value in the database. **Note:** If this value is not present, it means that there are no more values in the database for this combination of request parameters.
  - `data` MessageLogEntry[], required: List of message logs.
    - `id` string, required: Unique identifier of the message.
    - `service` string, required: Name of the service that generated the log entry.
    - `changeType` string: Type of change that triggered the notification.
    - `notificationId` integer: ID of the notification.
    - `notificationName` string: The name of the notification.
    - `webhookId` integer: ID of the webhook.
    - `webhookName` string: The name of the webhook.
    - `request` MessageLogRequest: Details of the request.
      - `createdAt` string, date-time, required: Timestamp when the request was made.
      - `request` string, byte, required: Raw request data.
    - `response` MessageLogResponse: Details of the response.
      - `createdAt` string, date-time: Timestamp when the response was received.
      - `response` string, byte: Raw response data.
      - `status` integer: HTTP status code of the response.
    - `createdAt` string, date-time, required: Timestamp when the log entry was created.
    - `entityType` 'application' | 'loyalty_program' | 'webhook', required: The entity type the log is related to.
    - `url` string: The target URL of the request.
    - `applicationId` integer: Identifier of the Application.
    - `loyaltyProgramId` integer: Identifier of the loyalty program.
    - `campaignId` integer: Identifier of the campaign.

## Changes

- **2026-11-07** `7ef1b9504c3a`: 1 info
  - added the new optional `query` request parameter `pageSize`

[Operation history](https://skmtc.dev/talon/apis/management-api/changes/v1/message_logs/get.md)

---

[API](https://skmtc.dev/talon/apis/management-api.md) - [All operations](https://skmtc.dev/talon/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/talon/apis/management-api/revisions/7ef1b9504c3a?raw)