# Off the Hook

## Docs

- [GET /v1/subscriptions/:id/filters/addresses](https://docs.offthehook.dev/api/addresses/list.md): List all address filters for a subscription with cursor-based pagination. Use this when a subscription has more than 200 addresses.
- [PATCH /v1/subscriptions/:id/filters/addresses](https://docs.offthehook.dev/api/addresses/patch.md): Atomically add and remove address filters in a single request. Returns per-item results showing what was added, removed, or skipped.
- [PUT /v1/subscriptions/:id/filters/addresses](https://docs.offthehook.dev/api/addresses/replace.md): Replace the entire address filter list for a subscription atomically. All existing addresses are removed and replaced with the provided list.
- [GET /v1/subscriptions/:id/events/:eventId](https://docs.offthehook.dev/api/events/get.md): Retrieve a single event by ID. Returns the full delivery history, current status, and the exact webhook payload that was sent to your endpoint.
- [GET /v1/subscriptions/:id/events](https://docs.offthehook.dev/api/events/list.md): List delivery history for a subscription. Each event shows its status, attempt count, last HTTP response, and the payload that was sent.
- [POST /v1/subscriptions/:id/events/:eventId/retry](https://docs.offthehook.dev/api/events/retry.md): Manually re-queue a failed event for delivery. Resets the attempt counter and restarts the automatic retry schedule from the beginning.
- [POST /v1/subscriptions/:id/secrets/rotate](https://docs.offthehook.dev/api/secrets-rotate.md): Rotate a subscription's webhook signing secret. During the grace period, deliveries are signed with both old and new secrets so you can deploy without downtime.
- [POST /v1/subscriptions](https://docs.offthehook.dev/api/subscriptions/create.md): Create a new webhook subscription with a destination URL and event list. Returns the full resource including the signing secret, which is only revealed once.
- [DELETE /v1/subscriptions/:id](https://docs.offthehook.dev/api/subscriptions/delete.md): Permanently delete a subscription and all its address filters. In-flight deliveries may still complete. This action cannot be undone.
- [GET /v1/subscriptions/:id](https://docs.offthehook.dev/api/subscriptions/get.md): Retrieve a single subscription by ID. Returns the full resource with up to 200 inlined address filters. Use the addresses endpoint for larger lists.
- [GET /v1/subscriptions](https://docs.offthehook.dev/api/subscriptions/list.md): List all subscriptions for your API key. Returns a paginated list ordered by creation date descending. Address filters are not inlined in list responses.
- [PUT /v1/subscriptions/:id](https://docs.offthehook.dev/api/subscriptions/update.md): Replace a subscription's destination URL, events, status, and description in a single call. Does not affect address filters or the signing secret.
- [POST /v1/subscriptions/:id/test](https://docs.offthehook.dev/api/test.md): Send a synthetic webhook event to your destination without waiting for on-chain activity. Use this to test your endpoint and signature verification.
- [Authenticate with Off the Hook](https://docs.offthehook.dev/authentication.md): All Off the Hook API requests use Bearer token authentication. Pass your oth_… API key in the Authorization header on every request.
- [Supported TRON Networks](https://docs.offthehook.dev/concepts/chains.md): Off the Hook monitors three TRON networks identified by CAIP-2 chain IDs. Use tron:mainnet for production and tron:nile or tron:shasta for testing.
- [Webhook Events and Payload Structure](https://docs.offthehook.dev/concepts/events.md): Learn how Off the Hook structures webhook event payloads, what fields every delivery contains, and how to use the event ID for deduplication.
- [What is a Subscription?](https://docs.offthehook.dev/concepts/subscriptions.md): A subscription defines what blockchain addresses Off the Hook watches and where it delivers webhook notifications when a transfer is detected.
- [Manage Address Filters](https://docs.offthehook.dev/guides/manage-addresses.md): Add, remove, and replace TRON addresses in a subscription's filter list. Off the Hook fires webhooks only for transfers involving these addresses.
- [Receive Webhook Deliveries](https://docs.offthehook.dev/guides/receive-webhooks.md): Set up an HTTPS endpoint to receive Off the Hook webhook POSTs, handle retries, and respond correctly so deliveries are marked successful.
- [View and Retry Failed Events](https://docs.offthehook.dev/guides/retry-events.md): Inspect delivery attempts for a subscription and manually trigger a retry for events that failed after exhausting automatic retries.
- [Rotate Webhook Signing Secrets](https://docs.offthehook.dev/guides/rotate-secrets.md): Rotate a subscription's signing secret without downtime. Off the Hook signs with both old and new secrets during a configurable grace period.
- [Verify Webhook Signatures](https://docs.offthehook.dev/guides/verify-signatures.md): Off the Hook signs every delivery with HMAC-SHA256 using the Standard Webhooks spec. Use the Svix library or implement verification yourself.
- [Off the Hook: Webhooks for TRON Blockchain](https://docs.offthehook.dev/introduction.md): Off the Hook delivers real-time, HMAC-signed webhook notifications for TRX, USDT, USDC, and any TRC-20 token transfer on TRON Mainnet, Nile, and Shasta.
- [Get started with Off the Hook](https://docs.offthehook.dev/quickstart.md): Create your first TRON webhook subscription and receive a live transfer notification in four steps using the Off the Hook REST API.
- [Webhook Delivery Headers](https://docs.offthehook.dev/reference/delivery-headers.md): Every Off the Hook webhook POST includes Standard Webhooks signature headers plus an extension header. Use these to verify authenticity and route deliveries.
- [API Error Codes](https://docs.offthehook.dev/reference/error-codes.md): Every Off the Hook API error returns a stable error code, a human-readable message, and a requestId for support. Switch on the code in your error handling.
- [Event Types Reference](https://docs.offthehook.dev/reference/event-types.md): Complete list of Off the Hook event kinds, their payload fields, and availability status. Use these kind strings in your subscription's events array.