---
title: "List Webhooks"
method: GET
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# List Webhooks

`GET /v1/webhooks`

## Request

- Base URL: `https://api.racehooks.io`
- URL: `https://api.racehooks.io/v1/webhooks`
- Auth: API key in header `Authorization`

List webhook endpoints for the authenticated client. Endpoints group all feeds that share one URL/secret. Pass ?shape=flat for the legacy one-row-per-feed list.

## Query parameters

- `limit` integer
- `offset` integer
- `shape` 'grouped' | 'flat'

## Response `200`

Default Response

- object
  - `data` object
    - `endpoints` object[]
      - `webhookId` string
      - `webhookUrl` string
      - `webhookMethod` string
      - `seriesId` string
      - `active` boolean
      - `subscriptionTier` string
      - `feedCount` integer
      - `subscriptions` object[]
        - `feedId` string
        - `seriesId` string
        - `filters` object
        - `active` boolean
        - `subscriptionTier` string
        - `consecutiveFailures` integer
        - `autoDisabledAt` string, nullable
        - `createdAt` string, date-time
        - `updatedAt` string, date-time
      - `stats` object
        - `successRate7d` number, nullable
        - `totalDeliveries7d` integer
        - `lastDeliveryAt` string, date-time, nullable
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `webhooks` object[]
      - `webhookId` string
      - `feedId` string
      - `seriesId` string
      - `webhookUrl` string
      - `webhookMethod` string
      - `active` boolean
      - `subscriptionTier` string
      - `filters` object
      - `consecutiveFailures` integer
      - `autoDisabledAt` string, nullable
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `total` integer
    - `limit` integer
    - `offset` integer

## Other responses

- `401`: Missing or invalid Bearer token
- `404`: Webhook not found

---

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