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

# Get Webhooks

`GET /v1/webhooks`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/webhooks`
- Auth: HTTP bearer

List the account's per-agent webhook configuration(s).

Secrets are **masked**. Pass `agent_id` to inspect a single agent's webhook.
The full secret is only ever shown once, by set_webhook.

Returns {"webhooks": [...], "count"}: each has agent_id, url, masked
secret, signature_header, protocol, capabilities and created_at. An empty
list means no webhook is set, so events wait for poll_events. HTTP 404 if
agent_id is not an agent on this account.

## Query parameters

- `agent_id` string, nullable: Inspect one agent's webhook (omit to list all)

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)