PApaddlehq
Notification logs

List logs for a notification

Changed on

Returns a paginated list of notification logs for a notification. A log includes information about delivery attempts, including failures.

Notifications older than 90 days aren't retained. If you try to list logs for a notification that's no longer retained, Paddle returns an error.

get/notifications/{notification_id}/logs

Request

  • Base URL
    https://sandbox-api.paddle.com
  • Auth
    HTTP bearer

Path parameters

notification_idstring required

Paddle ID of the notification entity to work with.

Query parameters

afterstring

Return entities after the specified Paddle ID when working with paginated endpoints. Used in the meta.pagination.next URL in responses for list operations.

per_pageinteger

Set how many entities are returned per page. Paddle returns the maximum number of results if a number greater than the maximum is requested. Check meta.pagination.per_page in the response to see how many were returned.

Default: 50; Maximum: 200.

Headers

Skip-Countstring

Set to true to skip the count query on list operations. When set, meta.pagination.estimated_total returns -1 instead of an exact count.

Response

The request has succeeded.

Example response

{
  "data": [
    {
      "id": "ntflog_01gyfq570sy1nsv2123sbs68kv",
      "response_code": 200,
      "response_content_type": "text/plain; charset=UTF-8",
      "attempted_at": "2024-10-12T07:20:50.52Z"
    }
  ],
  "meta": {
    "request_id": "b15ec92e-8688-40d4-a04d-f44cbec93355",
    "pagination": {
      "estimated_total": 999
    }
  }
}

Changes

  • v1e1ac347eb3c5Revision changes
    • info

      added the new optional header request parameter Skip-Count

  • v19ba8be0f2006Revision changes
    • breaking

      added the new path request parameter notification_id

    • breaking

      response property data/items/response_content_type list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      the // response's property type changed from string to no type, and format from date-time to no format for status

    • breaking

      the // response's property type changed from string to no type for status

    • breaking

      the response's property type changed from object to no type for status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      added to the response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the // response's property pattern ^ntflog_[a-z\d]{26}$ was removed for the status