Get all events

get

https://api.gusto-demo.com/v1/events

Fetch all events, going back up to 30 days, that your partner application has the required scopes for. Note that a partner does NOT have to have verified webhook subscriptions in order to utilize this endpoint.

📘 System Access Authentication

This endpoint uses the Bearer Auth scheme with the system-level access token in the HTTP Authorization header

scope: events:read

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

starting_after_uuid

string

A cursor for pagination. Returns all events occuring after the specified UUID (exclusive). Events are sorted according to the provided sort_order param.

resource_uuid

string

The UUID of the company. If not specified, will return all events for all companies.

limit

string

Limits the number of objects returned in a single response, between 1 and 100. The default is 25

event_type

string

A string containing the exact event name (e.g. employee.created), or use a wildcard match to filter for a group of events (e.g. employee.*, *.created, notification.*.created etc.)

sort_order

string

enum

A string indicating whether to sort resulting events in ascending (asc) or descending (desc) chronological order. Events are sorted by their timestamp. Defaults to asc if left empty.

Allowed:

Headers

X-Gusto-API-Version

string

enum

Defaults to 2026-02-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful

422Unprocessable Entity This may happen when the body of your request contains errors such as invalid_attribute_value, or the request fails due to an invalid_operation. See the Errors Categories guide for more details.