Retrieving a Push

Retrieves a push and its payload. If the push is active, this request will count as a view and be logged in the audit log.

Security Features

  • Passphrase protection - Requires a passphrase to view.

    Provide the passphrase as a GET parameter: ?passphrase=xxx

Example Request

curl -X GET \
  -H "Authorization: Bearer MyAPIToken" \
  https://pwpush.com/p/fk27vnslkd.json

Example Response

{
  "payload": "secret_text",
  "passphrase": null,
  "note": "By user initiated request from the user@example.com account",
  "expire_after_days": null,
  "expire_after_views": null,
  "deletable_by_viewer": false,
  "retrieval_step": false,
  ...
}

Supported Formats

JSON

Params

Param name Description
url_token
required

Secret URL token of a previously created push.

Validations:

  • Must be a String