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

# List webhook subscriptions

`GET /webhooks`

## Request

- Base URL: `https://nautilinks.co/api/v1/agent`
- URL: `https://nautilinks.co/api/v1/agent/webhooks`
- Auth: HTTP bearer

Lists active and revoked webhook subscriptions owned by the API-key account.

## Response `200`

Webhook subscriptions.

- WebhookListResponse
  - `ok` true, required
  - `count` integer, required
  - `webhooks` Webhook[], required
    - `id` string, required
    - `url` string, uri, required
    - `events` WebhookEvent[], required
    - `created_at` string, required
    - `revoked_at` string, nullable, required
    - `last_triggered_at` string, nullable, required
    - `last_status` integer, nullable, required
    - `last_error` string, nullable, required

## Other responses

- `401`: The API key is missing, invalid, or revoked.
- `403`: The key lacks the required scope or resource ownership.
- `429`: The request quota or rolling daily order cap was reached.
- `500`: Nautilinks encountered an unexpected internal error.
- `default`: Any non-success status not listed explicitly uses the same typed error envelope.

---

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