---
title: "Get Webhook Events"
method: GET
path: "/api/webhooks/list/{daysHistory}"
tags: ["Webhooks"]
---

# Get Webhook Events

`GET /api/webhooks/list/{daysHistory}`

## Request

- Base URL: `https://app.timetastic.co.uk` (the document declares no server; this is the origin it was published from)
- URL: `https://app.timetastic.co.uk/api/webhooks/list/{daysHistory}`
- Auth: none declared

Get a list of the recent Webhook items (defaults to the last day).
The dashboard will show events raised in the last day.
Timetastic retains 30 days of Webhook event history and you can access this via the API.
            
`daysHistory` is optional and defaults to 1. It is capped at 30 — a larger value is silently
reduced rather than rejected.

## Query parameters

- `daysHistory` integer

## Response `200`

The recent webhook events. An empty list if there were none in that window.

- TimetasticCoreModelsWebhookEvent[]
  - `id` integer: The Event ID
  - `organisationId` integer: Your Organisation ID
  - `recordId` integer: The recordID associated with this event
  - `userId` integer: The UserID that raised this event
  - `retryCount` integer: How many attempts to deliver this event there have been
  - `eventType` 0 | 1 | 2 | 3 | 4 | 5 | 6: The Event Type ID - `0` — **TestEvent** - `1` — **AbsenceRequested** - `2` — **AbsenceApproved** - `3` — **AbsenceDeclined** - `4` — **AbsenceCancelled** - `5` — **AbsenceBooked** - `6` — **AbsenceUpdated**
  - `expiresAt` string, date-time: The Expiry Date and Time (UTC)
  - `timestamp` string, date-time: When the Event was raised (UTC)
  - `isProcessed` boolean: true if your server has responded success, otherwise false
  - `lastProcessedAt` string, date-time, nullable: The UTC Time that the event was last attempted
  - `lastResponseCode` integer: The HTTP Code we last received from your server (trimmed to 4000 characters)
  - `lastResponseDetail` string, nullable: The HTTP Content we last received from your server
  - `nextAttempt` string, date-time: The scheduled time this event will be next attempted (there may be a short delay if many events are queued)
  - `url` string, nullable: The URL assigned to this event
  - `type` 0: Used internally for the type of webhook we're sending. For your requests this will always be 0 - `0` — **Timetastic**

## Other responses

- `401`: The request was not authenticated — the API token is missing or invalid.
- `403`: The authenticated user is not an administrator.

---

[API](https://skmtc.dev/timetastic/apis/timetastic-api.md) · [All operations](https://skmtc.dev/timetastic/apis/timetastic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/timetastic/apis/timetastic-api/revisions/709ccb0412c3?raw)
