---
title: "Retrieve a webhook"
method: GET
path: "/webhook/{id}"
tags: ["webhook"]
---

# Retrieve a webhook

`GET /webhook/{id}`

## Path parameters

- `id` string, required

## Response `200`

Success

- Webhook
  - `id` string
  - `name` string, required
  - `kind` string
  - `userId` string
  - `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-05-17** `fc477586b24c` — 1 breaking, 2 info
  - the response property `errors` became optional for the status `default`
  - added the optional property `kind` to the response with the `200` status
  - added the optional property `userId` to the response with the `200` status
- **2024-05-14** `41d846566009` — 1 warning
  - removed the optional property `projectId` from the response with the `200` status
- **2024-05-10** `9a1157a504ba` — 1 info
  - added the optional property `projectId` to the response with the `200` status
- **2024-04-23** `d0909f9b9414` — 2 info
  - api operation id `getWebhook` was added
  - api tag `webhook` added

[Change history](https://skmtc.dev/livepeer/apis/livepeer-api-reference/changes/webhook/:id/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/fc477586b24c/schema)