Skip to main content
GET
List events

Authorizations

Authorization
string
header
required

Query Parameters

ending_before
string

Cursor for pagination. Use an event ID to define your place in the list. For example, if a list request returns 300 events starting with evt_bar, send ending_before=evt_bar in the next call to fetch the previous page.

limit
integer
default:30

Maximum number of events to return per page. Defaults to 30, with a maximum of 300.

resource_id
string

Returns only the events about this resource, such as a transfer or a payment intent ID.

since

Returns only the events created at or after this point in time. Accepts a calendar date, such as 2026-01-15, or an ISO 8601 datetime, such as 2026-01-15T14:30:00Z. Fintoc converts a datetime with a timezone offset to UTC. When you pass a date, the day starts at 00:00:00 UTC.

starting_after
string

Cursor for pagination. Use an event ID to define your place in the list. For example, if a list request returns 300 events ending with evt_foo, send starting_after=evt_foo in the next call to fetch the next page.

type
enum<string>

Returns only the events of this type.

Available options:
link.credentials_changed,
link.refresh_intent.succeeded,
link.refresh_intent.failed,
account.refresh_intent.succeeded,
account.refresh_intent.failed,
account.refresh_intent.rejected,
payment_intent.succeeded,
payment_intent.rejected,
payment_intent.failed,
payment_intent.pending,
payment_intent.expired,
subscription.activated,
subscription.canceled,
subscription.payment_method_updated,
subscription.payment_method_update_failed,
subscription_intent.succeeded,
subscription_intent.rejected,
subscription_intent.failed,
charge.succeeded,
charge.failed,
account.refresh_intent.movements_removed,
account.refresh_intent.movements_modified,
refund.succeeded,
refund.failed,
refund.in_progress,
payout.created,
payout.canceled,
payout.succeeded,
payout.returned,
checkout_session.finished,
checkout_session.expired,
transfer.inbound.succeeded,
transfer.outbound.succeeded,
transfer.outbound.failed,
transfer.outbound.returned,
transfer.inbound.returned,
transfer.inbound.return_failed,
account_number.deleted,
account_verification.succeeded,
account_verification.failed,
transfer.inbound.rejected,
payment_method.activated,
payment_method.canceled,
invoice.created,
invoice.finalized,
invoice.paid,
invoice.payment_created,
invoice.payment_failed,
invoice.payment_succeeded,
invoice.voided,
dispute.waiting_documentation,
dispute.in_review,
dispute.won,
dispute.lost,
dispute.expired,
entity.onboarding.approved,
entity.onboarding.rejected
until

Returns only the events created at or before this point in time. Accepts a calendar date, such as 2026-01-15, or an ISO 8601 datetime, such as 2026-01-15T14:30:00Z. Fintoc converts a datetime with a timezone offset to UTC. When you pass a date, the day ends at 23:59:59.999999 UTC, so the whole day is included.

Response

List of events for the current mode, sorted by creation date (most recent first).

id
string
required

Unique identifier of the event.

Example:

"evt_0ujsswThIGTUYm2K8FjOOfXtY1K"

object
any
required

Type of the object. Always event.

created_at
string<date-time>
required

Time when the event was created, as an ISO 8601 datetime in UTC with millisecond precision.

Example:

"2026-01-15T14:30:00.000Z"

data
object
required

Resource the event is about, in the same shape the API returns the resource. The resource depends on type: a transfer.outbound.succeeded event carries a transfer, and a payment_intent.succeeded event carries a payment intent.

Example:
mode
enum<string>
required

Whether the event happened in live or in test mode.

Available options:
live,
test
Example:

"live"

type
enum<string>
required

The kind of event that happened.

Available options:
link.credentials_changed,
link.refresh_intent.succeeded,
link.refresh_intent.failed,
account.refresh_intent.succeeded,
account.refresh_intent.failed,
account.refresh_intent.rejected,
payment_intent.succeeded,
payment_intent.rejected,
payment_intent.failed,
payment_intent.pending,
payment_intent.expired,
subscription.activated,
subscription.canceled,
subscription.payment_method_updated,
subscription.payment_method_update_failed,
subscription_intent.succeeded,
subscription_intent.rejected,
subscription_intent.failed,
charge.succeeded,
charge.failed,
account.refresh_intent.movements_removed,
account.refresh_intent.movements_modified,
refund.succeeded,
refund.failed,
refund.in_progress,
payout.created,
payout.canceled,
payout.succeeded,
payout.returned,
checkout_session.finished,
checkout_session.expired,
transfer.inbound.succeeded,
transfer.outbound.succeeded,
transfer.outbound.failed,
transfer.outbound.returned,
transfer.inbound.returned,
transfer.inbound.return_failed,
account_number.deleted,
account_verification.succeeded,
account_verification.failed,
transfer.inbound.rejected,
payment_method.activated,
payment_method.canceled,
invoice.created,
invoice.finalized,
invoice.paid,
invoice.payment_created,
invoice.payment_failed,
invoice.payment_succeeded,
invoice.voided,
dispute.waiting_documentation,
dispute.in_review,
dispute.won,
dispute.lost,
dispute.expired,
entity.onboarding.approved,
entity.onboarding.rejected
Example:

"transfer.outbound.succeeded"