---
title: "List webhooks (API Pro and above)"
method: GET
path: "/api/bot/v1/webhooks"
tags: ["Paper trading"]
---

# List webhooks (API Pro and above)

`GET /api/bot/v1/webhooks`

## Request

- Base URL: `https://marginpad.io`
- URL: `https://marginpad.io/api/bot/v1/webhooks`
- Auth: API key in header `X-API-Key`

Your registered webhooks with delivery counts, consecutive failures, the last error and whether each is active. Also lists the event names and the signature scheme.

## Response `200`

ok

- Webhooks
  - `webhooks` Webhook[]
    - `id` string
    - `url` string
    - `secret` string: HMAC key for X-MP-Signature
    - `events` string[]
    - `created` integer
    - `last_delivery_ts` integer, nullable
    - `deliveries` integer
    - `consecutive_failures` integer
    - `active` boolean
    - `last_error` string, nullable
  - `pending_deliveries` integer
  - `max` integer
  - `events` string[]
  - `signature` string

## Other responses

- `402`: Premium required

---

[API](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api.md) · [All operations](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/revisions/27d21fcd0bf0?raw)