Password Pusher API v2

BETA

Comprehensive REST API documentation for integrating Password Pusher into your workflows, applications and tools.

Beta Notice: API v2 is currently in beta. While we've made every effort to ensure stability, there may be breaking changes before the final release. We welcome your feedback!

Overview

The Password Pusher API v2 provides a RESTful interface for creating, retrieving, and managing secure password pushes and requests. All API endpoints return JSON responses and use standard HTTP status codes.

Bearer Token Authentication

Secure API access with token-based authentication

JSON-Only Responses

Consistent JSON format across all endpoints

RESTful Design

Intuitive REST endpoints following best practices

Pushes & Requests

Support for one-way pushes and two-way requests

GET /api/v2/version

Returns the current API version and application details.

Example Request

curl -X GET https://us.pwpush.com/api/v2/version

Example Response

{
  "application_version": "2.1.0",
  "api_version": "2.0",
  "edition": "commercial"
}

Example: Create and Retrieve a Push

# Create a push
curl -X POST https://us.pwpush.com/api/v2/pushes \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "push": {
      "payload": "MySecretPassword123",
      "expire_after_duration": 6,
      "expire_after_views": 3
    }
  }'

# Retrieve the push
curl -X GET https://us.pwpush.com/api/v2/pushes/fkwjfvhall92

Example: Create a Request and Respond

# Create a request
curl -X POST https://us.pwpush.com/api/v2/requests \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "request": "Please provide the API key",
      "close_after_duration": 8
    }
  }'

# Respond to the request
curl -X PATCH https://us.pwpush.com/api/v2/requests/orpw2wkg00vpn0a/respond \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "response": "The API key is: sk_live_1234567890"
    }
  }'

Request States

open The request has been created and is waiting for a response. Share the request URL with the recipient.

ready A response has been provided and is available for retrieval. The original requestor can now access the response.

closed The request has expired or been manually closed. All sensitive data has been permanently deleted.

Last updated: December 01, 2025

Password Pusher API v2

Overview

Bearer Token Authentication

JSON-Only Responses

RESTful Design

Pushes & Requests

Authentication

Getting Your API Token

Base URL

Beta Availability

Version

GET /api/v2/version

Example Request

Example Response

Complete Examples

Example: Create and Retrieve a Push

Example: Create a Request and Respond

Request States

Error Handling

Rate Limits

Rate Limit Responses

Best Practices