---
title: "Retrieve a Webhook"
method: GET
path: "/webhook"
tags: ["webhook"]
---

# Retrieve a Webhook

`GET /webhook`

## Response `200`

Success

- Webhook[]
  - `id` string
  - `name` string, required
  - `kind` string
  - `userId` string
  - `projectId` string — The ID of the project
  - `createdAt` number — Timestamp (in milliseconds) at which stream object was created
  - `events` string[]
  - `url` string, uri, required
  - `sharedSecret` string — shared secret used to sign the webhook payload
  - `streamId` string — streamId of the stream on which the webhook is applied
  - `status` object — status of webhook
    - `lastFailure` object — failure timestamp and error message with status code
      - `timestamp` number — Timestamp (in milliseconds) at which the webhook last failed
      - `error` string — Webhook failure error message
      - `response` string — Webhook failure response
      - `statusCode` number — Webhook failure status code
    - `lastTriggeredAt` number — Timestamp (in milliseconds) at which the webhook last was triggered

## Other responses

- `default` — Error

## Changes

- **2024-06-11** `7c015b7e287c` — 1 info
  - added the optional property `items/projectId` to the response with the `200` status
- **2024-06-11** `8ccb056ca148` — 1 warning
  - removed the optional property `items/projectId` from the response with the `200` status
- **2024-06-11** `7c015b7e287c` — 1 info
  - added the optional property `items/projectId` to the response with the `200` status
- **2024-06-11** `8ccb056ca148` — 1 warning
  - removed the optional property `items/projectId` from the response with the `200` status
- **2024-06-06** `03d095353d75` — 1 info
  - added the optional property `items/projectId` to the response with the `200` status

[Full history](https://skmtc.dev/livepeer/apis/livepeer-api-reference/changes/webhook/get.md)

---

[API](https://skmtc.dev/livepeer/apis/livepeer-api-reference.md) · [All operations](https://skmtc.dev/livepeer/apis/livepeer-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/livepeer/livepeer-api-reference/revisions/0d7e15217608/schema)