---
title: "Get webhook requests"
method: GET
path: "/v2/webhooks/{webhook_id}/requests"
tags: ["Webhooks"]
---

# Get webhook requests

`GET /v2/webhooks/{webhook_id}/requests`

Returns all webhook requests sent within the last week. Useful for debugging.

## Path parameters

- `webhook_id` string, required

## Response `200`

Response from the GET /v2/webhooks/{webhook_id}/requests endpoint.

- object
  - `requests` WebhookV2Request[], required — An array of webhook requests.
    - `webhook_id` string, required — The ID of the webhook the requests were sent to
    - `request_info` WebhookV2RequestInfo, required — Information regarding the request sent to a webhook endpoint
      - `id` string, required — The ID of the webhook
      - `endpoint` string, required — The actual endpoint the request was sent to
      - `payload` object, required — The contents of the request that was sent to the endpoint
      - `sent_at` string, date-time, required — UTC ISO 8601 timestamp of when the request was sent
    - `response_info` WebhookV2ResponseInfo, nullable, required — Information regarding the reply sent back from a webhook endpoint
      - `status` string, required — HTTP status code of the response
      - `received_at` string, date-time, required — UTC ISO 8601 timestamp of when the response was received
    - `error_msg` string, nullable, required — Error message for this request. NULL if no error occurred

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `404` — The requested file or resource was not found.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

## Changes

> 36 revisions in range; 33 could not be searched.

- **2023-12-14** `de5c0106668d` — 2 info
  - the endpoint scheme security `PlanAccessToken` was removed from the API
  - the security scope `webhooks:read` was removed from the endpoint's security scheme `OAuth2`

[Change history](https://skmtc.dev/figma/apis/figma-api/changes/v2/webhooks/:webhook_id/requests/get.md)

---

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