event.go

// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

package increase

import (
	"context"
	"encoding/base64"
	"errors"
	"fmt"
	"net/http"
	"net/url"
	"slices"
	"time"

	"github.com/Increase/increase-go/internal/apijson"
	"github.com/Increase/increase-go/internal/apiquery"
	"github.com/Increase/increase-go/internal/param"
	"github.com/Increase/increase-go/internal/requestconfig"
	"github.com/Increase/increase-go/option"
	"github.com/Increase/increase-go/packages/pagination"
	standardwebhooks "github.com/standard-webhooks/standard-webhooks/libraries/go"
)

// EventService contains methods and other services that help with interacting with
// the increase API.
//
// Note, unlike clients, this service does not read variables from the environment
// automatically. You should not instantiate this service directly, and instead use
// the [NewEventService] method instead.
type EventService struct {
	Options []option.RequestOption
}

// NewEventService generates a new service that applies the given options to each
// request. These options are applied after the parent client's options (if there
// is one), and before any request-specific options.
func NewEventService(opts ...option.RequestOption) (r *EventService) {
	r = &EventService{}
	r.Options = opts
	return
}

// Retrieve an Event
func (r *EventService) Get(ctx context.Context, eventID string, opts ...option.RequestOption) (res *Event, err error) {
	opts = slices.Concat(r.Options, opts)
	if eventID == "" {
		err = errors.New("missing required event_id parameter")
		return nil, err
	}
	path := fmt.Sprintf("events/%s", eventID)
	err = requestconfig.ExecuteNewRequest(ctx, http.MethodGet, path, nil, &res, opts...)
	return res, err
}

// List Events
func (r *EventService) List(ctx context.Context, query EventListParams, opts ...option.RequestOption) (res *pagination.Page[Event], err error) {
	var raw *http.Response
	opts = slices.Concat(r.Options, opts)
	opts = append([]option.RequestOption{option.WithResponseInto(&raw)}, opts...)
	path := "events"
	cfg, err := requestconfig.NewRequestConfig(ctx, http.MethodGet, path, query, &res, opts...)
	if err != nil {
		return nil, err
	}
	err = cfg.Execute()
	if err != nil {
		return nil, err
	}
	res.SetPageConfig(cfg, raw)
	return res, nil
}

// List Events
func (r *EventService) ListAutoPaging(ctx context.Context, query EventListParams, opts ...option.RequestOption) *pagination.PageAutoPager[Event] {
	return pagination.NewPageAutoPager(r.List(ctx, query, opts...))
}

func (r *EventService) Unwrap(payload []byte, headers http.Header, opts ...option.RequestOption) (*UnwrapWebhookEvent, error) {
	opts = slices.Concat(r.Options, opts)
	cfg, err := requestconfig.PreRequestOptions(opts...)
	if err != nil {
		return nil, err
	}
	rawKey := cfg.WebhookSecret
	if rawKey == "" {
		return nil, errors.New("The WebhookSecret option must be set in order to verify webhook headers")
	}
	key := "whsec_" + base64.StdEncoding.EncodeToString([]byte(rawKey))
	wh, err := standardwebhooks.NewWebhook(key)
	if err != nil {
		return nil, err
	}
	err = wh.Verify(payload, headers)
	if err != nil {
		return nil, err
	}
	res := &UnwrapWebhookEvent{}
	err = res.UnmarshalJSON(payload)
	if err != nil {
		return res, err
	}
	return res, nil
}

// Events are records of things that happened to objects at Increase. Events are
// accessible via the List Events endpoint and can be delivered to your application
// via webhooks. For more information, see our
// [webhooks guide](https://increase.com/documentation/webhooks).
type Event struct {
	// The Event identifier.
	ID string `json:"id" api:"required"`
	// The identifier of the object that generated this Event.
	AssociatedObjectID string `json:"associated_object_id" api:"required"`
	// The type of the object that generated this Event.
	AssociatedObjectType string `json:"associated_object_type" api:"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.
	Category EventCategory `json:"category" api:"required"`
	// The time the Event was created.
	CreatedAt time.Time `json:"created_at" api:"required" format:"date-time"`
	// A constant representing the object's type. For this resource it will always be
	// `event`.
	Type EventType `json:"type" api:"required"`
	JSON eventJSON `json:"-"`
}

// eventJSON contains the JSON metadata for the struct [Event]
type eventJSON struct {
	ID                   apijson.Field
	AssociatedObjectID   apijson.Field
	AssociatedObjectType apijson.Field
	Category             apijson.Field
	CreatedAt            apijson.Field
	Type                 apijson.Field
	raw                  string
	ExtraFields          map[string]apijson.Field
}

func (r *Event) UnmarshalJSON(data []byte) (err error) {
	return apijson.UnmarshalRoot(data, r)
}

func (r eventJSON) RawJSON() string {
	return r.raw
}

// 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.
type EventCategory string

const (
	EventCategoryAccountCreated                                       EventCategory = "account.created"
	EventCategoryAccountUpdated                                       EventCategory = "account.updated"
	EventCategoryAccountNumberCreated                                 EventCategory = "account_number.created"
	EventCategoryAccountNumberUpdated                                 EventCategory = "account_number.updated"
	EventCategoryAccountStatementCreated                              EventCategory = "account_statement.created"
	EventCategoryAccountTransferCreated                               EventCategory = "account_transfer.created"
	EventCategoryAccountTransferUpdated                               EventCategory = "account_transfer.updated"
	EventCategoryACHPrenotificationCreated                            EventCategory = "ach_prenotification.created"
	EventCategoryACHPrenotificationUpdated                            EventCategory = "ach_prenotification.updated"
	EventCategoryACHTransferCreated                                   EventCategory = "ach_transfer.created"
	EventCategoryACHTransferUpdated                                   EventCategory = "ach_transfer.updated"
	EventCategoryBlockchainAddressCreated                             EventCategory = "blockchain_address.created"
	EventCategoryBlockchainAddressUpdated                             EventCategory = "blockchain_address.updated"
	EventCategoryBlockchainOfframpTransferCreated                     EventCategory = "blockchain_offramp_transfer.created"
	EventCategoryBlockchainOfframpTransferUpdated                     EventCategory = "blockchain_offramp_transfer.updated"
	EventCategoryBlockchainOnrampTransferCreated                      EventCategory = "blockchain_onramp_transfer.created"
	EventCategoryBlockchainOnrampTransferUpdated                      EventCategory = "blockchain_onramp_transfer.updated"
	EventCategoryBookkeepingAccountCreated                            EventCategory = "bookkeeping_account.created"
	EventCategoryBookkeepingAccountUpdated                            EventCategory = "bookkeeping_account.updated"
	EventCategoryBookkeepingEntrySetUpdated                           EventCategory = "bookkeeping_entry_set.updated"
	EventCategoryCardCreated                                          EventCategory = "card.created"
	EventCategoryCardUpdated                                          EventCategory = "card.updated"
	EventCategoryCardPaymentCreated                                   EventCategory = "card_payment.created"
	EventCategoryCardPaymentUpdated                                   EventCategory = "card_payment.updated"
	EventCategoryCardProfileCreated                                   EventCategory = "card_profile.created"
	EventCategoryCardProfileUpdated                                   EventCategory = "card_profile.updated"
	EventCategoryCardDisputeCreated                                   EventCategory = "card_dispute.created"
	EventCategoryCardDisputeUpdated                                   EventCategory = "card_dispute.updated"
	EventCategoryCheckDepositCreated                                  EventCategory = "check_deposit.created"
	EventCategoryCheckDepositUpdated                                  EventCategory = "check_deposit.updated"
	EventCategoryCheckTransferCreated                                 EventCategory = "check_transfer.created"
	EventCategoryCheckTransferUpdated                                 EventCategory = "check_transfer.updated"
	EventCategoryDeclinedTransactionCreated                           EventCategory = "declined_transaction.created"
	EventCategoryDigitalCardProfileCreated                            EventCategory = "digital_card_profile.created"
	EventCategoryDigitalCardProfileUpdated                            EventCategory = "digital_card_profile.updated"
	EventCategoryDigitalWalletTokenCreated                            EventCategory = "digital_wallet_token.created"
	EventCategoryDigitalWalletTokenUpdated                            EventCategory = "digital_wallet_token.updated"
	EventCategoryDocumentCreated                                      EventCategory = "document.created"
	EventCategoryEntityCreated                                        EventCategory = "entity.created"
	EventCategoryEntityUpdated                                        EventCategory = "entity.updated"
	EventCategoryEventSubscriptionCreated                             EventCategory = "event_subscription.created"
	EventCategoryEventSubscriptionUpdated                             EventCategory = "event_subscription.updated"
	EventCategoryExportCreated                                        EventCategory = "export.created"
	EventCategoryExportUpdated                                        EventCategory = "export.updated"
	EventCategoryExternalAccountCreated                               EventCategory = "external_account.created"
	EventCategoryExternalAccountUpdated                               EventCategory = "external_account.updated"
	EventCategoryFednowTransferCreated                                EventCategory = "fednow_transfer.created"
	EventCategoryFednowTransferUpdated                                EventCategory = "fednow_transfer.updated"
	EventCategoryFileCreated                                          EventCategory = "file.created"
	EventCategoryGroupUpdated                                         EventCategory = "group.updated"
	EventCategoryGroupHeartbeat                                       EventCategory = "group.heartbeat"
	EventCategoryInboundACHTransferCreated                            EventCategory = "inbound_ach_transfer.created"
	EventCategoryInboundACHTransferUpdated                            EventCategory = "inbound_ach_transfer.updated"
	EventCategoryInboundACHTransferReturnCreated                      EventCategory = "inbound_ach_transfer_return.created"
	EventCategoryInboundACHTransferReturnUpdated                      EventCategory = "inbound_ach_transfer_return.updated"
	EventCategoryInboundCheckDepositCreated                           EventCategory = "inbound_check_deposit.created"
	EventCategoryInboundCheckDepositUpdated                           EventCategory = "inbound_check_deposit.updated"
	EventCategoryInboundFednowTransferCreated                         EventCategory = "inbound_fednow_transfer.created"
	EventCategoryInboundFednowTransferUpdated                         EventCategory = "inbound_fednow_transfer.updated"
	EventCategoryInboundMailItemCreated                               EventCategory = "inbound_mail_item.created"
	EventCategoryInboundMailItemUpdated                               EventCategory = "inbound_mail_item.updated"
	EventCategoryInboundRealTimePaymentsTransferCreated               EventCategory = "inbound_real_time_payments_transfer.created"
	EventCategoryInboundRealTimePaymentsTransferUpdated               EventCategory = "inbound_real_time_payments_transfer.updated"
	EventCategoryInboundWireDrawdownRequestCreated                    EventCategory = "inbound_wire_drawdown_request.created"
	EventCategoryInboundWireTransferCreated                           EventCategory = "inbound_wire_transfer.created"
	EventCategoryInboundWireTransferUpdated                           EventCategory = "inbound_wire_transfer.updated"
	EventCategoryIntrafiAccountEnrollmentCreated                      EventCategory = "intrafi_account_enrollment.created"
	EventCategoryIntrafiAccountEnrollmentUpdated                      EventCategory = "intrafi_account_enrollment.updated"
	EventCategoryIntrafiExclusionCreated                              EventCategory = "intrafi_exclusion.created"
	EventCategoryIntrafiExclusionUpdated                              EventCategory = "intrafi_exclusion.updated"
	EventCategoryLegacyCardDisputeCreated                             EventCategory = "legacy_card_dispute.created"
	EventCategoryLegacyCardDisputeUpdated                             EventCategory = "legacy_card_dispute.updated"
	EventCategoryLockboxCreated                                       EventCategory = "lockbox.created"
	EventCategoryLockboxUpdated                                       EventCategory = "lockbox.updated"
	EventCategoryOAuthConnectionCreated                               EventCategory = "oauth_connection.created"
	EventCategoryOAuthConnectionDeactivated                           EventCategory = "oauth_connection.deactivated"
	EventCategoryCardPushTransferCreated                              EventCategory = "card_push_transfer.created"
	EventCategoryCardPushTransferUpdated                              EventCategory = "card_push_transfer.updated"
	EventCategoryCardValidationCreated                                EventCategory = "card_validation.created"
	EventCategoryCardValidationUpdated                                EventCategory = "card_validation.updated"
	EventCategoryPendingTransactionCreated                            EventCategory = "pending_transaction.created"
	EventCategoryPendingTransactionUpdated                            EventCategory = "pending_transaction.updated"
	EventCategoryPhysicalCardCreated                                  EventCategory = "physical_card.created"
	EventCategoryPhysicalCardUpdated                                  EventCategory = "physical_card.updated"
	EventCategoryPhysicalCardProfileCreated                           EventCategory = "physical_card_profile.created"
	EventCategoryPhysicalCardProfileUpdated                           EventCategory = "physical_card_profile.updated"
	EventCategoryPhysicalCheckCreated                                 EventCategory = "physical_check.created"
	EventCategoryPhysicalCheckUpdated                                 EventCategory = "physical_check.updated"
	EventCategoryProgramCreated                                       EventCategory = "program.created"
	EventCategoryProgramUpdated                                       EventCategory = "program.updated"
	EventCategoryProofOfAuthorizationRequestCreated                   EventCategory = "proof_of_authorization_request.created"
	EventCategoryProofOfAuthorizationRequestUpdated                   EventCategory = "proof_of_authorization_request.updated"
	EventCategoryRealTimeDecisionCardAuthorizationRequested           EventCategory = "real_time_decision.card_authorization_requested"
	EventCategoryRealTimeDecisionCardBalanceInquiryRequested          EventCategory = "real_time_decision.card_balance_inquiry_requested"
	EventCategoryRealTimeDecisionDigitalWalletTokenRequested          EventCategory = "real_time_decision.digital_wallet_token_requested"
	EventCategoryRealTimeDecisionDigitalWalletAuthenticationRequested EventCategory = "real_time_decision.digital_wallet_authentication_requested"
	EventCategoryRealTimeDecisionCardAuthenticationRequested          EventCategory = "real_time_decision.card_authentication_requested"
	EventCategoryRealTimeDecisionCardAuthenticationChallengeRequested EventCategory = "real_time_decision.card_authentication_challenge_requested"
	EventCategoryRealTimePaymentsTransferCreated                      EventCategory = "real_time_payments_transfer.created"
	EventCategoryRealTimePaymentsTransferUpdated                      EventCategory = "real_time_payments_transfer.updated"
	EventCategoryRealTimePaymentsRequestForPaymentCreated             EventCategory = "real_time_payments_request_for_payment.created"
	EventCategoryRealTimePaymentsRequestForPaymentUpdated             EventCategory = "real_time_payments_request_for_payment.updated"
	EventCategorySwiftTransferCreated                                 EventCategory = "swift_transfer.created"
	EventCategorySwiftTransferUpdated                                 EventCategory = "swift_transfer.updated"
	EventCategoryTransactionCreated                                   EventCategory = "transaction.created"
	EventCategoryWireDrawdownRequestCreated                           EventCategory = "wire_drawdown_request.created"
	EventCategoryWireDrawdownRequestUpdated                           EventCategory = "wire_drawdown_request.updated"
	EventCategoryWireTransferCreated                                  EventCategory = "wire_transfer.created"
	EventCategoryWireTransferUpdated                                  EventCategory = "wire_transfer.updated"
)

func (r EventCategory) IsKnown() bool {
	switch r {
	case EventCategoryAccountCreated, EventCategoryAccountUpdated, EventCategoryAccountNumberCreated, EventCategoryAccountNumberUpdated, EventCategoryAccountStatementCreated, EventCategoryAccountTransferCreated, EventCategoryAccountTransferUpdated, EventCategoryACHPrenotificationCreated, EventCategoryACHPrenotificationUpdated, EventCategoryACHTransferCreated, EventCategoryACHTransferUpdated, EventCategoryBlockchainAddressCreated, EventCategoryBlockchainAddressUpdated, EventCategoryBlockchainOfframpTransferCreated, EventCategoryBlockchainOfframpTransferUpdated, EventCategoryBlockchainOnrampTransferCreated, EventCategoryBlockchainOnrampTransferUpdated, EventCategoryBookkeepingAccountCreated, EventCategoryBookkeepingAccountUpdated, EventCategoryBookkeepingEntrySetUpdated, EventCategoryCardCreated, EventCategoryCardUpdated, EventCategoryCardPaymentCreated, EventCategoryCardPaymentUpdated, EventCategoryCardProfileCreated, EventCategoryCardProfileUpdated, EventCategoryCardDisputeCreated, EventCategoryCardDisputeUpdated, EventCategoryCheckDepositCreated, EventCategoryCheckDepositUpdated, EventCategoryCheckTransferCreated, EventCategoryCheckTransferUpdated, EventCategoryDeclinedTransactionCreated, EventCategoryDigitalCardProfileCreated, EventCategoryDigitalCardProfileUpdated, EventCategoryDigitalWalletTokenCreated, EventCategoryDigitalWalletTokenUpdated, EventCategoryDocumentCreated, EventCategoryEntityCreated, EventCategoryEntityUpdated, EventCategoryEventSubscriptionCreated, EventCategoryEventSubscriptionUpdated, EventCategoryExportCreated, EventCategoryExportUpdated, EventCategoryExternalAccountCreated, EventCategoryExternalAccountUpdated, EventCategoryFednowTransferCreated, EventCategoryFednowTransferUpdated, EventCategoryFileCreated, EventCategoryGroupUpdated, EventCategoryGroupHeartbeat, EventCategoryInboundACHTransferCreated, EventCategoryInboundACHTransferUpdated, EventCategoryInboundACHTransferReturnCreated, EventCategoryInboundACHTransferReturnUpdated, EventCategoryInboundCheckDepositCreated, EventCategoryInboundCheckDepositUpdated, EventCategoryInboundFednowTransferCreated, EventCategoryInboundFednowTransferUpdated, EventCategoryInboundMailItemCreated, EventCategoryInboundMailItemUpdated, EventCategoryInboundRealTimePaymentsTransferCreated, EventCategoryInboundRealTimePaymentsTransferUpdated, EventCategoryInboundWireDrawdownRequestCreated, EventCategoryInboundWireTransferCreated, EventCategoryInboundWireTransferUpdated, EventCategoryIntrafiAccountEnrollmentCreated, EventCategoryIntrafiAccountEnrollmentUpdated, EventCategoryIntrafiExclusionCreated, EventCategoryIntrafiExclusionUpdated, EventCategoryLegacyCardDisputeCreated, EventCategoryLegacyCardDisputeUpdated, EventCategoryLockboxCreated, EventCategoryLockboxUpdated, EventCategoryOAuthConnectionCreated, EventCategoryOAuthConnectionDeactivated, EventCategoryCardPushTransferCreated, EventCategoryCardPushTransferUpdated, EventCategoryCardValidationCreated, EventCategoryCardValidationUpdated, EventCategoryPendingTransactionCreated, EventCategoryPendingTransactionUpdated, EventCategoryPhysicalCardCreated, EventCategoryPhysicalCardUpdated, EventCategoryPhysicalCardProfileCreated, EventCategoryPhysicalCardProfileUpdated, EventCategoryPhysicalCheckCreated, EventCategoryPhysicalCheckUpdated, EventCategoryProgramCreated, EventCategoryProgramUpdated, EventCategoryProofOfAuthorizationRequestCreated, EventCategoryProofOfAuthorizationRequestUpdated, EventCategoryRealTimeDecisionCardAuthorizationRequested, EventCategoryRealTimeDecisionCardBalanceInquiryRequested, EventCategoryRealTimeDecisionDigitalWalletTokenRequested, EventCategoryRealTimeDecisionDigitalWalletAuthenticationRequested, EventCategoryRealTimeDecisionCardAuthenticationRequested, EventCategoryRealTimeDecisionCardAuthenticationChallengeRequested, EventCategoryRealTimePaymentsTransferCreated, EventCategoryRealTimePaymentsTransferUpdated, EventCategoryRealTimePaymentsRequestForPaymentCreated, EventCategoryRealTimePaymentsRequestForPaymentUpdated, EventCategorySwiftTransferCreated, EventCategorySwiftTransferUpdated, EventCategoryTransactionCreated, EventCategoryWireDrawdownRequestCreated, EventCategoryWireDrawdownRequestUpdated, EventCategoryWireTransferCreated, EventCategoryWireTransferUpdated:
		return true
	}
	return false
}

// A constant representing the object's type. For this resource it will always be
// `event`.
type EventType string

const (
	EventTypeEvent EventType = "event"
)

func (r EventType) IsKnown() bool {
	switch r {
	case EventTypeEvent:
		return true
	}
	return false
}

// Events are records of things that happened to objects at Increase. Events are
// accessible via the List Events endpoint and can be delivered to your application
// via webhooks. For more information, see our
// [webhooks guide](https://increase.com/documentation/webhooks).
type UnwrapWebhookEvent struct {
	// The Event identifier.
	ID string `json:"id" api:"required"`
	// The identifier of the object that generated this Event.
	AssociatedObjectID string `json:"associated_object_id" api:"required"`
	// The type of the object that generated this Event.
	AssociatedObjectType string `json:"associated_object_type" api:"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.
	Category UnwrapWebhookEventCategory `json:"category" api:"required"`
	// The time the Event was created.
	CreatedAt time.Time `json:"created_at" api:"required" format:"date-time"`
	// A constant representing the object's type. For this resource it will always be
	// `event`.
	Type UnwrapWebhookEventType `json:"type" api:"required"`
	JSON unwrapWebhookEventJSON `json:"-"`
}

// unwrapWebhookEventJSON contains the JSON metadata for the struct
// [UnwrapWebhookEvent]
type unwrapWebhookEventJSON struct {
	ID                   apijson.Field
	AssociatedObjectID   apijson.Field
	AssociatedObjectType apijson.Field
	Category             apijson.Field
	CreatedAt            apijson.Field
	Type                 apijson.Field
	raw                  string
	ExtraFields          map[string]apijson.Field
}

func (r *UnwrapWebhookEvent) UnmarshalJSON(data []byte) (err error) {
	return apijson.UnmarshalRoot(data, r)
}

func (r unwrapWebhookEventJSON) RawJSON() string {
	return r.raw
}

// 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.
type UnwrapWebhookEventCategory string

const (
	UnwrapWebhookEventCategoryAccountCreated                                       UnwrapWebhookEventCategory = "account.created"
	UnwrapWebhookEventCategoryAccountUpdated                                       UnwrapWebhookEventCategory = "account.updated"
	UnwrapWebhookEventCategoryAccountNumberCreated                                 UnwrapWebhookEventCategory = "account_number.created"
	UnwrapWebhookEventCategoryAccountNumberUpdated                                 UnwrapWebhookEventCategory = "account_number.updated"
	UnwrapWebhookEventCategoryAccountStatementCreated                              UnwrapWebhookEventCategory = "account_statement.created"
	UnwrapWebhookEventCategoryAccountTransferCreated                               UnwrapWebhookEventCategory = "account_transfer.created"
	UnwrapWebhookEventCategoryAccountTransferUpdated                               UnwrapWebhookEventCategory = "account_transfer.updated"
	UnwrapWebhookEventCategoryACHPrenotificationCreated                            UnwrapWebhookEventCategory = "ach_prenotification.created"
	UnwrapWebhookEventCategoryACHPrenotificationUpdated                            UnwrapWebhookEventCategory = "ach_prenotification.updated"
	UnwrapWebhookEventCategoryACHTransferCreated                                   UnwrapWebhookEventCategory = "ach_transfer.created"
	UnwrapWebhookEventCategoryACHTransferUpdated                                   UnwrapWebhookEventCategory = "ach_transfer.updated"
	UnwrapWebhookEventCategoryBlockchainAddressCreated                             UnwrapWebhookEventCategory = "blockchain_address.created"
	UnwrapWebhookEventCategoryBlockchainAddressUpdated                             UnwrapWebhookEventCategory = "blockchain_address.updated"
	UnwrapWebhookEventCategoryBlockchainOfframpTransferCreated                     UnwrapWebhookEventCategory = "blockchain_offramp_transfer.created"
	UnwrapWebhookEventCategoryBlockchainOfframpTransferUpdated                     UnwrapWebhookEventCategory = "blockchain_offramp_transfer.updated"
	UnwrapWebhookEventCategoryBlockchainOnrampTransferCreated                      UnwrapWebhookEventCategory = "blockchain_onramp_transfer.created"
	UnwrapWebhookEventCategoryBlockchainOnrampTransferUpdated                      UnwrapWebhookEventCategory = "blockchain_onramp_transfer.updated"
	UnwrapWebhookEventCategoryBookkeepingAccountCreated                            UnwrapWebhookEventCategory = "bookkeeping_account.created"
	UnwrapWebhookEventCategoryBookkeepingAccountUpdated                            UnwrapWebhookEventCategory = "bookkeeping_account.updated"
	UnwrapWebhookEventCategoryBookkeepingEntrySetUpdated                           UnwrapWebhookEventCategory = "bookkeeping_entry_set.updated"
	UnwrapWebhookEventCategoryCardCreated                                          UnwrapWebhookEventCategory = "card.created"
	UnwrapWebhookEventCategoryCardUpdated                                          UnwrapWebhookEventCategory = "card.updated"
	UnwrapWebhookEventCategoryCardPaymentCreated                                   UnwrapWebhookEventCategory = "card_payment.created"
	UnwrapWebhookEventCategoryCardPaymentUpdated                                   UnwrapWebhookEventCategory = "card_payment.updated"
	UnwrapWebhookEventCategoryCardProfileCreated                                   UnwrapWebhookEventCategory = "card_profile.created"
	UnwrapWebhookEventCategoryCardProfileUpdated                                   UnwrapWebhookEventCategory = "card_profile.updated"
	UnwrapWebhookEventCategoryCardDisputeCreated                                   UnwrapWebhookEventCategory = "card_dispute.created"
	UnwrapWebhookEventCategoryCardDisputeUpdated                                   UnwrapWebhookEventCategory = "card_dispute.updated"
	UnwrapWebhookEventCategoryCheckDepositCreated                                  UnwrapWebhookEventCategory = "check_deposit.created"
	UnwrapWebhookEventCategoryCheckDepositUpdated                                  UnwrapWebhookEventCategory = "check_deposit.updated"
	UnwrapWebhookEventCategoryCheckTransferCreated                                 UnwrapWebhookEventCategory = "check_transfer.created"
	UnwrapWebhookEventCategoryCheckTransferUpdated                                 UnwrapWebhookEventCategory = "check_transfer.updated"
	UnwrapWebhookEventCategoryDeclinedTransactionCreated                           UnwrapWebhookEventCategory = "declined_transaction.created"
	UnwrapWebhookEventCategoryDigitalCardProfileCreated                            UnwrapWebhookEventCategory = "digital_card_profile.created"
	UnwrapWebhookEventCategoryDigitalCardProfileUpdated                            UnwrapWebhookEventCategory = "digital_card_profile.updated"
	UnwrapWebhookEventCategoryDigitalWalletTokenCreated                            UnwrapWebhookEventCategory = "digital_wallet_token.created"
	UnwrapWebhookEventCategoryDigitalWalletTokenUpdated                            UnwrapWebhookEventCategory = "digital_wallet_token.updated"
	UnwrapWebhookEventCategoryDocumentCreated                                      UnwrapWebhookEventCategory = "document.created"
	UnwrapWebhookEventCategoryEntityCreated                                        UnwrapWebhookEventCategory = "entity.created"
	UnwrapWebhookEventCategoryEntityUpdated                                        UnwrapWebhookEventCategory = "entity.updated"
	UnwrapWebhookEventCategoryEventSubscriptionCreated                             UnwrapWebhookEventCategory = "event_subscription.created"
	UnwrapWebhookEventCategoryEventSubscriptionUpdated                             UnwrapWebhookEventCategory = "event_subscription.updated"
	UnwrapWebhookEventCategoryExportCreated                                        UnwrapWebhookEventCategory = "export.created"
	UnwrapWebhookEventCategoryExportUpdated                                        UnwrapWebhookEventCategory = "export.updated"
	UnwrapWebhookEventCategoryExternalAccountCreated                               UnwrapWebhookEventCategory = "external_account.created"
	UnwrapWebhookEventCategoryExternalAccountUpdated                               UnwrapWebhookEventCategory = "external_account.updated"
	UnwrapWebhookEventCategoryFednowTransferCreated                                UnwrapWebhookEventCategory = "fednow_transfer.created"
	UnwrapWebhookEventCategoryFednowTransferUpdated                                UnwrapWebhookEventCategory = "fednow_transfer.updated"
	UnwrapWebhookEventCategoryFileCreated                                          UnwrapWebhookEventCategory = "file.created"
	UnwrapWebhookEventCategoryGroupUpdated                                         UnwrapWebhookEventCategory = "group.updated"
	UnwrapWebhookEventCategoryGroupHeartbeat                                       UnwrapWebhookEventCategory = "group.heartbeat"
	UnwrapWebhookEventCategoryInboundACHTransferCreated                            UnwrapWebhookEventCategory = "inbound_ach_transfer.created"
	UnwrapWebhookEventCategoryInboundACHTransferUpdated                            UnwrapWebhookEventCategory = "inbound_ach_transfer.updated"
	UnwrapWebhookEventCategoryInboundACHTransferReturnCreated                      UnwrapWebhookEventCategory = "inbound_ach_transfer_return.created"
	UnwrapWebhookEventCategoryInboundACHTransferReturnUpdated                      UnwrapWebhookEventCategory = "inbound_ach_transfer_return.updated"
	UnwrapWebhookEventCategoryInboundCheckDepositCreated                           UnwrapWebhookEventCategory = "inbound_check_deposit.created"
	UnwrapWebhookEventCategoryInboundCheckDepositUpdated                           UnwrapWebhookEventCategory = "inbound_check_deposit.updated"
	UnwrapWebhookEventCategoryInboundFednowTransferCreated                         UnwrapWebhookEventCategory = "inbound_fednow_transfer.created"
	UnwrapWebhookEventCategoryInboundFednowTransferUpdated                         UnwrapWebhookEventCategory = "inbound_fednow_transfer.updated"
	UnwrapWebhookEventCategoryInboundMailItemCreated                               UnwrapWebhookEventCategory = "inbound_mail_item.created"
	UnwrapWebhookEventCategoryInboundMailItemUpdated                               UnwrapWebhookEventCategory = "inbound_mail_item.updated"
	UnwrapWebhookEventCategoryInboundRealTimePaymentsTransferCreated               UnwrapWebhookEventCategory = "inbound_real_time_payments_transfer.created"
	UnwrapWebhookEventCategoryInboundRealTimePaymentsTransferUpdated               UnwrapWebhookEventCategory = "inbound_real_time_payments_transfer.updated"
	UnwrapWebhookEventCategoryInboundWireDrawdownRequestCreated                    UnwrapWebhookEventCategory = "inbound_wire_drawdown_request.created"
	UnwrapWebhookEventCategoryInboundWireTransferCreated                           UnwrapWebhookEventCategory = "inbound_wire_transfer.created"
	UnwrapWebhookEventCategoryInboundWireTransferUpdated                           UnwrapWebhookEventCategory = "inbound_wire_transfer.updated"
	UnwrapWebhookEventCategoryIntrafiAccountEnrollmentCreated                      UnwrapWebhookEventCategory = "intrafi_account_enrollment.created"
	UnwrapWebhookEventCategoryIntrafiAccountEnrollmentUpdated                      UnwrapWebhookEventCategory = "intrafi_account_enrollment.updated"
	UnwrapWebhookEventCategoryIntrafiExclusionCreated                              UnwrapWebhookEventCategory = "intrafi_exclusion.created"
	UnwrapWebhookEventCategoryIntrafiExclusionUpdated                              UnwrapWebhookEventCategory = "intrafi_exclusion.updated"
	UnwrapWebhookEventCategoryLegacyCardDisputeCreated                             UnwrapWebhookEventCategory = "legacy_card_dispute.created"
	UnwrapWebhookEventCategoryLegacyCardDisputeUpdated                             UnwrapWebhookEventCategory = "legacy_card_dispute.updated"
	UnwrapWebhookEventCategoryLockboxCreated                                       UnwrapWebhookEventCategory = "lockbox.created"
	UnwrapWebhookEventCategoryLockboxUpdated                                       UnwrapWebhookEventCategory = "lockbox.updated"
	UnwrapWebhookEventCategoryOAuthConnectionCreated                               UnwrapWebhookEventCategory = "oauth_connection.created"
	UnwrapWebhookEventCategoryOAuthConnectionDeactivated                           UnwrapWebhookEventCategory = "oauth_connection.deactivated"
	UnwrapWebhookEventCategoryCardPushTransferCreated                              UnwrapWebhookEventCategory = "card_push_transfer.created"
	UnwrapWebhookEventCategoryCardPushTransferUpdated                              UnwrapWebhookEventCategory = "card_push_transfer.updated"
	UnwrapWebhookEventCategoryCardValidationCreated                                UnwrapWebhookEventCategory = "card_validation.created"
	UnwrapWebhookEventCategoryCardValidationUpdated                                UnwrapWebhookEventCategory = "card_validation.updated"
	UnwrapWebhookEventCategoryPendingTransactionCreated                            UnwrapWebhookEventCategory = "pending_transaction.created"
	UnwrapWebhookEventCategoryPendingTransactionUpdated                            UnwrapWebhookEventCategory = "pending_transaction.updated"
	UnwrapWebhookEventCategoryPhysicalCardCreated                                  UnwrapWebhookEventCategory = "physical_card.created"
	UnwrapWebhookEventCategoryPhysicalCardUpdated                                  UnwrapWebhookEventCategory = "physical_card.updated"
	UnwrapWebhookEventCategoryPhysicalCardProfileCreated                           UnwrapWebhookEventCategory = "physical_card_profile.created"
	UnwrapWebhookEventCategoryPhysicalCardProfileUpdated                           UnwrapWebhookEventCategory = "physical_card_profile.updated"
	UnwrapWebhookEventCategoryPhysicalCheckCreated                                 UnwrapWebhookEventCategory = "physical_check.created"
	UnwrapWebhookEventCategoryPhysicalCheckUpdated                                 UnwrapWebhookEventCategory = "physical_check.updated"
	UnwrapWebhookEventCategoryProgramCreated                                       UnwrapWebhookEventCategory = "program.created"
	UnwrapWebhookEventCategoryProgramUpdated                                       UnwrapWebhookEventCategory = "program.updated"
	UnwrapWebhookEventCategoryProofOfAuthorizationRequestCreated                   UnwrapWebhookEventCategory = "proof_of_authorization_request.created"
	UnwrapWebhookEventCategoryProofOfAuthorizationRequestUpdated                   UnwrapWebhookEventCategory = "proof_of_authorization_request.updated"
	UnwrapWebhookEventCategoryRealTimeDecisionCardAuthorizationRequested           UnwrapWebhookEventCategory = "real_time_decision.card_authorization_requested"
	UnwrapWebhookEventCategoryRealTimeDecisionCardBalanceInquiryRequested          UnwrapWebhookEventCategory = "real_time_decision.card_balance_inquiry_requested"
	UnwrapWebhookEventCategoryRealTimeDecisionDigitalWalletTokenRequested          UnwrapWebhookEventCategory = "real_time_decision.digital_wallet_token_requested"
	UnwrapWebhookEventCategoryRealTimeDecisionDigitalWalletAuthenticationRequested UnwrapWebhookEventCategory = "real_time_decision.digital_wallet_authentication_requested"
	UnwrapWebhookEventCategoryRealTimeDecisionCardAuthenticationRequested          UnwrapWebhookEventCategory = "real_time_decision.card_authentication_requested"
	UnwrapWebhookEventCategoryRealTimeDecisionCardAuthenticationChallengeRequested UnwrapWebhookEventCategory = "real_time_decision.card_authentication_challenge_requested"
	UnwrapWebhookEventCategoryRealTimePaymentsTransferCreated                      UnwrapWebhookEventCategory = "real_time_payments_transfer.created"
	UnwrapWebhookEventCategoryRealTimePaymentsTransferUpdated                      UnwrapWebhookEventCategory = "real_time_payments_transfer.updated"
	UnwrapWebhookEventCategoryRealTimePaymentsRequestForPaymentCreated             UnwrapWebhookEventCategory = "real_time_payments_request_for_payment.created"
	UnwrapWebhookEventCategoryRealTimePaymentsRequestForPaymentUpdated             UnwrapWebhookEventCategory = "real_time_payments_request_for_payment.updated"
	UnwrapWebhookEventCategorySwiftTransferCreated                                 UnwrapWebhookEventCategory = "swift_transfer.created"
	UnwrapWebhookEventCategorySwiftTransferUpdated                                 UnwrapWebhookEventCategory = "swift_transfer.updated"
	UnwrapWebhookEventCategoryTransactionCreated                                   UnwrapWebhookEventCategory = "transaction.created"
	UnwrapWebhookEventCategoryWireDrawdownRequestCreated                           UnwrapWebhookEventCategory = "wire_drawdown_request.created"
	UnwrapWebhookEventCategoryWireDrawdownRequestUpdated                           UnwrapWebhookEventCategory = "wire_drawdown_request.updated"
	UnwrapWebhookEventCategoryWireTransferCreated                                  UnwrapWebhookEventCategory = "wire_transfer.created"
	UnwrapWebhookEventCategoryWireTransferUpdated                                  UnwrapWebhookEventCategory = "wire_transfer.updated"
)

func (r UnwrapWebhookEventCategory) IsKnown() bool {
	switch r {
	case UnwrapWebhookEventCategoryAccountCreated, UnwrapWebhookEventCategoryAccountUpdated, UnwrapWebhookEventCategoryAccountNumberCreated, UnwrapWebhookEventCategoryAccountNumberUpdated, UnwrapWebhookEventCategoryAccountStatementCreated, UnwrapWebhookEventCategoryAccountTransferCreated, UnwrapWebhookEventCategoryAccountTransferUpdated, UnwrapWebhookEventCategoryACHPrenotificationCreated, UnwrapWebhookEventCategoryACHPrenotificationUpdated, UnwrapWebhookEventCategoryACHTransferCreated, UnwrapWebhookEventCategoryACHTransferUpdated, UnwrapWebhookEventCategoryBlockchainAddressCreated, UnwrapWebhookEventCategoryBlockchainAddressUpdated, UnwrapWebhookEventCategoryBlockchainOfframpTransferCreated, UnwrapWebhookEventCategoryBlockchainOfframpTransferUpdated, UnwrapWebhookEventCategoryBlockchainOnrampTransferCreated, UnwrapWebhookEventCategoryBlockchainOnrampTransferUpdated, UnwrapWebhookEventCategoryBookkeepingAccountCreated, UnwrapWebhookEventCategoryBookkeepingAccountUpdated, UnwrapWebhookEventCategoryBookkeepingEntrySetUpdated, UnwrapWebhookEventCategoryCardCreated, UnwrapWebhookEventCategoryCardUpdated, UnwrapWebhookEventCategoryCardPaymentCreated, UnwrapWebhookEventCategoryCardPaymentUpdated, UnwrapWebhookEventCategoryCardProfileCreated, UnwrapWebhookEventCategoryCardProfileUpdated, UnwrapWebhookEventCategoryCardDisputeCreated, UnwrapWebhookEventCategoryCardDisputeUpdated, UnwrapWebhookEventCategoryCheckDepositCreated, UnwrapWebhookEventCategoryCheckDepositUpdated, UnwrapWebhookEventCategoryCheckTransferCreated, UnwrapWebhookEventCategoryCheckTransferUpdated, UnwrapWebhookEventCategoryDeclinedTransactionCreated, UnwrapWebhookEventCategoryDigitalCardProfileCreated, UnwrapWebhookEventCategoryDigitalCardProfileUpdated, UnwrapWebhookEventCategoryDigitalWalletTokenCreated, UnwrapWebhookEventCategoryDigitalWalletTokenUpdated, UnwrapWebhookEventCategoryDocumentCreated, UnwrapWebhookEventCategoryEntityCreated, UnwrapWebhookEventCategoryEntityUpdated, UnwrapWebhookEventCategoryEventSubscriptionCreated, UnwrapWebhookEventCategoryEventSubscriptionUpdated, UnwrapWebhookEventCategoryExportCreated, UnwrapWebhookEventCategoryExportUpdated, UnwrapWebhookEventCategoryExternalAccountCreated, UnwrapWebhookEventCategoryExternalAccountUpdated, UnwrapWebhookEventCategoryFednowTransferCreated, UnwrapWebhookEventCategoryFednowTransferUpdated, UnwrapWebhookEventCategoryFileCreated, UnwrapWebhookEventCategoryGroupUpdated, UnwrapWebhookEventCategoryGroupHeartbeat, UnwrapWebhookEventCategoryInboundACHTransferCreated, UnwrapWebhookEventCategoryInboundACHTransferUpdated, UnwrapWebhookEventCategoryInboundACHTransferReturnCreated, UnwrapWebhookEventCategoryInboundACHTransferReturnUpdated, UnwrapWebhookEventCategoryInboundCheckDepositCreated, UnwrapWebhookEventCategoryInboundCheckDepositUpdated, UnwrapWebhookEventCategoryInboundFednowTransferCreated, UnwrapWebhookEventCategoryInboundFednowTransferUpdated, UnwrapWebhookEventCategoryInboundMailItemCreated, UnwrapWebhookEventCategoryInboundMailItemUpdated, UnwrapWebhookEventCategoryInboundRealTimePaymentsTransferCreated, UnwrapWebhookEventCategoryInboundRealTimePaymentsTransferUpdated, UnwrapWebhookEventCategoryInboundWireDrawdownRequestCreated, UnwrapWebhookEventCategoryInboundWireTransferCreated, UnwrapWebhookEventCategoryInboundWireTransferUpdated, UnwrapWebhookEventCategoryIntrafiAccountEnrollmentCreated, UnwrapWebhookEventCategoryIntrafiAccountEnrollmentUpdated, UnwrapWebhookEventCategoryIntrafiExclusionCreated, UnwrapWebhookEventCategoryIntrafiExclusionUpdated, UnwrapWebhookEventCategoryLegacyCardDisputeCreated, UnwrapWebhookEventCategoryLegacyCardDisputeUpdated, UnwrapWebhookEventCategoryLockboxCreated, UnwrapWebhookEventCategoryLockboxUpdated, UnwrapWebhookEventCategoryOAuthConnectionCreated, UnwrapWebhookEventCategoryOAuthConnectionDeactivated, UnwrapWebhookEventCategoryCardPushTransferCreated, UnwrapWebhookEventCategoryCardPushTransferUpdated, UnwrapWebhookEventCategoryCardValidationCreated, UnwrapWebhookEventCategoryCardValidationUpdated, UnwrapWebhookEventCategoryPendingTransactionCreated, UnwrapWebhookEventCategoryPendingTransactionUpdated, UnwrapWebhookEventCategoryPhysicalCardCreated, UnwrapWebhookEventCategoryPhysicalCardUpdated, UnwrapWebhookEventCategoryPhysicalCardProfileCreated, UnwrapWebhookEventCategoryPhysicalCardProfileUpdated, UnwrapWebhookEventCategoryPhysicalCheckCreated, UnwrapWebhookEventCategoryPhysicalCheckUpdated, UnwrapWebhookEventCategoryProgramCreated, UnwrapWebhookEventCategoryProgramUpdated, UnwrapWebhookEventCategoryProofOfAuthorizationRequestCreated, UnwrapWebhookEventCategoryProofOfAuthorizationRequestUpdated, UnwrapWebhookEventCategoryRealTimeDecisionCardAuthorizationRequested, UnwrapWebhookEventCategoryRealTimeDecisionCardBalanceInquiryRequested, UnwrapWebhookEventCategoryRealTimeDecisionDigitalWalletTokenRequested, UnwrapWebhookEventCategoryRealTimeDecisionDigitalWalletAuthenticationRequested, UnwrapWebhookEventCategoryRealTimeDecisionCardAuthenticationRequested, UnwrapWebhookEventCategoryRealTimeDecisionCardAuthenticationChallengeRequested, UnwrapWebhookEventCategoryRealTimePaymentsTransferCreated, UnwrapWebhookEventCategoryRealTimePaymentsTransferUpdated, UnwrapWebhookEventCategoryRealTimePaymentsRequestForPaymentCreated, UnwrapWebhookEventCategoryRealTimePaymentsRequestForPaymentUpdated, UnwrapWebhookEventCategorySwiftTransferCreated, UnwrapWebhookEventCategorySwiftTransferUpdated, UnwrapWebhookEventCategoryTransactionCreated, UnwrapWebhookEventCategoryWireDrawdownRequestCreated, UnwrapWebhookEventCategoryWireDrawdownRequestUpdated, UnwrapWebhookEventCategoryWireTransferCreated, UnwrapWebhookEventCategoryWireTransferUpdated:
		return true
	}
	return false
}

// A constant representing the object's type. For this resource it will always be
// `event`.
type UnwrapWebhookEventType string

const (
	UnwrapWebhookEventTypeEvent UnwrapWebhookEventType = "event"
)

func (r UnwrapWebhookEventType) IsKnown() bool {
	switch r {
	case UnwrapWebhookEventTypeEvent:
		return true
	}
	return false
}

type EventListParams struct {
	// Filter Events to those belonging to the object with the provided identifier.
	AssociatedObjectID param.Field[string]                   `query:"associated_object_id"`
	Category           param.Field[EventListParamsCategory]  `query:"category"`
	CreatedAt          param.Field[EventListParamsCreatedAt] `query:"created_at"`
	// Return the page of entries after this one.
	Cursor param.Field[string] `query:"cursor"`
	// Limit the size of the list that is returned. The default (and maximum) is 100
	// objects.
	Limit param.Field[int64] `query:"limit"`
}

// URLQuery serializes [EventListParams]'s query parameters as `url.Values`.
func (r EventListParams) URLQuery() (v url.Values) {
	return apiquery.MarshalWithSettings(r, apiquery.QuerySettings{
		ArrayFormat:  apiquery.ArrayQueryFormatComma,
		NestedFormat: apiquery.NestedQueryFormatDots,
	})
}

type EventListParamsCategory struct {
	// 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`.
	In param.Field[[]EventListParamsCategoryIn] `query:"in"`
}

// URLQuery serializes [EventListParamsCategory]'s query parameters as
// `url.Values`.
func (r EventListParamsCategory) URLQuery() (v url.Values) {
	return apiquery.MarshalWithSettings(r, apiquery.QuerySettings{
		ArrayFormat:  apiquery.ArrayQueryFormatComma,
		NestedFormat: apiquery.NestedQueryFormatDots,
	})
}

type EventListParamsCategoryIn string

const (
	EventListParamsCategoryInAccountCreated                                       EventListParamsCategoryIn = "account.created"
	EventListParamsCategoryInAccountUpdated                                       EventListParamsCategoryIn = "account.updated"
	EventListParamsCategoryInAccountNumberCreated                                 EventListParamsCategoryIn = "account_number.created"
	EventListParamsCategoryInAccountNumberUpdated                                 EventListParamsCategoryIn = "account_number.updated"
	EventListParamsCategoryInAccountStatementCreated                              EventListParamsCategoryIn = "account_statement.created"
	EventListParamsCategoryInAccountTransferCreated                               EventListParamsCategoryIn = "account_transfer.created"
	EventListParamsCategoryInAccountTransferUpdated                               EventListParamsCategoryIn = "account_transfer.updated"
	EventListParamsCategoryInACHPrenotificationCreated                            EventListParamsCategoryIn = "ach_prenotification.created"
	EventListParamsCategoryInACHPrenotificationUpdated                            EventListParamsCategoryIn = "ach_prenotification.updated"
	EventListParamsCategoryInACHTransferCreated                                   EventListParamsCategoryIn = "ach_transfer.created"
	EventListParamsCategoryInACHTransferUpdated                                   EventListParamsCategoryIn = "ach_transfer.updated"
	EventListParamsCategoryInBlockchainAddressCreated                             EventListParamsCategoryIn = "blockchain_address.created"
	EventListParamsCategoryInBlockchainAddressUpdated                             EventListParamsCategoryIn = "blockchain_address.updated"
	EventListParamsCategoryInBlockchainOfframpTransferCreated                     EventListParamsCategoryIn = "blockchain_offramp_transfer.created"
	EventListParamsCategoryInBlockchainOfframpTransferUpdated                     EventListParamsCategoryIn = "blockchain_offramp_transfer.updated"
	EventListParamsCategoryInBlockchainOnrampTransferCreated                      EventListParamsCategoryIn = "blockchain_onramp_transfer.created"
	EventListParamsCategoryInBlockchainOnrampTransferUpdated                      EventListParamsCategoryIn = "blockchain_onramp_transfer.updated"
	EventListParamsCategoryInBookkeepingAccountCreated                            EventListParamsCategoryIn = "bookkeeping_account.created"
	EventListParamsCategoryInBookkeepingAccountUpdated                            EventListParamsCategoryIn = "bookkeeping_account.updated"
	EventListParamsCategoryInBookkeepingEntrySetUpdated                           EventListParamsCategoryIn = "bookkeeping_entry_set.updated"
	EventListParamsCategoryInCardCreated                                          EventListParamsCategoryIn = "card.created"
	EventListParamsCategoryInCardUpdated                                          EventListParamsCategoryIn = "card.updated"
	EventListParamsCategoryInCardPaymentCreated                                   EventListParamsCategoryIn = "card_payment.created"
	EventListParamsCategoryInCardPaymentUpdated                                   EventListParamsCategoryIn = "card_payment.updated"
	EventListParamsCategoryInCardProfileCreated                                   EventListParamsCategoryIn = "card_profile.created"
	EventListParamsCategoryInCardProfileUpdated                                   EventListParamsCategoryIn = "card_profile.updated"
	EventListParamsCategoryInCardDisputeCreated                                   EventListParamsCategoryIn = "card_dispute.created"
	EventListParamsCategoryInCardDisputeUpdated                                   EventListParamsCategoryIn = "card_dispute.updated"
	EventListParamsCategoryInCheckDepositCreated                                  EventListParamsCategoryIn = "check_deposit.created"
	EventListParamsCategoryInCheckDepositUpdated                                  EventListParamsCategoryIn = "check_deposit.updated"
	EventListParamsCategoryInCheckTransferCreated                                 EventListParamsCategoryIn = "check_transfer.created"
	EventListParamsCategoryInCheckTransferUpdated                                 EventListParamsCategoryIn = "check_transfer.updated"
	EventListParamsCategoryInDeclinedTransactionCreated                           EventListParamsCategoryIn = "declined_transaction.created"
	EventListParamsCategoryInDigitalCardProfileCreated                            EventListParamsCategoryIn = "digital_card_profile.created"
	EventListParamsCategoryInDigitalCardProfileUpdated                            EventListParamsCategoryIn = "digital_card_profile.updated"
	EventListParamsCategoryInDigitalWalletTokenCreated                            EventListParamsCategoryIn = "digital_wallet_token.created"
	EventListParamsCategoryInDigitalWalletTokenUpdated                            EventListParamsCategoryIn = "digital_wallet_token.updated"
	EventListParamsCategoryInDocumentCreated                                      EventListParamsCategoryIn = "document.created"
	EventListParamsCategoryInEntityCreated                                        EventListParamsCategoryIn = "entity.created"
	EventListParamsCategoryInEntityUpdated                                        EventListParamsCategoryIn = "entity.updated"
	EventListParamsCategoryInEventSubscriptionCreated                             EventListParamsCategoryIn = "event_subscription.created"
	EventListParamsCategoryInEventSubscriptionUpdated                             EventListParamsCategoryIn = "event_subscription.updated"
	EventListParamsCategoryInExportCreated                                        EventListParamsCategoryIn = "export.created"
	EventListParamsCategoryInExportUpdated                                        EventListParamsCategoryIn = "export.updated"
	EventListParamsCategoryInExternalAccountCreated                               EventListParamsCategoryIn = "external_account.created"
	EventListParamsCategoryInExternalAccountUpdated                               EventListParamsCategoryIn = "external_account.updated"
	EventListParamsCategoryInFednowTransferCreated                                EventListParamsCategoryIn = "fednow_transfer.created"
	EventListParamsCategoryInFednowTransferUpdated                                EventListParamsCategoryIn = "fednow_transfer.updated"
	EventListParamsCategoryInFileCreated                                          EventListParamsCategoryIn = "file.created"
	EventListParamsCategoryInGroupUpdated                                         EventListParamsCategoryIn = "group.updated"
	EventListParamsCategoryInGroupHeartbeat                                       EventListParamsCategoryIn = "group.heartbeat"
	EventListParamsCategoryInInboundACHTransferCreated                            EventListParamsCategoryIn = "inbound_ach_transfer.created"
	EventListParamsCategoryInInboundACHTransferUpdated                            EventListParamsCategoryIn = "inbound_ach_transfer.updated"
	EventListParamsCategoryInInboundACHTransferReturnCreated                      EventListParamsCategoryIn = "inbound_ach_transfer_return.created"
	EventListParamsCategoryInInboundACHTransferReturnUpdated                      EventListParamsCategoryIn = "inbound_ach_transfer_return.updated"
	EventListParamsCategoryInInboundCheckDepositCreated                           EventListParamsCategoryIn = "inbound_check_deposit.created"
	EventListParamsCategoryInInboundCheckDepositUpdated                           EventListParamsCategoryIn = "inbound_check_deposit.updated"
	EventListParamsCategoryInInboundFednowTransferCreated                         EventListParamsCategoryIn = "inbound_fednow_transfer.created"
	EventListParamsCategoryInInboundFednowTransferUpdated                         EventListParamsCategoryIn = "inbound_fednow_transfer.updated"
	EventListParamsCategoryInInboundMailItemCreated                               EventListParamsCategoryIn = "inbound_mail_item.created"
	EventListParamsCategoryInInboundMailItemUpdated                               EventListParamsCategoryIn = "inbound_mail_item.updated"
	EventListParamsCategoryInInboundRealTimePaymentsTransferCreated               EventListParamsCategoryIn = "inbound_real_time_payments_transfer.created"
	EventListParamsCategoryInInboundRealTimePaymentsTransferUpdated               EventListParamsCategoryIn = "inbound_real_time_payments_transfer.updated"
	EventListParamsCategoryInInboundWireDrawdownRequestCreated                    EventListParamsCategoryIn = "inbound_wire_drawdown_request.created"
	EventListParamsCategoryInInboundWireTransferCreated                           EventListParamsCategoryIn = "inbound_wire_transfer.created"
	EventListParamsCategoryInInboundWireTransferUpdated                           EventListParamsCategoryIn = "inbound_wire_transfer.updated"
	EventListParamsCategoryInIntrafiAccountEnrollmentCreated                      EventListParamsCategoryIn = "intrafi_account_enrollment.created"
	EventListParamsCategoryInIntrafiAccountEnrollmentUpdated                      EventListParamsCategoryIn = "intrafi_account_enrollment.updated"
	EventListParamsCategoryInIntrafiExclusionCreated                              EventListParamsCategoryIn = "intrafi_exclusion.created"
	EventListParamsCategoryInIntrafiExclusionUpdated                              EventListParamsCategoryIn = "intrafi_exclusion.updated"
	EventListParamsCategoryInLegacyCardDisputeCreated                             EventListParamsCategoryIn = "legacy_card_dispute.created"
	EventListParamsCategoryInLegacyCardDisputeUpdated                             EventListParamsCategoryIn = "legacy_card_dispute.updated"
	EventListParamsCategoryInLockboxCreated                                       EventListParamsCategoryIn = "lockbox.created"
	EventListParamsCategoryInLockboxUpdated                                       EventListParamsCategoryIn = "lockbox.updated"
	EventListParamsCategoryInOAuthConnectionCreated                               EventListParamsCategoryIn = "oauth_connection.created"
	EventListParamsCategoryInOAuthConnectionDeactivated                           EventListParamsCategoryIn = "oauth_connection.deactivated"
	EventListParamsCategoryInCardPushTransferCreated                              EventListParamsCategoryIn = "card_push_transfer.created"
	EventListParamsCategoryInCardPushTransferUpdated                              EventListParamsCategoryIn = "card_push_transfer.updated"
	EventListParamsCategoryInCardValidationCreated                                EventListParamsCategoryIn = "card_validation.created"
	EventListParamsCategoryInCardValidationUpdated                                EventListParamsCategoryIn = "card_validation.updated"
	EventListParamsCategoryInPendingTransactionCreated                            EventListParamsCategoryIn = "pending_transaction.created"
	EventListParamsCategoryInPendingTransactionUpdated                            EventListParamsCategoryIn = "pending_transaction.updated"
	EventListParamsCategoryInPhysicalCardCreated                                  EventListParamsCategoryIn = "physical_card.created"
	EventListParamsCategoryInPhysicalCardUpdated                                  EventListParamsCategoryIn = "physical_card.updated"
	EventListParamsCategoryInPhysicalCardProfileCreated                           EventListParamsCategoryIn = "physical_card_profile.created"
	EventListParamsCategoryInPhysicalCardProfileUpdated                           EventListParamsCategoryIn = "physical_card_profile.updated"
	EventListParamsCategoryInPhysicalCheckCreated                                 EventListParamsCategoryIn = "physical_check.created"
	EventListParamsCategoryInPhysicalCheckUpdated                                 EventListParamsCategoryIn = "physical_check.updated"
	EventListParamsCategoryInProgramCreated                                       EventListParamsCategoryIn = "program.created"
	EventListParamsCategoryInProgramUpdated                                       EventListParamsCategoryIn = "program.updated"
	EventListParamsCategoryInProofOfAuthorizationRequestCreated                   EventListParamsCategoryIn = "proof_of_authorization_request.created"
	EventListParamsCategoryInProofOfAuthorizationRequestUpdated                   EventListParamsCategoryIn = "proof_of_authorization_request.updated"
	EventListParamsCategoryInRealTimeDecisionCardAuthorizationRequested           EventListParamsCategoryIn = "real_time_decision.card_authorization_requested"
	EventListParamsCategoryInRealTimeDecisionCardBalanceInquiryRequested          EventListParamsCategoryIn = "real_time_decision.card_balance_inquiry_requested"
	EventListParamsCategoryInRealTimeDecisionDigitalWalletTokenRequested          EventListParamsCategoryIn = "real_time_decision.digital_wallet_token_requested"
	EventListParamsCategoryInRealTimeDecisionDigitalWalletAuthenticationRequested EventListParamsCategoryIn = "real_time_decision.digital_wallet_authentication_requested"
	EventListParamsCategoryInRealTimeDecisionCardAuthenticationRequested          EventListParamsCategoryIn = "real_time_decision.card_authentication_requested"
	EventListParamsCategoryInRealTimeDecisionCardAuthenticationChallengeRequested EventListParamsCategoryIn = "real_time_decision.card_authentication_challenge_requested"
	EventListParamsCategoryInRealTimePaymentsTransferCreated                      EventListParamsCategoryIn = "real_time_payments_transfer.created"
	EventListParamsCategoryInRealTimePaymentsTransferUpdated                      EventListParamsCategoryIn = "real_time_payments_transfer.updated"
	EventListParamsCategoryInRealTimePaymentsRequestForPaymentCreated             EventListParamsCategoryIn = "real_time_payments_request_for_payment.created"
	EventListParamsCategoryInRealTimePaymentsRequestForPaymentUpdated             EventListParamsCategoryIn = "real_time_payments_request_for_payment.updated"
	EventListParamsCategoryInSwiftTransferCreated                                 EventListParamsCategoryIn = "swift_transfer.created"
	EventListParamsCategoryInSwiftTransferUpdated                                 EventListParamsCategoryIn = "swift_transfer.updated"
	EventListParamsCategoryInTransactionCreated                                   EventListParamsCategoryIn = "transaction.created"
	EventListParamsCategoryInWireDrawdownRequestCreated                           EventListParamsCategoryIn = "wire_drawdown_request.created"
	EventListParamsCategoryInWireDrawdownRequestUpdated                           EventListParamsCategoryIn = "wire_drawdown_request.updated"
	EventListParamsCategoryInWireTransferCreated                                  EventListParamsCategoryIn = "wire_transfer.created"
	EventListParamsCategoryInWireTransferUpdated                                  EventListParamsCategoryIn = "wire_transfer.updated"
)

func (r EventListParamsCategoryIn) IsKnown() bool {
	switch r {
	case EventListParamsCategoryInAccountCreated, EventListParamsCategoryInAccountUpdated, EventListParamsCategoryInAccountNumberCreated, EventListParamsCategoryInAccountNumberUpdated, EventListParamsCategoryInAccountStatementCreated, EventListParamsCategoryInAccountTransferCreated, EventListParamsCategoryInAccountTransferUpdated, EventListParamsCategoryInACHPrenotificationCreated, EventListParamsCategoryInACHPrenotificationUpdated, EventListParamsCategoryInACHTransferCreated, EventListParamsCategoryInACHTransferUpdated, EventListParamsCategoryInBlockchainAddressCreated, EventListParamsCategoryInBlockchainAddressUpdated, EventListParamsCategoryInBlockchainOfframpTransferCreated, EventListParamsCategoryInBlockchainOfframpTransferUpdated, EventListParamsCategoryInBlockchainOnrampTransferCreated, EventListParamsCategoryInBlockchainOnrampTransferUpdated, EventListParamsCategoryInBookkeepingAccountCreated, EventListParamsCategoryInBookkeepingAccountUpdated, EventListParamsCategoryInBookkeepingEntrySetUpdated, EventListParamsCategoryInCardCreated, EventListParamsCategoryInCardUpdated, EventListParamsCategoryInCardPaymentCreated, EventListParamsCategoryInCardPaymentUpdated, EventListParamsCategoryInCardProfileCreated, EventListParamsCategoryInCardProfileUpdated, EventListParamsCategoryInCardDisputeCreated, EventListParamsCategoryInCardDisputeUpdated, EventListParamsCategoryInCheckDepositCreated, EventListParamsCategoryInCheckDepositUpdated, EventListParamsCategoryInCheckTransferCreated, EventListParamsCategoryInCheckTransferUpdated, EventListParamsCategoryInDeclinedTransactionCreated, EventListParamsCategoryInDigitalCardProfileCreated, EventListParamsCategoryInDigitalCardProfileUpdated, EventListParamsCategoryInDigitalWalletTokenCreated, EventListParamsCategoryInDigitalWalletTokenUpdated, EventListParamsCategoryInDocumentCreated, EventListParamsCategoryInEntityCreated, EventListParamsCategoryInEntityUpdated, EventListParamsCategoryInEventSubscriptionCreated, EventListParamsCategoryInEventSubscriptionUpdated, EventListParamsCategoryInExportCreated, EventListParamsCategoryInExportUpdated, EventListParamsCategoryInExternalAccountCreated, EventListParamsCategoryInExternalAccountUpdated, EventListParamsCategoryInFednowTransferCreated, EventListParamsCategoryInFednowTransferUpdated, EventListParamsCategoryInFileCreated, EventListParamsCategoryInGroupUpdated, EventListParamsCategoryInGroupHeartbeat, EventListParamsCategoryInInboundACHTransferCreated, EventListParamsCategoryInInboundACHTransferUpdated, EventListParamsCategoryInInboundACHTransferReturnCreated, EventListParamsCategoryInInboundACHTransferReturnUpdated, EventListParamsCategoryInInboundCheckDepositCreated, EventListParamsCategoryInInboundCheckDepositUpdated, EventListParamsCategoryInInboundFednowTransferCreated, EventListParamsCategoryInInboundFednowTransferUpdated, EventListParamsCategoryInInboundMailItemCreated, EventListParamsCategoryInInboundMailItemUpdated, EventListParamsCategoryInInboundRealTimePaymentsTransferCreated, EventListParamsCategoryInInboundRealTimePaymentsTransferUpdated, EventListParamsCategoryInInboundWireDrawdownRequestCreated, EventListParamsCategoryInInboundWireTransferCreated, EventListParamsCategoryInInboundWireTransferUpdated, EventListParamsCategoryInIntrafiAccountEnrollmentCreated, EventListParamsCategoryInIntrafiAccountEnrollmentUpdated, EventListParamsCategoryInIntrafiExclusionCreated, EventListParamsCategoryInIntrafiExclusionUpdated, EventListParamsCategoryInLegacyCardDisputeCreated, EventListParamsCategoryInLegacyCardDisputeUpdated, EventListParamsCategoryInLockboxCreated, EventListParamsCategoryInLockboxUpdated, EventListParamsCategoryInOAuthConnectionCreated, EventListParamsCategoryInOAuthConnectionDeactivated, EventListParamsCategoryInCardPushTransferCreated, EventListParamsCategoryInCardPushTransferUpdated, EventListParamsCategoryInCardValidationCreated, EventListParamsCategoryInCardValidationUpdated, EventListParamsCategoryInPendingTransactionCreated, EventListParamsCategoryInPendingTransactionUpdated, EventListParamsCategoryInPhysicalCardCreated, EventListParamsCategoryInPhysicalCardUpdated, EventListParamsCategoryInPhysicalCardProfileCreated, EventListParamsCategoryInPhysicalCardProfileUpdated, EventListParamsCategoryInPhysicalCheckCreated, EventListParamsCategoryInPhysicalCheckUpdated, EventListParamsCategoryInProgramCreated, EventListParamsCategoryInProgramUpdated, EventListParamsCategoryInProofOfAuthorizationRequestCreated, EventListParamsCategoryInProofOfAuthorizationRequestUpdated, EventListParamsCategoryInRealTimeDecisionCardAuthorizationRequested, EventListParamsCategoryInRealTimeDecisionCardBalanceInquiryRequested, EventListParamsCategoryInRealTimeDecisionDigitalWalletTokenRequested, EventListParamsCategoryInRealTimeDecisionDigitalWalletAuthenticationRequested, EventListParamsCategoryInRealTimeDecisionCardAuthenticationRequested, EventListParamsCategoryInRealTimeDecisionCardAuthenticationChallengeRequested, EventListParamsCategoryInRealTimePaymentsTransferCreated, EventListParamsCategoryInRealTimePaymentsTransferUpdated, EventListParamsCategoryInRealTimePaymentsRequestForPaymentCreated, EventListParamsCategoryInRealTimePaymentsRequestForPaymentUpdated, EventListParamsCategoryInSwiftTransferCreated, EventListParamsCategoryInSwiftTransferUpdated, EventListParamsCategoryInTransactionCreated, EventListParamsCategoryInWireDrawdownRequestCreated, EventListParamsCategoryInWireDrawdownRequestUpdated, EventListParamsCategoryInWireTransferCreated, EventListParamsCategoryInWireTransferUpdated:
		return true
	}
	return false
}

type EventListParamsCreatedAt struct {
	// Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
	// timestamp.
	After param.Field[time.Time] `query:"after" format:"date-time"`
	// Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
	// timestamp.
	Before param.Field[time.Time] `query:"before" format:"date-time"`
	// Return results on or after this
	// [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
	OnOrAfter param.Field[time.Time] `query:"on_or_after" format:"date-time"`
	// Return results on or before this
	// [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
	OnOrBefore param.Field[time.Time] `query:"on_or_before" format:"date-time"`
}

// URLQuery serializes [EventListParamsCreatedAt]'s query parameters as
// `url.Values`.
func (r EventListParamsCreatedAt) URLQuery() (v url.Values) {
	return apiquery.MarshalWithSettings(r, apiquery.QuerySettings{
		ArrayFormat:  apiquery.ArrayQueryFormatComma,
		NestedFormat: apiquery.NestedQueryFormatDots,
	})
}