REST API v1.0.0

Automate your mailbox supply

Buy Graph-API mailboxes programmatically. Same wallet, same instant delivery, same 5% affiliate earnings — fully scriptable.

Auth

Bearer API key

Idempotent

Safe retries

Base URL

pulse-mails.com/api/v1

Authentication

Every request needs your secret API key from the dashboard as a Bearer token. Keep it server-side — it can spend your wallet balance.

bash

Authorization: Bearer plm_your_api_key

Anyone with your key can place orders against your balance. Rotate it any time from the dashboard (old key stops working instantly).

Idempotency

Send a stable idempotency_key (or Idempotency-Key header) on every purchase. If a request is retried, you get the original order back — you are never charged twice.

Endpoints

GET/api/v1/products

List purchasable products with live stock and pricing.

Request

bash

curl https://pulse-mails.com/api/v1/products \
  -H "Authorization: Bearer plm_…"

Response

json

{
  "products": [{
    "id": "hotmail-graph",
    "name": "Hotmail · Graph API",
    "price_units": 30,
    "price_usd": "0.0030",
    "on_demand": true,
    "stock": 128,
    "available": true
  }]
}

GET/api/v1/balance

Your current wallet balance.

Request

bash

curl https://pulse-mails.com/api/v1/balance \
  -H "Authorization: Bearer plm_…"

Response

json

{
  "email": "you@example.com",
  "balance_units": 125000,
  "balance_usd": "12.5000"
}

POST/api/v1/orders

Buy accounts. Debits your wallet and returns the delivered credentials atomically.

Request

bash

curl -X POST https://pulse-mails.com/api/v1/orders \
  -H "Authorization: Bearer plm_…" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "hotmail-graph",
    "qty": 10,
    "idempotency_key": "order-2026-0001"
  }'

Response

json

{
  "id": "38c1eb03-…",
  "product_id": "hotmail-graph",
  "qty": 10,
  "total_usd": "0.0300",
  "status": "completed",
  "accounts": [
    "user:pass:mail|mailpass|refresh|clientid:auth:2fa",
    "…"
  ]
}

GET/api/v1/orders

List your recent orders (credentials omitted). Supports ?limit=.

Request

bash

curl "https://pulse-mails.com/api/v1/orders?limit=20" \
  -H "Authorization: Bearer plm_…"

Response

json

{
  "orders": [{
    "id": "38c1eb03-…",
    "qty": 10,
    "total_usd": "0.0300",
    "status": "completed",
    "created_at": "2026-10-04T00:22:46.908Z"
  }]
}

GET/api/v1/orders/:id

Fetch one order and re-download its credentials any time.

Request

bash

curl https://pulse-mails.com/api/v1/orders/38c1eb03-… \
  -H "Authorization: Bearer plm_…"

Response

json

{
  "id": "38c1eb03-…",
  "qty": 10,
  "status": "completed",
  "accounts": ["user:pass:…"]
}

Errors

Errors return problem+json with an HTTP status and a stable title code.

Status	Code	Meaning
401	UNAUTHORIZED_EXCEPTION	Missing or invalid API key.
404	NOT_FOUND_EXCEPTION	Product or order not found.
409	INSUFFICIENT_BALANCE_EXCEPTION	Wallet balance is too low — top up first.
409	OUT_OF_STOCK_EXCEPTION	Not enough stock for the requested quantity.
413	REQUEST_TOO_LARGE_EXCEPTION	Quantity above the 5,000 cap.
422	VALIDATION_EXCEPTION	A required field is missing or invalid.
429	RATE_LIMITED_EXCEPTION	Too many requests — see Retry-After.

Get your API key →