---
title: "List webhook request history"
method: GET
path: "/v1/webhook-requests/"
tags: ["Webhooks"]
---

# List webhook request history

`GET /v1/webhook-requests/`

Returns a paginated list of webhook requests filtered by the provided criteria.
Only webhook requests from the last 30 days are available.

## Query parameters

- `created_at__gte` string, date-time
- `created_at__lte` string, date-time
- `event_type` 'task-status-updated' | 'order-status-updated' | 'order-created' | 'link-connected' | 'link-disconnected' | 'order-refresh-failed' | 'link-deleted' | 'employment-created' | 'employment-updated' | 'profile-created' | 'profile-updated' | 'statements-created' | 'statements-updated' | 'shifts-created' | 'shifts-updated' | 'bank-accounts-created' | 'bank-accounts-updated' | 'certification-completed' | 'order-finalized'
- `status_code` integer
- `cursor` string
- `page_size` integer

## Response `200`

Paginated list of webhook requests

- WebhookRequestList
  - `next` string, nullable — Link to next page
  - `previous` string, nullable — Link to previous page
  - `results` WebhookRequestHistoryItem[] — List of webhook requests
    - `webhook_id` string — Unique identifier of the webhook.
    - `event_type` 'task-status-updated' | 'order-status-updated' | 'order-created' | 'link-connected' | 'link-disconnected' | 'order-refresh-failed' | 'link-deleted' | 'employment-created' | 'employment-updated' | 'profile-created' | 'profile-updated' | 'statements-created' | 'statements-updated' | 'shifts-created' | 'shifts-updated' | 'bank-accounts-created' | 'bank-accounts-updated' | 'certification-completed' | 'order-finalized' — Type of webhook event.
    - `event_created_at` string, date-time — Timestamp when the webhook event was created.
    - `status_code` integer, nullable — HTTP status code returned by the webhook endpoint. `0` indicates the request could not be delivered (no HTTP response).
    - `error_message` string, nullable — Error message if the webhook request failed.
    - `webhook_payload` object — The webhook payload that was sent (contains event-specific fields like link_id, task_id, etc.).
    - `webhook_url` string, uri — Webhook URL the request was sent to.

## Other responses

- `400` — Validation error. Possible errors include: - created_at__gte older than 30 days: "Cannot retrieve webhook requests older than 30 days" - created_at__gte > created_at__lte: "Must be less than or equal to created_at__lte" - status_code outside 100-599 range: validation error
- `401` — HTTP 401 Unauthorized

---

[API](https://skmtc.net/truv/apis/truv-api.md) · [All operations](https://skmtc.net/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truv/truv-api/versions/b92671dcb52d/schema)