---
title: "List Events"
method: GET
path: "/events"
---

# List Events

`GET /events`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `category.in` string[] — Filter Events for those with the specified category or categories. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`.
- `associated_object_id` string — Filter Events to those belonging to the object with the provided identifier.
- `order_by.direction` 'ascending' | 'descending' — The direction to order in.
- `order_by.field` 'created_at' — The field to order by.

## Response `200`

Event List

- EventList — A list of Event objects.
  - `data` Event[], required — The contents of the list.
    - `associated_object_id` string, required — The identifier of the object that generated this Event.
    - `associated_object_type` string, required — The type of the object that generated this Event.
    - `category` 'account.created' | 'account.updated' | 'account_number.created' | 'account_number.updated' | 'account_statement.created' | 'account_transfer.created' | 'account_transfer.updated' | 'ach_prenotification.created' | 'ach_prenotification.updated' | 'ach_transfer.created' | 'ach_transfer.updated' | 'blockchain_address.created' | 'blockchain_address.updated' | 'blockchain_offramp_transfer.created' | 'blockchain_offramp_transfer.updated' | 'blockchain_onramp_transfer.created' | 'blockchain_onramp_transfer.updated' | 'bookkeeping_account.created' | 'bookkeeping_account.updated' | 'bookkeeping_entry_set.updated' | 'card.created' | 'card.updated' | 'card_payment.created' | 'card_payment.updated' | 'card_purchase_supplement.created' | 'card_profile.created' | 'card_profile.updated' | 'card_dispute.created' | 'card_dispute.updated' | 'check_deposit.created' | 'check_deposit.updated' | 'check_transfer.created' | 'check_transfer.updated' | 'declined_transaction.created' | 'digital_card_profile.created' | 'digital_card_profile.updated' | 'digital_wallet_token.created' | 'digital_wallet_token.updated' | 'entity.created' | 'entity.updated' | 'event_subscription.created' | 'event_subscription.updated' | 'export.created' | 'export.updated' | 'external_account.created' | 'external_account.updated' | 'fednow_transfer.created' | 'fednow_transfer.updated' | 'file.created' | 'group.updated' | 'group.heartbeat' | 'inbound_ach_transfer.created' | 'inbound_ach_transfer.updated' | 'inbound_ach_transfer_return.created' | 'inbound_ach_transfer_return.updated' | 'inbound_check_deposit.created' | 'inbound_check_deposit.updated' | 'inbound_fednow_transfer.created' | 'inbound_fednow_transfer.updated' | 'inbound_mail_item.created' | 'inbound_mail_item.updated' | 'inbound_real_time_payments_transfer.created' | 'inbound_real_time_payments_transfer.updated' | 'inbound_wire_drawdown_request.created' | 'inbound_wire_transfer.created' | 'inbound_wire_transfer.updated' | 'intrafi_account_enrollment.created' | 'intrafi_account_enrollment.updated' | 'intrafi_exclusion.created' | 'intrafi_exclusion.updated' | 'lockbox.created' | 'lockbox.updated' | 'oauth_connection.created' | 'oauth_connection.deactivated' | 'card_push_transfer.created' | 'card_push_transfer.updated' | 'card_validation.created' | 'card_validation.updated' | 'pending_transaction.created' | 'pending_transaction.updated' | 'physical_card.created' | 'physical_card.updated' | 'physical_card_profile.created' | 'physical_card_profile.updated' | 'physical_check.created' | 'physical_check.updated' | 'program.created' | 'program.updated' | 'proof_of_authorization_request.created' | 'proof_of_authorization_request.updated' | 'real_time_decision.card_authorization_requested' | 'real_time_decision.card_balance_inquiry_requested' | 'real_time_decision.digital_wallet_token_requested' | 'real_time_decision.digital_wallet_authentication_requested' | 'real_time_decision.card_authentication_requested' | 'real_time_decision.card_authentication_challenge_requested' | 'real_time_payments_transfer.created' | 'real_time_payments_transfer.updated' | 'real_time_payments_request_for_payment.created' | 'real_time_payments_request_for_payment.updated' | 'swift_transfer.created' | 'swift_transfer.updated' | 'transaction.created' | 'wire_drawdown_request.created' | 'wire_drawdown_request.updated' | 'wire_transfer.created' | 'wire_transfer.updated', required — The category of the Event. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully.
    - `created_at` string, date-time, required — The time the Event was created.
    - `id` string, required — The Event identifier.
    - `type` 'event', required — A constant representing the object's type. For this resource it will always be `event`.
  - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

> 46 revisions in range; 1 could not be searched.

- **2026-04-28** `2f50481c658c` — 2 breaking, 2 info
  - removed the enum value `legacy_card_dispute.created` from the property `items/` of the `query` request parameter `category.in`
  - removed the enum value `legacy_card_dispute.updated` from the property `items/` of the `query` request parameter `category.in`
  - removed the `legacy_card_dispute.created` enum value from the `data/items/category` response property for the response status `200`
  - removed the `legacy_card_dispute.updated` enum value from the `data/items/category` response property for the response status `200`
- **2026-04-16** `b8ef37fb2b33` — 2 info
  - added the new optional `query` request parameter `order_by.direction`
  - added the new optional `query` request parameter `order_by.field`
- **2026-04-12** `a507102e6e65` — 1 warning, 1 info
  - added the new `card_purchase_supplement.created` enum value to the `data/items/category` response property for the response status `200`
  - added the enum value `card_purchase_supplement.created` to the property `items/` of the `query` request parameter `category.in`
- …earlier changes not shown

[Full history](https://skmtc.dev/increase/apis/increase-api/changes/events/get.md)

---

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