# BlockVectra Subscriptions API

**Canonical:** https://apis.io/apis/blockvectra/blockvectra-subscriptions-api/  
**Provider:** BlockVectra — https://apis.io/providers/blockvectra/  
**Base URL:** https://api.blockvectra.com/v1  
**Documentation:** https://docs.blockvectra.com/en/api/data/

BlockVectra Subscriptions API is one of 20 APIs that [BlockVectra](https://apis.io/providers/blockvectra/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 21 JSON Schema definitions. Tagged areas include Subscription. The published artifact set on APIs.io includes an OpenAPI specification and 21 JSON Schemas.

Subscriptions, their addresses and actions.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| POST | `/push/subscriptions` | Create a subscription (URL and chains), optionally with initial addresses |
| GET | `/push/subscriptions` | Subscriptions of the account, oldest first |
| GET | `/push/subscriptions/{subscription_id}` | One subscription with its delivery health |
| PATCH | `/push/subscriptions/{subscription_id}` | Change URL, online/offline status, billed key, chains or confirmation depths |
| DELETE | `/push/subscriptions/{subscription_id}` | Delete permanently (not the same as going offline); delivery stops on every… |
| GET | `/push/subscriptions/{subscription_id}/addresses` | Watched addresses in ascending order |
| POST | `/push/subscriptions/{subscription_id}/addresses/add` | Add up to 10,000 addresses |
| POST | `/push/subscriptions/{subscription_id}/addresses/remove` | Remove up to 10,000 addresses |
| POST | `/push/subscriptions/{subscription_id}/replay` | Replay stored matches of one chain from a retained block |
| POST | `/push/subscriptions/{subscription_id}/rotate-secret` | Replace the signing secret immediately on every chain, without an overlap period |
| GET | `/push/subscriptions/{subscription_id}/events` | Delivered data events of one chain; each successful page costs 25 CU |

## Machine-readable artifacts (22)

- **OpenAPI** — https://artifacts.apis.io/blockvectra/openapi/blockvectra-subscriptions-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-freshness-envelope-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-token-transfer-list-envelope-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-address-transfer-list-envelope-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-tokens-batch-envelope-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-dex-swap-list-envelope-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-transaction-list-envelope-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-key-view-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-balance-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-plans-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-resets-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-identity-view-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-session-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-subscription-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-subscription-patch-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-remove-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-add-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-event-history-page-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-subscription-list-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-faucet-claim-accepted-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-faucet-claim-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockvectra/json-schema/blockvectra-json-rpc-response-body-schema.json

## Other BlockVectra APIs (12)

- [BlockVectra Data API](https://apis.io/apis/blockvectra/blockvectra-data-api/)
- [BlockVectra Account API](https://apis.io/apis/blockvectra/blockvectra-account-api/)
- [BlockVectra Addresses API](https://apis.io/apis/blockvectra/blockvectra-addresses-api/)
- [BlockVectra Auth API](https://apis.io/apis/blockvectra/blockvectra-auth-api/)
- [BlockVectra Billing API](https://apis.io/apis/blockvectra/blockvectra-billing-api/)
- [BlockVectra Chain API](https://apis.io/apis/blockvectra/blockvectra-chain-api/)
- [BlockVectra Chains API](https://apis.io/apis/blockvectra/blockvectra-chains-api/)
- [BlockVectra DEX API](https://apis.io/apis/blockvectra/blockvectra-dex-api/)
- [BlockVectra Faucet API](https://apis.io/apis/blockvectra/blockvectra-faucet-api/)
- [BlockVectra JSON RPC API](https://apis.io/apis/blockvectra/blockvectra-json-rpc-api/)
- [BlockVectra Keys API](https://apis.io/apis/blockvectra/blockvectra-keys-api/)
- [BlockVectra Me API](https://apis.io/apis/blockvectra/blockvectra-me-api/)

## Tags

Subscription

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/blockvectra/blockvectra-subscriptions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/blockvectra/.