---
title: "Resume a paused subscription"
method: POST
path: "/v1/account/subscriptions/{id}/resume"
tags: ["Push"]
---

# Resume a paused subscription

`POST /v1/account/subscriptions/{id}/resume`

## Request

- Base URL: `https://api.pmwallets.com`
- URL: `https://api.pmwallets.com/v1/account/subscriptions/{id}/resume`
- Auth: API key in header `x-api-key`

CHARGES THE BALANCE one hour at the subscription's own price and restarts delivery 65 blocks behind the head; the paused span is not backfilled. Idempotent under lock (a retry does not charge twice).

## Path parameters

- `id` string, required

## Response `201`

Active again (HTTP 201).

- Subscription
  - `id` string
  - `userId` string
  - `chain` integer
  - `entityId` string: The 0x address once paid for and still held; a handle otherwise (never-charged or plan-locked rows).
  - `label` string
  - `channels` string[]
  - `status` 'active' | 'paused' | 'canceled'
  - `pausedReason` string, nullable: e.g. insufficient_balance, webhook_disabled, no_webhook, plan_ended, plan_limit, address_locked.
  - `fromBlock` integer: Fills strictly after this block are delivered.
  - `syncedBlock` integer
  - `tier` string
  - `priceCents` integer: Hourly price frozen on the subscription.
  - `billedThrough` string, date-time, nullable: Prepaid up to here.
  - `planCovered` boolean: The last billed hour was covered by a plan push slot (free).
  - `activations` integer
  - `createdAt` string, date-time
  - `canceledAt` string, date-time, nullable
  - `followedAt` string, date-time, nullable
  - `categories` object[]: List endpoint only.
    - `category` string
    - `share` number
  - `lastFillTs` string, nullable: List endpoint only.
  - `fills24h` integer, nullable: List endpoint only.

## Other responses

- `400`: 200 active subscriptions already.
- `401`: No valid API key (missing, malformed, unknown or revoked).
- `402`: Not enough balance for the hour, or `error: address_not_unlocked` (the address came from a plan that ended).
- `404`: Not found (or not yours).
- `409`: Canceled (subscribe again instead) or the only channel is a missing/switched-off webhook.
- `503`: Temporarily unavailable; nothing was charged. Retry shortly.

---

[API](https://skmtc.dev/pmwallets/apis/pmwallets-api.md) · [All operations](https://skmtc.dev/pmwallets/apis/pmwallets-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pmwallets/apis/pmwallets-api/revisions/d5023fb40430?raw)