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)

Results are paginated with a maximum of 50 audit log entries per page and 200 pages total.

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.

Parameters

  • page - Page number (default: 1)

Example Request

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

Example Response

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

Language Specific Examples

For language-specific examples and detailed API documentation, see: docs.pwpush.com/docs/json-api/

Supported Formats

JSON

Params

Param name Description
url_token
required

Secret URL token of a previously created push.

Validations:

  • Must be a String