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

# List webhook endpoints

`GET /v1/webhooks`

## Request

- Base URL: `https://serp-agent.com`
- URL: `https://serp-agent.com/v1/webhooks`
- Auth: HTTP bearer

All endpoints on the account, oldest first. The signing secret is masked (shown only at creation).

## Response `200`

The account's endpoints.

- WebhookList
  - `webhooks` WebhookEndpoint[], required
    - `webhook_id` string, required
    - `url` string, uri, required
    - `events` string[], required
    - `active` boolean, required: False after 50 consecutive delivery failures (auto-deactivated) — delete and re-register to resume.
    - `secret` string, required: Always masked in listings.
    - `failure_count` integer, required: Consecutive delivery failures; reset to 0 on success.
    - `last_success_at` string, date-time, nullable, required
    - `last_failure_at` string, date-time, nullable, required
    - `created_at` string, date-time, required

## Other responses

- `401`: Missing, malformed, unknown, revoked, or expired API key. Codes: `unauthorized`, `key_revoked`, `key_expired`.
- `429`: Rate limit exceeded (600 requests/minute per API key). Honor `Retry-After`.

---

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