GET /p/:url_token/audit.json
Retrieve the audit log for a push.

Push Audit Log Retrieval ↑

Returns the audit log for a push, containing an array of view events with metadata including:

  • IP address of viewer

  • User agent

  • Referrer URL

  • Timestamp

  • Event type (view, failed_view, expire, etc)

Authentication is required. Only the owner of the push can retrieve its audit log. Requests for pushes not owned by the authenticated user will receive a 403 Forbidden response.

Example Request ↑

curl -X GET \
  -H "X-User-Email: user@example.com" \
  -H "X-User-Token: MyAPIToken" \
  https://pwpush.com/p/fk27vnslkd/audit.json

Example Response ↑

{
  "views": [
    {
      "ip": "x.x.x.x",
      "user_agent": "Mozilla/5.0...",
      "referrer": "https://example.com",
      "created_at": "2023-10-20T15:32:01Z",
      "successful": true,
      ...
    }
  ]
}

Supported Formats

JSON

Params

Param name Description
url_token
required

Secret URL token of a previously created push.

Validations:

  • Must be a String