---
title: "Get Events [Batch]"
method: GET
path: "/apiHub/webhooks/v1/events"
tags: ["Events"]
---

# Get Events \[Batch\]

`GET /apiHub/webhooks/v1/events`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apiHub/webhooks/v1/events`
- Auth: HTTP bearer

> 🚧 Early Access API Version
> This endpoint version is currently in Early Access and available only to approved early adoption (EA) participants. Do not rely on this version for production workloads unless explicitly authorized. If you have any feedback, please share with your designated Early Adoption program representative.

**Summary Description**

 Retrieves a list of webhook events that have been sent for a specific company. This endpoint allows clients to view event delivery history, including event type, timestamp, and delivery status. It is useful for monitoring webhook activity, auditing, and troubleshooting integrations.

## Query parameters

- `filter` string
- `limit` integer
- `include` string
- `includeTotalCount` boolean
- `offset` integer
- `sort` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- WebhookEventV1Response[]
  - `id` string, uuid: The unique identifier of the webhook event.
  - `correlationId` string, uuid: A correlation identifier used to trace the event across systems.
  - `subscriptionId` string, uuid: The unique identifier of the subscription the event was delivered to.
  - `subscriptionName` string, nullable: The name of the subscription the event was delivered to.
  - `clientId` string, nullable: The ID of the API credentials that own the subscription.
  - `applicationId` string, uuid, nullable: The ID of the application associated with the API credentials.
  - `type` string, nullable: The event type (e.g. `employee.person.v1`, `employee.assignment.v1`).
  - `mutation` string, nullable: The type of change made to the resource (e.g. `created`, `updated`, `deleted`).
  - `time` string, date-time: The date and time the event occurred.
  - `dataContentType` string, nullable: The content type of the event payload.
  - `data` object, nullable: The event payload. Structure varies by event type.
  - `status` string, nullable: The delivery status of the event (e.g. `Delivered`, `Failed`, `Pending`).
  - `lastStatusCode` string, nullable: The HTTP status code returned by the most recent delivery attempt.
  - `totalAttempts` integer: The total number of delivery attempts made for the event.
  - `logs` WebhookEventLogV1Response[], nullable: Array of delivery attempt logs for the event. Returned when `include=logs` is specified.
    - `id` string, uuid: The unique identifier of the log entry.
    - `attemptNumber` integer: The delivery attempt number.
    - `responseCode` string, nullable: The HTTP status code returned by the webhook URL for this attempt.
    - `response` string, nullable: The response body returned by the webhook URL for this attempt.
    - `durationMs` integer: The duration of the delivery attempt in milliseconds.
    - `createdAt` string, date-time, nullable: The date and time the delivery attempt was made.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/paylocity/apis/webhooks-api.md) - [All operations](https://skmtc.dev/paylocity/apis/webhooks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/webhooks-api/revisions/4206e9534cc6?raw)