v3

type Addon struct {
	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency The currency code of the add-on.
	Currency BillingCurrencyCode `json:"currency"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// EffectiveFrom The date and time when the add-on becomes effective. When not specified, the
	// add-on is a draft.
	EffectiveFrom *DateTime `json:"effective_from,omitempty"`

	// EffectiveTo The date and time when the add-on is no longer effective. When not specified,
	// the add-on is effective indefinitely.
	EffectiveTo *DateTime `json:"effective_to,omitempty"`
	Id          ULID      `json:"id"`

	// InstanceType The InstanceType of the add-ons. Can be "single" or "multiple".
	InstanceType AddonInstanceType `json:"instance_type"`

	// Key A key is a semi-unique string that is used to identify the add-on. It is used to
	// reference the latest `active` version of the add-on and is unique with the
	// version number.
	Key ResourceKey `json:"key"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// RateCards The rate cards of the add-on.
	RateCards []BillingRateCard `json:"rate_cards"`

	// Status The status of the add-on. Computed based on the effective start and end dates:
	//
	// - `draft`: `effective_from` is not set.
	// - `active`: `effective_from <= now` and (`effective_to` is not set or
	// `now < effective_to`).
	// - `archived`: `effective_to <= now`.
	Status AddonStatus `json:"status"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// ValidationErrors List of validation errors.
	ValidationErrors *[]ProductCatalogValidationError `json:"validation_errors,omitempty"`

	// Version Version of the add-on. Incremented when the add-on is updated.
	Version int `json:"version"`
}

type AddonInstanceType string

type AddonPagePaginatedResponse struct {
	Data []Addon `json:"data"`

	// Meta returns the pagination information
	Meta PaginatedMeta `json:"meta"`
}

type AddonReference struct {
	// Id ULID (Universally Unique Lexicographically Sortable Identifier).
	Id ULID `json:"id"`
}

type AddonStatus string

type Address struct {
	// City City.
	City *string `json:"city,omitempty"`

	// Country Country code in [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html)
	// alpha-2 format.
	Country *CountryCode `json:"country,omitempty"`

	// Line1 First line of the address.
	Line1 *string `json:"line1,omitempty"`

	// Line2 Second line of the address.
	Line2 *string `json:"line2,omitempty"`

	// PhoneNumber Phone number.
	PhoneNumber *string `json:"phone_number,omitempty"`

	// PostalCode Postal code.
	PostalCode *string `json:"postal_code,omitempty"`

	// State State or province.
	State *string `json:"state,omitempty"`
}

type AppPagePaginatedResponse struct {
	Data []BillingApp `json:"data"`

	// Meta returns the pagination information
	Meta PaginatedMeta `json:"meta"`
}

type BadRequest = BadRequestError

type BadRequestError struct {
	// Detail A human readable explanation specific to this occurence of the problem.
	// This field may contain request/entity data to help the user understand
	// what went wrong. Enclose variable values in square brackets. Should be
	// provided as "Sentence case" for direct use in the UI.
	Detail string `json:"detail"`

	// Instance Used to return the correlation ID back to the user, in the format
	// kong:trace:<correlation_id>. This helps us find the relevant logs
	// when a customer reports an issue.
	Instance string `json:"instance"`

	// InvalidParameters invalid parameters
	InvalidParameters InvalidParameters `json:"invalid_parameters"`

	// Status The HTTP status code of the error. Useful when passing the response
	// body to child properties in a frontend UI. Must be returned as an integer.
	Status int `json:"status"`

	// Title A short, human-readable summary of the problem. It should not
	// change between occurences of a problem, except for localization.
	// Should be provided as "Sentence case" for direct use in the UI.
	Title string `json:"title"`

	// Type The error type.
	Type *string `json:"type,omitempty"`
}

type BaseError struct {
	// Detail A human readable explanation specific to this occurence of the problem.
	// This field may contain request/entity data to help the user understand
	// what went wrong. Enclose variable values in square brackets. Should be
	// provided as "Sentence case" for direct use in the UI.
	Detail string `json:"detail"`

	// Instance Used to return the correlation ID back to the user, in the format
	// kong:trace:<correlation_id>. This helps us find the relevant logs
	// when a customer reports an issue.
	Instance string `json:"instance"`

	// Status The HTTP status code of the error. Useful when passing the response
	// body to child properties in a frontend UI. Must be returned as an integer.
	Status int `json:"status"`

	// Title A short, human-readable summary of the problem. It should not
	// change between occurences of a problem, except for localization.
	// Should be provided as "Sentence case" for direct use in the UI.
	Title string `json:"title"`

	// Type The error type.
	Type *string `json:"type,omitempty"`
}

type BillingApp struct {
	// contains filtered or unexported fields
}

type BillingAppCatalogItem struct {
	// Description Description of the app.
	Description string `json:"description"`

	// Name Name of the app.
	Name string `json:"name"`

	// Type Type of the app.
	Type BillingAppType `json:"type"`
}

type BillingAppCustomerData struct {
	// ExternalInvoicing Used if the customer has a linked external invoicing app.
	ExternalInvoicing *BillingAppCustomerDataExternalInvoicing `json:"external_invoicing,omitempty"`

	// Stripe Used if the customer has a linked Stripe app.
	Stripe *BillingAppCustomerDataStripe `json:"stripe,omitempty"`
}

type BillingAppCustomerDataExternalInvoicing struct {
	// Labels Labels for this external invoicing integration on the customer.
	Labels *Labels `json:"labels,omitempty"`
}

type BillingAppCustomerDataStripe struct {
	// CustomerId The Stripe customer ID used.
	CustomerId *string `json:"customer_id,omitempty"`

	// DefaultPaymentMethodId The Stripe default payment method ID.
	DefaultPaymentMethodId *string `json:"default_payment_method_id,omitempty"`

	// Labels Labels for this Stripe integration on the customer.
	Labels *Labels `json:"labels,omitempty"`
}

type BillingAppExternalInvoicing struct {
	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Definition The app catalog definition that this installed app is based on.
	Definition BillingAppCatalogItem `json:"definition"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// EnableDraftSyncHook Enable draft synchronization hook.
	//
	// When enabled, invoices will pause at the draft state and wait for the
	// integration to call the draft synchronized endpoint before progressing to the
	// issuing state. This allows the external system to validate and prepare the
	// invoice data.
	//
	// When disabled, invoices automatically progress through the draft state based on
	// the configured workflow timing.
	EnableDraftSyncHook bool `json:"enable_draft_sync_hook"`

	// EnableIssuingSyncHook Enable issuing synchronization hook.
	//
	// When enabled, invoices will pause at the issuing state and wait for the
	// integration to call the issuing synchronized endpoint before progressing to the
	// issued state. This ensures the external invoicing system has successfully
	// created and finalized the invoice before it is marked as issued.
	//
	// When disabled, invoices automatically progress through the issuing state and are
	// immediately marked as issued.
	EnableIssuingSyncHook bool `json:"enable_issuing_sync_hook"`
	Id                    ULID `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Status Status of the app connection.
	Status BillingAppStatus `json:"status"`

	// Type The app type.
	Type BillingAppExternalInvoicingType `json:"type"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingAppExternalInvoicingType string

type BillingAppReference struct {
	// Id The ID of the app.
	Id ULID `json:"id"`
}

type BillingAppSandbox struct {
	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Definition The app catalog definition that this installed app is based on.
	Definition BillingAppCatalogItem `json:"definition"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`
	Id          ULID    `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Status Status of the app connection.
	Status BillingAppStatus `json:"status"`

	// Type The app type.
	Type BillingAppSandboxType `json:"type"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingAppSandboxType string

type BillingAppStatus string

type BillingAppStripe struct {
	// AccountId The Stripe account ID associated with the connected Stripe account.
	AccountId string `json:"account_id"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Definition The app catalog definition that this installed app is based on.
	Definition BillingAppCatalogItem `json:"definition"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`
	Id          ULID    `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Livemode Indicates whether the app is connected to a live Stripe account.
	Livemode bool `json:"livemode"`

	// MaskedApiKey The masked Stripe API key that only exposes the first and last few characters.
	MaskedApiKey string `json:"masked_api_key"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Status Status of the app connection.
	Status BillingAppStatus `json:"status"`

	// Type The app type.
	Type BillingAppStripeType `json:"type"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingAppStripeCheckoutSessionCustomTextParams struct {
	// AfterSubmit Text displayed after the payment confirmation button.
	AfterSubmit *struct {
		// Message The custom message text (max 1200 characters).
		Message *string `json:"message,omitempty"`
	} `json:"after_submit,omitempty"`

	// ShippingAddress Text displayed alongside shipping address collection.
	ShippingAddress *struct {
		// Message The custom message text (max 1200 characters).
		Message *string `json:"message,omitempty"`
	} `json:"shipping_address,omitempty"`

	// Submit Text displayed alongside the payment confirmation button.
	Submit *struct {
		// Message The custom message text (max 1200 characters).
		Message *string `json:"message,omitempty"`
	} `json:"submit,omitempty"`

	// TermsOfServiceAcceptance Text replacing the default terms of service agreement text.
	TermsOfServiceAcceptance *struct {
		// Message The custom message text (max 1200 characters).
		Message *string `json:"message,omitempty"`
	} `json:"terms_of_service_acceptance,omitempty"`
}

type BillingAppStripeCheckoutSessionMode string

type BillingAppStripeCheckoutSessionUIMode string

type BillingAppStripeCreateCheckoutSessionBillingAddressCollection string

type BillingAppStripeCreateCheckoutSessionConsentCollection struct {
	// PaymentMethodReuseAgreement Controls the visibility of payment method reuse agreement.
	PaymentMethodReuseAgreement *BillingAppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement `json:"payment_method_reuse_agreement,omitempty"`

	// Promotions Enables collection of promotional communication consent.
	//
	// Only available to US merchants. When set to "auto", Checkout determines whether
	// to show the option based on the customer's locale.
	Promotions *BillingAppStripeCreateCheckoutSessionConsentCollectionPromotions `json:"promotions,omitempty"`

	// TermsOfService Requires customers to accept terms of service before payment.
	//
	// Requires a valid terms of service URL in your Stripe Dashboard settings.
	TermsOfService *BillingAppStripeCreateCheckoutSessionConsentCollectionTermsOfService `json:"terms_of_service,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement struct {
	// Position Position and visibility of the payment method reuse agreement.
	Position *BillingAppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreementPosition `json:"position,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreementPosition string

type BillingAppStripeCreateCheckoutSessionConsentCollectionPromotions string

type BillingAppStripeCreateCheckoutSessionConsentCollectionTermsOfService string

type BillingAppStripeCreateCheckoutSessionCustomerUpdate struct {
	// Address Whether to save the billing address to customer.address.
	//
	// Defaults to "never".
	Address *BillingAppStripeCreateCheckoutSessionCustomerUpdateBehavior `json:"address,omitempty"`

	// Name Whether to save the customer name to customer.name.
	//
	// Defaults to "never".
	Name *BillingAppStripeCreateCheckoutSessionCustomerUpdateBehavior `json:"name,omitempty"`

	// Shipping Whether to save shipping information to customer.shipping.
	//
	// Defaults to "never".
	Shipping *BillingAppStripeCreateCheckoutSessionCustomerUpdateBehavior `json:"shipping,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionCustomerUpdateBehavior string

type BillingAppStripeCreateCheckoutSessionRedirectOnCompletion string

type BillingAppStripeCreateCheckoutSessionRequestOptions struct {
	// BillingAddressCollection Whether to collect the customer's billing address.
	//
	// Defaults to auto, which only collects the address when necessary for tax
	// calculation.
	BillingAddressCollection *BillingAppStripeCreateCheckoutSessionBillingAddressCollection `json:"billing_address_collection,omitempty"`

	// CancelUrl URL to redirect customers who cancel the checkout session.
	//
	// Not allowed when ui_mode is "embedded".
	CancelUrl *string `json:"cancel_url,omitempty"`

	// ClientReferenceId Unique reference string for reconciling sessions with internal systems.
	//
	// Can be a customer ID, cart ID, or any other identifier.
	ClientReferenceId *string `json:"client_reference_id,omitempty"`

	// ConsentCollection Configuration for collecting customer consent during checkout.
	ConsentCollection *BillingAppStripeCreateCheckoutSessionConsentCollection `json:"consent_collection,omitempty"`

	// Currency Three-letter ISO 4217 currency code in uppercase.
	//
	// Required for payment mode sessions. Optional for setup mode sessions.
	Currency *CurrencyCode `json:"currency,omitempty"`

	// CustomText Custom text to display during checkout at various stages.
	CustomText *BillingAppStripeCheckoutSessionCustomTextParams `json:"custom_text,omitempty"`

	// CustomerUpdate Controls which customer fields can be updated by the checkout session.
	CustomerUpdate *BillingAppStripeCreateCheckoutSessionCustomerUpdate `json:"customer_update,omitempty"`

	// ExpiresAt Unix timestamp when the checkout session expires.
	//
	// Can be 30 minutes to 24 hours from creation. Defaults to 24 hours.
	ExpiresAt *int64 `json:"expires_at,omitempty"`

	// Locale IETF language tag for the checkout UI locale.
	//
	// If blank or "auto", uses the browser's locale. Example: "en", "fr", "de".
	Locale *string `json:"locale,omitempty"`

	// Metadata Set of key-value pairs to attach to the checkout session.
	//
	// Useful for storing additional structured information.
	Metadata *map[string]string `json:"metadata,omitempty"`

	// PaymentMethodTypes List of payment method types to enable (e.g., "card", "us_bank_account").
	//
	// If not specified, Stripe enables all relevant payment methods.
	PaymentMethodTypes *[]string `json:"payment_method_types,omitempty"`

	// RedirectOnCompletion Redirect behavior for embedded checkout sessions.
	//
	// Controls when to redirect users after completion. See:
	// https://docs.stripe.com/payments/checkout/custom-success-page?payment-ui=embedded-form
	RedirectOnCompletion *BillingAppStripeCreateCheckoutSessionRedirectOnCompletion `json:"redirect_on_completion,omitempty"`

	// ReturnUrl Return URL for embedded checkout sessions after payment authentication.
	//
	// Required if ui_mode is "embedded" and redirect-based payment methods are
	// enabled.
	ReturnUrl *string `json:"return_url,omitempty"`

	// SuccessUrl Success URL to redirect customers after completing payment or setup.
	//
	// Not allowed when ui_mode is "embedded". See:
	// https://docs.stripe.com/payments/checkout/custom-success-page
	SuccessUrl *string `json:"success_url,omitempty"`

	// TaxIdCollection Configuration for collecting tax IDs during checkout.
	TaxIdCollection *BillingAppStripeCreateCheckoutSessionTaxIdCollection `json:"tax_id_collection,omitempty"`

	// UiMode The UI mode for the checkout session.
	//
	// "hosted" displays a Stripe-hosted page. "embedded" integrates directly into your
	// app. Defaults to "hosted".
	UiMode *BillingAppStripeCheckoutSessionUIMode `json:"ui_mode,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionResult struct {
	// CancelUrl The cancel URL where customers are redirected if they cancel.
	CancelUrl *string `json:"cancel_url,omitempty"`

	// ClientReferenceId The client reference ID provided in the request.
	//
	// Useful for reconciling the session with your internal systems.
	ClientReferenceId *string `json:"client_reference_id,omitempty"`

	// ClientSecret Client secret for initializing Stripe.js on the client side.
	//
	// Required for embedded checkout sessions. See:
	// https://docs.stripe.com/payments/checkout/custom-success-page
	ClientSecret *string `json:"client_secret,omitempty"`

	// CreatedAt Timestamp when the checkout session was created.
	CreatedAt DateTime `json:"created_at"`

	// Currency Currency code for the checkout session.
	Currency *CurrencyCode `json:"currency,omitempty"`

	// CustomerEmail Customer's email address if provided to Stripe.
	CustomerEmail *string `json:"customer_email,omitempty"`

	// CustomerId The customer ID in the billing system.
	CustomerId ULID `json:"customer_id"`

	// ExpiresAt Timestamp when the checkout session will expire.
	ExpiresAt *DateTime `json:"expires_at,omitempty"`

	// Metadata Metadata attached to the checkout session.
	Metadata *map[string]string `json:"metadata,omitempty"`

	// Mode Mode of the checkout session.
	//
	// Currently only "setup" mode is supported for collecting payment methods.
	Mode BillingAppStripeCheckoutSessionMode `json:"mode"`

	// ReturnUrl The return URL for embedded sessions after authentication.
	ReturnUrl *string `json:"return_url,omitempty"`

	// SessionId The Stripe checkout session ID.
	SessionId string `json:"session_id"`

	// SetupIntentId The setup intent ID created for collecting the payment method.
	SetupIntentId string `json:"setup_intent_id"`

	// Status The status of the checkout session.
	//
	// See:
	// https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-status
	Status *string `json:"status,omitempty"`

	// StripeCustomerId The Stripe customer ID.
	StripeCustomerId string `json:"stripe_customer_id"`

	// SuccessUrl The success URL where customers are redirected after completion.
	SuccessUrl *string `json:"success_url,omitempty"`

	// Url URL to redirect customers to the checkout page (for hosted mode).
	Url *string `json:"url,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionTaxIdCollection struct {
	// Enabled Enable tax ID collection during checkout.
	//
	// Defaults to false.
	Enabled *bool `json:"enabled,omitempty"`

	// Required Whether tax ID collection is required.
	//
	// Defaults to "never".
	Required *BillingAppStripeCreateCheckoutSessionTaxIdCollectionRequired `json:"required,omitempty"`
}

type BillingAppStripeCreateCheckoutSessionTaxIdCollectionRequired string

type BillingAppStripeCreateCustomerPortalSessionOptions struct {
	// ConfigurationId The ID of an existing
	// [Stripe configuration](https://docs.stripe.com/api/customer_portal/configurations)
	// to use for this session, describing its functionality and features. If not
	// specified, the session uses the default configuration.
	ConfigurationId *string `json:"configuration_id,omitempty"`

	// Locale The IETF
	// [language tag](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-locale)
	// of the locale customer portal is displayed in. If blank or `auto`, the
	// customer's preferred_locales or browser's locale is used.
	Locale *string `json:"locale,omitempty"`

	// ReturnUrl The
	// [URL to redirect](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url)
	// the customer to after they have completed their requested actions.
	ReturnUrl *string `json:"return_url,omitempty"`
}

type BillingAppStripeCreateCustomerPortalSessionResult struct {
	// ConfigurationId Configuration used to customize the customer portal.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-configuration
	ConfigurationId string `json:"configuration_id"`

	// CreatedAt Created at.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-created
	CreatedAt DateTime `json:"created_at"`

	// Id The ID of the customer portal session.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-id
	Id string `json:"id"`

	// Livemode Livemode.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-livemode
	Livemode bool `json:"livemode"`

	// Locale The IETF language tag of the locale customer portal is displayed in.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-locale
	Locale string `json:"locale"`

	// ReturnUrl Return URL.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-return_url
	ReturnUrl string `json:"return_url"`

	// StripeCustomerId The ID of the stripe customer.
	StripeCustomerId string `json:"stripe_customer_id"`

	// Url The URL to redirect the customer to after they have completed their requested
	// actions.
	Url string `json:"url"`
}

type BillingAppStripeType string

type BillingAppType string

type BillingCharge struct {
	// contains filtered or unexported fields
}

type BillingChargeFlatFee struct {
	// AdvanceAfter The earliest time when the charge should be advanced again by background
	// processing.
	AdvanceAfter *DateTime `json:"advance_after,omitempty"`

	// AmountAfterProration The amount after proration of the charge.
	AmountAfterProration CurrencyAmount `json:"amount_after_proration"`

	// BillingPeriod The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency The currency of the charge.
	Currency CurrencyCode `json:"currency"`

	// Customer The customer owning the charge.
	Customer BillingCustomerReference `json:"customer"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts The discounts applied to the charge.
	Discounts *BillingChargeFlatFeeDiscounts `json:"discounts,omitempty"`

	// FeatureKey The feature associated with the charge, when applicable.
	FeatureKey *string `json:"feature_key,omitempty"`

	// FullServicePeriod The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`
	Id                ULID         `json:"id"`

	// InvoiceAt The timestamp when the charge is intended to be invoiced.
	InvoiceAt DateTime `json:"invoice_at"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// LifecycleController Indicates whether the charge lifecycle is controlled by OpenMeter or manually
	// overridden by the API user.
	LifecycleController BillingLifecycleController `json:"lifecycle_controller"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// PaymentTerm Payment term of the flat fee charge.
	PaymentTerm BillingPricePaymentTerm `json:"payment_term"`

	// Price The price of the charge.
	Price BillingPrice `json:"price"`

	// ProrationConfiguration The proration configuration of the charge.
	ProrationConfiguration BillingRateCardProrationConfiguration `json:"proration_configuration"`

	// ServicePeriod The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// SettlementMode Settlement mode of the charge.
	SettlementMode BillingSettlementMode `json:"settlement_mode"`

	// Status The lifecycle status of the charge.
	Status BillingChargeStatus `json:"status"`

	// Subscription The subscription that originated the charge, when the charge was created from a
	// subscription item.
	Subscription *BillingSubscriptionReference `json:"subscription,omitempty"`

	// SystemIntent Current intent from the system lifecycle controller for a charge that has an
	// active manual override. The top-level charge fields remain the effective
	// customer-facing intent.
	SystemIntent *BillingChargeFlatFeeSystemIntent `json:"system_intent,omitempty"`

	// TaxConfig Tax configuration of the charge.
	TaxConfig *BillingTaxConfig `json:"tax_config,omitempty"`

	// Type The type of the charge.
	Type BillingChargeFlatFeeType `json:"type"`

	// UniqueReferenceId Unique reference ID of the charge.
	UniqueReferenceId *string `json:"unique_reference_id,omitempty"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingChargeFlatFeeDiscounts struct {
	// Percentage Percentage discount applied to the price (0–100).
	Percentage *float32 `json:"percentage,omitempty"`
}

type BillingChargeFlatFeeSystemIntent struct {
	// AmountBeforeProration The amount before proration of the system lifecycle controller flat fee intent.
	AmountBeforeProration CurrencyAmount `json:"amount_before_proration"`

	// BillingPeriod The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`

	// DeletedAt The timestamp when the system lifecycle controller intent was deleted. The
	// effective charge can remain visible while a manual override is active.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts The discounts applied to the charge.
	Discounts *BillingChargeFlatFeeDiscounts `json:"discounts,omitempty"`

	// FullServicePeriod The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`

	// InvoiceAt The timestamp when the charge is intended to be invoiced.
	InvoiceAt DateTime `json:"invoice_at"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// PaymentTerm Payment term of the flat fee charge.
	PaymentTerm BillingPricePaymentTerm `json:"payment_term"`

	// ProrationConfiguration The proration configuration of the charge.
	ProrationConfiguration BillingRateCardProrationConfiguration `json:"proration_configuration"`

	// ServicePeriod The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`
}

type BillingChargeFlatFeeType string

type BillingChargeReference struct {
	// Id Unique identifier for the charge.
	Id ULID `json:"id"`
}

type BillingChargeStatus string

type BillingChargeTotals struct {
	// Booked The amount of the charge already booked to the internal accounting system.
	Booked BillingTotals `json:"booked"`

	// Realtime The realtime amount of the charge.
	//
	// Requires the `realtime_usage` expand.
	Realtime *BillingTotals `json:"realtime,omitempty"`
}

type BillingChargeUsageBased struct {
	// AdvanceAfter The earliest time when the charge should be advanced again by background
	// processing.
	AdvanceAfter *DateTime `json:"advance_after,omitempty"`

	// BillingPeriod The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency The currency of the charge.
	Currency CurrencyCode `json:"currency"`

	// Customer The customer owning the charge.
	Customer BillingCustomerReference `json:"customer"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts Discounts applied to the usage-based charge.
	Discounts *BillingRateCardDiscounts `json:"discounts,omitempty"`

	// FeatureKey The feature associated with the charge.
	FeatureKey string `json:"feature_key"`

	// FullServicePeriod The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`
	Id                ULID         `json:"id"`

	// InvoiceAt The timestamp when the charge is intended to be invoiced.
	InvoiceAt DateTime `json:"invoice_at"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// LifecycleController Indicates whether the charge lifecycle is controlled by OpenMeter or manually
	// overridden by the API user.
	LifecycleController BillingLifecycleController `json:"lifecycle_controller"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Price The price of the charge.
	Price BillingPrice `json:"price"`

	// ServicePeriod The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// SettlementMode Settlement mode of the charge.
	SettlementMode BillingSettlementMode `json:"settlement_mode"`

	// Status The lifecycle status of the charge.
	Status BillingChargeStatus `json:"status"`

	// Subscription The subscription that originated the charge, when the charge was created from a
	// subscription item.
	Subscription *BillingSubscriptionReference `json:"subscription,omitempty"`

	// SystemIntent Current intent from the system lifecycle controller for a charge that has an
	// active manual override. The top-level charge fields remain the effective
	// customer-facing intent.
	SystemIntent *BillingChargeUsageBasedSystemIntent `json:"system_intent,omitempty"`

	// TaxConfig Tax configuration of the charge.
	TaxConfig *BillingTaxConfig `json:"tax_config,omitempty"`

	// Totals Aggregated booked and realtime totals for the charge.
	Totals BillingChargeTotals `json:"totals"`

	// Type The type of the charge.
	Type BillingChargeUsageBasedType `json:"type"`

	// UniqueReferenceId Unique reference ID of the charge.
	UniqueReferenceId *string `json:"unique_reference_id,omitempty"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingChargeUsageBasedSystemIntent struct {
	// BillingPeriod The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`

	// DeletedAt The timestamp when the system lifecycle controller intent was deleted. The
	// effective charge can remain visible while a manual override is active.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts Discounts applied to the usage-based charge.
	Discounts *BillingRateCardDiscounts `json:"discounts,omitempty"`

	// FullServicePeriod The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`

	// InvoiceAt The timestamp when the charge is intended to be invoiced.
	InvoiceAt DateTime `json:"invoice_at"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Price The price of the charge.
	Price BillingPrice `json:"price"`

	// ServicePeriod The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`
}

type BillingChargeUsageBasedType string

type BillingChargesExpand string

type BillingCostBasis struct {
	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// EffectiveFrom An ISO-8601 timestamp representation of the date from which the cost basis is
	// effective. If not provided, it will be effective immediately and will be set to
	// `now` by the system.
	EffectiveFrom *DateTime `json:"effective_from,omitempty"`

	// EffectiveTo An ISO-8601 timestamp representation of the date until which the cost basis is
	// effective. If provided, it must be later than `effective_from`. If not provided,
	// it remains effective until superseded.
	EffectiveTo *DateTime `json:"effective_to,omitempty"`

	// FiatCode The fiat currency code for the cost basis.
	FiatCode CurrencyCode `json:"fiat_code"`
	Id       ULID         `json:"id"`

	// Rate The cost rate for the currency.
	Rate Numeric `json:"rate"`
}

type BillingCreditAdjustment struct {
	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
}

type BillingCreditAvailabilityPolicy string

type BillingCreditBalances struct {
	// Balances The balances by currencies.
	Balances []CreditBalance `json:"balances"`

	// RetrievedAt The timestamp of the balance retrieval.
	RetrievedAt DateTime `json:"retrieved_at"`
}

type BillingCreditFundingMethod string

type BillingCreditGrant struct {
	// Amount Granted credit amount.
	Amount Numeric `json:"amount"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency The currency of the granted credits.
	Currency BillingCurrencyCode `json:"currency"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// EffectiveAt The timestamp when the credit grant becomes effective.
	//
	// Defaults to the current date and time.
	EffectiveAt *DateTime `json:"effective_at,omitempty"`

	// ExpiresAt The timestamp when the credit grant expires.
	//
	// Calculated from the grant effective time and `expires_after` if provided.
	ExpiresAt *DateTime `json:"expires_at,omitempty"`

	// Filters Filters for the credit grant.
	Filters *BillingCreditGrantFilters `json:"filters,omitempty"`

	// FundingMethod Funding method of the grant.
	FundingMethod BillingCreditFundingMethod `json:"funding_method"`
	Id            ULID                       `json:"id"`

	// Invoice Available when `funding_method` is `invoice`.
	Invoice *BillingCreditGrantInvoiceReference `json:"invoice,omitempty"`

	// Key Idempotency key for the credit grant creation request.
	//
	// When provided, reusing the same key returns an HTTP 409 Conflict instead of
	// creating a duplicate grant, which makes create requests safe to retry.
	Key *ExternalResourceKey `json:"key,omitempty"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Priority Draw-down priority of the grant. Lower values have higher priority.
	Priority *int16 `json:"priority,omitempty"`

	// Purchase Present when a funding workflow applies (funding_method is not `none`).
	Purchase *BillingCreditGrantPurchase `json:"purchase,omitempty"`

	// Status Current lifecycle status of the grant.
	Status BillingCreditGrantStatus `json:"status"`

	// TaxConfig Tax configuration for the grant.
	//
	// For `invoice` and `external` funding methods, tax configuration should be
	// provided to ensure correct revenue recognition. When not provided, the default
	// credit grant tax code is applied, if that's not set the global default taxcode
	// is used.
	TaxConfig *BillingCreditGrantTaxConfig `json:"tax_config,omitempty"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// VoidedAt Timestamp when the grant was voided.
	VoidedAt *DateTime `json:"voided_at,omitempty"`
}

type BillingCreditGrantFilters struct {
	// Features Limit the credit grant to specific features. If no features are specified, the
	// credit grant can be used for any feature.
	Features *[]ResourceKey `json:"features,omitempty"`
}

type BillingCreditGrantInvoiceReference struct {
	// Id Identifier of the invoice associated with the grant.
	Id *ULID `json:"id,omitempty"`

	// Line Identifier of the invoice line associated with the grant.
	Line *struct {
		// Id ULID (Universally Unique Lexicographically Sortable Identifier).
		Id ULID `json:"id"`
	} `json:"line,omitempty"`
}

type BillingCreditGrantPurchase struct {
	// Amount The purchase amount. Calculated from `per_unit_cost_basis` and credit `amount`.
	Amount Numeric `json:"amount"`

	// AvailabilityPolicy Controls when credits become available for consumption.
	//
	// Defaults to `on_creation`.
	AvailabilityPolicy *BillingCreditAvailabilityPolicy `json:"availability_policy,omitempty"`

	// Currency Currency of the purchase amount.
	Currency CurrencyCode `json:"currency"`

	// PerUnitCostBasis Cost basis per credit unit used to calculate the purchase amount.
	//
	// If `per_unit_cost_basis` is 0.50 and credit amount is $100.00, the total charge
	// is $50.00. The value must be greater than 0. If the cost basis is 0, use
	// `funding_method=none` instead.
	//
	// Defaults to 1.0.
	PerUnitCostBasis *Numeric `json:"per_unit_cost_basis,omitempty"`

	// SettlementStatus Current payment settlement status.
	SettlementStatus *BillingCreditPurchasePaymentSettlementStatus `json:"settlement_status,omitempty"`
}

type BillingCreditGrantStatus string

type BillingCreditGrantTaxConfig struct {
	// Behavior Tax behavior applied to the invoice line item.
	Behavior *BillingTaxBehavior `json:"behavior,omitempty"`

	// TaxCode Tax code applied to the invoice line item.
	TaxCode *TaxCodeReference `json:"tax_code,omitempty"`
}

type BillingCreditPurchasePaymentSettlementStatus string

type BillingCreditTransaction struct {
	// Amount Signed amount of the credit movement. Positive values add balance, negative
	// values reduce balance.
	Amount Numeric `json:"amount"`

	// AvailableBalance The available balance before and after the transaction.
	AvailableBalance struct {
		// After Numeric represents an arbitrary precision number.
		After Numeric `json:"after"`

		// Before Numeric represents an arbitrary precision number.
		Before Numeric `json:"before"`
	} `json:"available_balance"`

	// BookedAt The date and time the transaction was booked.
	BookedAt DateTime `json:"booked_at"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency Currency of the balance affected by the transaction.
	Currency BillingCurrencyCode `json:"currency"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`
	Id          ULID    `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Type The type of credit transaction.
	Type BillingCreditTransactionType `json:"type"`
}

type BillingCreditTransactionType string

type BillingCurrency struct {
	// contains filtered or unexported fields
}

type BillingCurrencyCode = CurrencyCode

type BillingCurrencyCodeCustom = string

type BillingCurrencyCustom struct {
	// Code Custom currency code. It should be a unique code but not conflicting with any
	// existing fiat currency codes.
	Code BillingCurrencyCodeCustom `json:"code"`

	// CreatedAt An ISO-8601 timestamp representation of the custom currency creation date.
	CreatedAt DateTime `json:"created_at"`
	Id        ULID     `json:"id"`

	// Name The name of the currency. It should be a human-readable string that represents
	// the name of the currency, such as "US Dollar" or "Euro".
	Name string `json:"name"`

	// Symbol The symbol of the currency. It should be a string that represents the symbol of
	// the currency, such as "$" for US Dollar or "€" for Euro.
	Symbol *string `json:"symbol,omitempty"`

	// Type The type of the currency.
	Type BillingCurrencyCustomType `json:"type"`
}

type BillingCurrencyCustomType string

type BillingCurrencyFiat struct {
	Code CurrencyCode `json:"code"`

	// Name The name of the currency. It should be a human-readable string that represents
	// the name of the currency, such as "US Dollar" or "Euro".
	Name string `json:"name"`

	// Symbol The symbol of the currency. It should be a string that represents the symbol of
	// the currency, such as "$" for US Dollar or "€" for Euro.
	Symbol *string `json:"symbol,omitempty"`

	// Type The type of the currency.
	Type BillingCurrencyFiatType `json:"type"`
}

type BillingCurrencyFiatType string

type BillingCurrencyType string

type BillingCustomer struct {
	// BillingAddress The billing address of the customer. Used for tax and invoicing.
	BillingAddress *Address `json:"billing_address,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency Currency of the customer. Used for billing, tax and invoicing.
	Currency *CurrencyCode `json:"currency,omitempty"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`
	Id          ULID    `json:"id"`

	// Key ExternalResourceKey is a unique string that is used to identify a resource in an
	// external system.
	Key ExternalResourceKey `json:"key"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// PrimaryEmail The primary email address of the customer.
	PrimaryEmail *string `json:"primary_email,omitempty"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// UsageAttribution Mapping to attribute metered usage to the customer by the event subject.
	UsageAttribution *BillingCustomerUsageAttribution `json:"usage_attribution,omitempty"`
}

type BillingCustomerData struct {
	// AppData App customer data.
	AppData *BillingAppCustomerData `json:"app_data,omitempty"`

	// BillingProfile The billing profile for the customer.
	//
	// If not provided, the default billing profile will be used.
	BillingProfile *BillingProfileReference `json:"billing_profile,omitempty"`
}

type BillingCustomerReference struct {
	// Id The ID of the customer.
	Id ULID `json:"id"`
}

type BillingCustomerStripeCreateCheckoutSessionRequest struct {
	// StripeOptions Options for configuring the Stripe Checkout Session.
	//
	// These options are passed directly to Stripe's
	// [checkout session creation API](https://docs.stripe.com/api/checkout/sessions/create).
	StripeOptions BillingAppStripeCreateCheckoutSessionRequestOptions `json:"stripe_options"`
}

type BillingCustomerStripeCreateCustomerPortalSessionRequest struct {
	// StripeOptions Options for configuring the Stripe Customer Portal Session.
	StripeOptions BillingAppStripeCreateCustomerPortalSessionOptions `json:"stripe_options"`
}

type BillingCustomerUsageAttribution struct {
	// SubjectKeys The subjects that are attributed to the customer. Can be empty when no usage
	// event subjects are associated with the customer.
	SubjectKeys []UsageAttributionSubjectKey `json:"subject_keys"`
}

type BillingEntitlementAccessResult struct {
	// Config Only available for static entitlements. Config is the JSON parsable
	// configuration of the entitlement. Useful to describe per customer configuration.
	Config *string `json:"config,omitempty"`

	// FeatureKey The feature key of the entitlement.
	FeatureKey ResourceKey `json:"feature_key"`

	// HasAccess Whether the customer has access to the feature. Always true for `boolean` and
	// `static` entitlements. Depends on balance for `metered` entitlements.
	HasAccess bool `json:"has_access"`

	// Type The type of the entitlement.
	Type BillingEntitlementType `json:"type"`
}

type BillingEntitlementType string

type BillingFeatureLLMTokenType string

type BillingFeatureLLMUnitCost struct {
	// Model Static model ID value (e.g., "gpt-4", "claude-3-5-sonnet"). Use this when the
	// feature tracks a single model. Mutually exclusive with `model_property`.
	Model *string `json:"model,omitempty"`

	// ModelProperty Meter group-by property that holds the model ID. Use this when the meter has a
	// group-by dimension for model. Mutually exclusive with `model`.
	ModelProperty *string `json:"model_property,omitempty"`

	// Pricing Resolved per-token pricing from the LLM cost database. Populated in responses
	// when the provider and model can be determined, either from static values or from
	// meter group-by filters with exact matches.
	Pricing *BillingFeatureLLMUnitCostPricing `json:"pricing,omitempty"`

	// Provider Static LLM provider value (e.g., "openai", "anthropic"). Use this when the
	// feature tracks a single provider. Mutually exclusive with `provider_property`.
	Provider *string `json:"provider,omitempty"`

	// ProviderProperty Meter group-by property that holds the LLM provider. Use this when the meter has
	// a group-by dimension for provider. Mutually exclusive with `provider`.
	ProviderProperty *string `json:"provider_property,omitempty"`

	// TokenType Static token type value. Use this when the feature tracks a single token type
	// (e.g., only input tokens). `request` is an alias for `input`, `response` is an
	// alias for `output`. Mutually exclusive with `token_type_property`.
	TokenType *BillingFeatureLLMTokenType `json:"token_type,omitempty"`

	// TokenTypeProperty Meter group-by property that holds the token type. Use this when the meter has a
	// group-by dimension for token type. Mutually exclusive with `token_type`.
	TokenTypeProperty *string `json:"token_type_property,omitempty"`

	// Type The type discriminator for LLM unit cost.
	Type BillingFeatureLLMUnitCostType `json:"type"`
}

type BillingFeatureLLMUnitCostPricing struct {
	// CacheReadPerToken Cost per cache read token in USD.
	CacheReadPerToken *Numeric `json:"cache_read_per_token,omitempty"`

	// CacheWritePerToken Cost per cache write token in USD.
	CacheWritePerToken *Numeric `json:"cache_write_per_token,omitempty"`

	// InputPerToken Cost per input token in USD.
	InputPerToken Numeric `json:"input_per_token"`

	// OutputPerToken Cost per output token in USD.
	OutputPerToken Numeric `json:"output_per_token"`

	// ReasoningPerToken Cost per reasoning token in USD.
	ReasoningPerToken *Numeric `json:"reasoning_per_token,omitempty"`
}

type BillingFeatureLLMUnitCostType string

type BillingFeatureManualUnitCost struct {
	// Amount Fixed per-unit cost amount in USD.
	Amount Numeric `json:"amount"`

	// Type The type discriminator for manual unit cost.
	Type BillingFeatureManualUnitCostType `json:"type"`
}

type BillingFeatureManualUnitCostType string

type BillingFeatureUnitCost struct {
	// contains filtered or unexported fields
}

type BillingInvoice struct {
	// contains filtered or unexported fields
}

type BillingInvoiceAvailableActionDetails struct {
	// ResultingState The extended status the invoice will transition to after performing this action.
	ResultingState string `json:"resulting_state"`
}

type BillingInvoiceAvailableActions struct {
	// Advance Advance the invoice to the next workflow step.
	Advance *BillingInvoiceAvailableActionDetails `json:"advance,omitempty"`

	// Approve Approve the invoice for issuance.
	Approve *BillingInvoiceAvailableActionDetails `json:"approve,omitempty"`

	// Delete Delete the invoice.
	Delete *BillingInvoiceAvailableActionDetails `json:"delete,omitempty"`

	// Retry Retry a failed workflow step.
	Retry *BillingInvoiceAvailableActionDetails `json:"retry,omitempty"`

	// SnapshotQuantities Snapshot the current usage quantities.
	SnapshotQuantities *BillingInvoiceAvailableActionDetails `json:"snapshot_quantities,omitempty"`
}

type BillingInvoiceCustomer struct {
	// BillingAddress The billing address of the customer. Used for tax and invoicing.
	BillingAddress *Address `json:"billing_address,omitempty"`

	// Id ULID (Universally Unique Lexicographically Sortable Identifier).
	Id ULID `json:"id"`

	// Key Optional external resource key for the customer.
	//
	// Omitted when the customer was created without a key. Unlike on the customer
	// resource itself, the key is optional here because the invoice snapshot may
	// predate or omit it.
	Key *ExternalResourceKey `json:"key,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// UsageAttribution Mapping to attribute metered usage to the customer by the event subject.
	UsageAttribution *BillingCustomerUsageAttribution `json:"usage_attribution,omitempty"`
}

type BillingInvoiceDetailedLine struct {
	// Category The cost category of this detailed line.
	Category BillingInvoiceDetailedLineCostCategory `json:"category"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// CreditsApplied Credit applied to this detailed line.
	CreditsApplied *[]BillingInvoiceLineCreditsApplied `json:"credits_applied,omitempty"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts Discounts applied to this detailed line.
	Discounts *BillingInvoiceLineDiscounts `json:"discounts,omitempty"`

	// ExternalReferences External identifiers for this detailed line.
	ExternalReferences *BillingInvoiceLineExternalReferences `json:"external_references,omitempty"`
	Id                 ULID                                  `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Quantity The quantity of the detailed line.
	Quantity Numeric `json:"quantity"`

	// ServicePeriod The service period covered by this detailed line.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// Totals Aggregated financial totals for the detailed line.
	Totals BillingTotals `json:"totals"`

	// UnitPrice The unit price of the detailed line.
	UnitPrice Numeric `json:"unit_price"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingInvoiceDetailedLineCostCategory string

type BillingInvoiceDiscountReason string

type BillingInvoiceExternalReferences struct {
	// InvoicingId The ID assigned by the external invoicing app (e.g. Stripe invoice ID).
	InvoicingId *string `json:"invoicing_id,omitempty"`

	// PaymentId The ID assigned by the external payment app (e.g. Stripe payment intent ID).
	PaymentId *string `json:"payment_id,omitempty"`
}

type BillingInvoiceLine struct {
	// contains filtered or unexported fields
}

type BillingInvoiceLineAmountDiscount struct {
	// Amount The monetary amount deducted.
	Amount Numeric `json:"amount"`

	// Description Optional human-readable description of the discount.
	Description *string `json:"description,omitempty"`

	// ExternalReferences External identifiers for this discount.
	ExternalReferences *BillingInvoiceLineExternalReferences `json:"external_references,omitempty"`

	// Id Unique identifier for the discount.
	Id ULID `json:"id"`

	// Reason The reason this discount was applied.
	Reason BillingInvoiceDiscountReason `json:"reason"`
}

type BillingInvoiceLineCreditsApplied struct {
	// Amount The monetary amount credited.
	Amount Numeric `json:"amount"`

	// Description Optional human-readable description of the credit allocation.
	Description *string `json:"description,omitempty"`
}

type BillingInvoiceLineDiscounts struct {
	// Amount Monetary amount discounts (e.g. from maximum spend commitments).
	Amount *[]BillingInvoiceLineAmountDiscount `json:"amount,omitempty"`

	// Usage Usage quantity discounts (e.g. free tier usage allowances).
	Usage *[]BillingInvoiceLineUsageDiscount `json:"usage,omitempty"`
}

type BillingInvoiceLineExternalReferences struct {
	// InvoicingId The ID assigned by the external invoicing app.
	InvoicingId *string `json:"invoicing_id,omitempty"`
}

type BillingInvoiceLineRateCard struct {
	// Discounts Discount configuration from the rate card.
	Discounts *BillingRateCardDiscounts `json:"discounts,omitempty"`

	// FeatureKey The feature key associated with this line's rate card.
	FeatureKey *ResourceKey `json:"feature_key,omitempty"`

	// Price The price definition used to calculate charges for this line.
	Price BillingPrice `json:"price"`

	// TaxConfig Tax configuration snapshot for this line.
	TaxConfig *BillingRateCardTaxConfig `json:"tax_config,omitempty"`
}

type BillingInvoiceLineUsageDiscount struct {
	// Description Optional human-readable description of the discount.
	Description *string `json:"description,omitempty"`

	// ExternalReferences External identifiers for this discount.
	ExternalReferences *BillingInvoiceLineExternalReferences `json:"external_references,omitempty"`

	// Id Unique identifier for the discount.
	Id ULID `json:"id"`

	// Quantity The usage quantity deducted (in billing units).
	Quantity Numeric `json:"quantity"`

	// Reason The reason this discount was applied.
	Reason BillingInvoiceDiscountReason `json:"reason"`
}

type BillingInvoiceNumber = string

type BillingInvoiceStandard struct {
	// CollectionAt Timestamp when collection was initiated for this invoice.
	CollectionAt *DateTime `json:"collection_at,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency Three-letter ISO 4217 currency code for the invoice.
	Currency CurrencyCode `json:"currency"`

	// Customer Snapshot of the customer's information at the time the invoice was issued.
	Customer BillingInvoiceCustomer `json:"customer"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// DraftUntil Timestamp until which the invoice remains in draft state.
	//
	// The invoice advances automatically once this time is reached.
	DraftUntil *DateTime `json:"draft_until,omitempty"`

	// DueAt Timestamp when payment is due.
	DueAt *DateTime `json:"due_at,omitempty"`

	// ExternalReferences External identifiers assigned to this invoice by third-party systems.
	ExternalReferences *BillingInvoiceExternalReferences `json:"external_references,omitempty"`
	Id                 ULID                              `json:"id"`

	// IssuedAt Timestamp when the invoice was issued to the customer.
	IssuedAt *DateTime `json:"issued_at,omitempty"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Lines Line items on this invoice.
	//
	// Always returned on single-resource GET; omitted on list endpoints unless
	// explicitly expanded. Editable via update: existing lines are matched by `id`,
	// lines without an `id` are created, and lines present on the invoice but omitted
	// from the update request are deleted. Detailed (child) lines are always computed
	// and cannot be edited directly.
	Lines *[]BillingInvoiceLine `json:"lines,omitempty"`

	// Number Human-readable invoice number generated by the invoicing app.
	Number BillingInvoiceNumber `json:"number"`

	// QuantitySnapshottedAt Timestamp when usage quantities were last snapshotted for this invoice.
	QuantitySnapshottedAt *DateTime `json:"quantity_snapshotted_at,omitempty"`

	// SentToCustomerAt Timestamp when the invoice was sent to the customer.
	SentToCustomerAt *DateTime `json:"sent_to_customer_at,omitempty"`

	// ServicePeriod The service period covered by this invoice.
	//
	// For flat fee the service period can be empty which means `from` will be equals
	// to `to`. In other cases those fields will be filled with the actual service
	// period.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// Status Current lifecycle status of the invoice.
	Status BillingInvoiceStandardStatus `json:"status"`

	// StatusDetails Detailed status information including available actions and workflow state.
	StatusDetails BillingInvoiceStatusDetails `json:"status_details"`

	// Supplier Snapshot of the supplier's contact information at the time the invoice was
	// issued.
	Supplier BillingSupplier `json:"supplier"`

	// Totals Aggregated financial totals for the invoice.
	Totals BillingTotals `json:"totals"`

	// Type Discriminator field identifying this as a standard invoice.
	Type BillingInvoiceStandardType `json:"type"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// ValidationIssues Validation issues found during invoice processing.
	//
	// Present only when there are one or more validation findings. An empty list is
	// omitted.
	ValidationIssues *[]BillingInvoiceValidationIssue `json:"validation_issues,omitempty"`

	// Workflow Workflow configuration snapshot captured at invoice creation time.
	Workflow BillingInvoiceWorkflowSettings `json:"workflow"`
}

type BillingInvoiceStandardLine struct {
	// Charge Reference to the charge associated with this line item.
	Charge *BillingChargeReference `json:"charge,omitempty"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// CreditsApplied Credit applied to this line item.
	CreditsApplied *[]BillingInvoiceLineCreditsApplied `json:"credits_applied,omitempty"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// DetailedLines Detailed sub-lines that this line has been broken down into.
	//
	// Present when line has individual details.
	DetailedLines []BillingInvoiceDetailedLine `json:"detailed_lines"`

	// Discounts Discounts applied to this line item.
	Discounts *BillingInvoiceLineDiscounts `json:"discounts,omitempty"`

	// ExternalReferences External identifiers for this line item assigned by third-party systems.
	ExternalReferences *BillingInvoiceLineExternalReferences `json:"external_references,omitempty"`

	// Id ID of the line.
	//
	// Optional on update: omit to create a new line, or supply the ID of an existing
	// line to edit it. Existing lines omitted from an update's `lines` array are
	// deleted.
	Id *ULID `json:"id,omitempty"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// LifecycleController Indicates whether this line item's lifecycle is controlled by OpenMeter or
	// manually overridden by the API user.
	LifecycleController BillingLifecycleController `json:"lifecycle_controller"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// RateCard The rate card configuration snapshot used to price this line item.
	RateCard BillingInvoiceLineRateCard `json:"rate_card"`

	// ServicePeriod The service period covered by this invoice, spanning the earliest line start to
	// the latest line end across all of its lines.
	//
	// For an invoice with no lines the period is empty, which means `from` will be
	// equal to `to`.
	ServicePeriod ClosedPeriod `json:"service_period"`

	// Subscription Reference to the subscription item that generated this line.
	Subscription *BillingSubscriptionReference `json:"subscription,omitempty"`

	// Totals Aggregated financial totals for the line item.
	Totals BillingTotals `json:"totals"`

	// Type The type of charge this line item represents.
	Type BillingInvoiceStandardLineType `json:"type"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingInvoiceStandardLineType string

type BillingInvoiceStandardStatus string

type BillingInvoiceStandardType string

type BillingInvoiceStatusDetails struct {
	// AvailableActions The set of state-transition actions currently available for this invoice.
	AvailableActions BillingInvoiceAvailableActions `json:"available_actions"`

	// ExtendedStatus Fine-grained internal status string providing additional workflow detail beyond
	// the top-level status enum.
	ExtendedStatus string `json:"extended_status"`

	// Failed Whether the invoice is in a failed state.
	Failed bool `json:"failed"`

	// Immutable Whether the invoice is immutable (i.e. cannot be modified or deleted).
	Immutable bool `json:"immutable"`
}

type BillingInvoiceValidationIssue struct {
	// Attributes Additional structured context.
	Attributes *map[string]interface{} `json:"attributes,omitempty"`

	// Code Machine-readable error code.
	Code string `json:"code"`

	// Field JSON path to the field that caused this validation issue, if applicable.
	//
	// For example: `lines/0/rate_card/price`.
	Field *string `json:"field,omitempty"`

	// Message Human-readable description of the error.
	Message string `json:"message"`

	// Severity Severity of the validation issue.
	Severity BillingInvoiceValidationIssueSeverity `json:"severity"`
}

type BillingInvoiceValidationIssueSeverity string

type BillingInvoiceWorkflow struct {
	// Invoicing Invoicing settings for this invoice.
	Invoicing *BillingInvoiceWorkflowInvoicingSettings `json:"invoicing,omitempty"`

	// Payment Payment settings for this invoice.
	Payment *BillingWorkflowPaymentSettings `json:"payment,omitempty"`
}

type BillingInvoiceWorkflowAppsReferences struct {
	// Invoicing The invoicing app used for this workflow
	Invoicing BillingAppReference `json:"invoicing"`

	// Payment The payment app used for this workflow
	Payment BillingAppReference `json:"payment"`

	// Tax The tax app used for this workflow
	Tax BillingAppReference `json:"tax"`
}

type BillingInvoiceWorkflowInvoicingSettings struct {
	// AutoAdvance Whether to automatically issue the invoice after the draft_period has passed.
	AutoAdvance *bool `json:"auto_advance,omitempty"`

	// DraftPeriod The period for the invoice to be kept in draft status for manual reviews.
	DraftPeriod *string `json:"draft_period,omitempty"`

	// DueAfter The period after which the invoice is considered overdue if not paid.
	DueAfter *string `json:"due_after,omitempty"`
}

type BillingInvoiceWorkflowSettings struct {
	// Apps The apps that will be used to orchestrate the invoice's workflow.
	Apps *BillingInvoiceWorkflowAppsReferences `json:"apps,omitempty"`

	// SourceBillingProfile The billing profile that was the source of this workflow snapshot.
	SourceBillingProfile BillingProfileReference `json:"source_billing_profile"`

	// Workflow The workflow configuration that was active when the invoice was created.
	//
	// Only the fields that are meaningful at the per-invoice level are included:
	// invoicing behaviour (auto-advance, draft period) and payment settings
	// (collection method, due date). Profile-wide settings such as collection
	// alignment, progressive billing, and tax policy are omitted.
	Workflow BillingInvoiceWorkflow `json:"workflow"`
}

type BillingLifecycleController string

type BillingParty struct {
	// Addresses Address for where information should be sent if needed.
	Addresses *BillingPartyAddresses `json:"addresses,omitempty"`

	// Id Unique identifier for the party.
	Id *string `json:"id,omitempty"`

	// Key An optional unique key of the party.
	Key *ExternalResourceKey `json:"key,omitempty"`

	// Name Legal name or representation of the party.
	Name *string `json:"name,omitempty"`

	// TaxId The entity's legal identification used for tax purposes. They may have other
	// numbers, but we're only interested in those valid for tax purposes.
	TaxId *BillingPartyTaxIdentity `json:"tax_id,omitempty"`
}

type BillingPartyAddresses struct {
	// BillingAddress Billing address.
	BillingAddress Address `json:"billing_address"`
}

type BillingPartyTaxIdentity struct {
	// Code Normalized tax identification code shown on the original identity document.
	Code *BillingTaxIdentificationCode `json:"code,omitempty"`
}

type BillingPlan struct {
	// BillingCadence The billing cadence for subscriptions using this plan.
	BillingCadence ISO8601Duration `json:"billing_cadence"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Currency The currency code of the plan.
	Currency CurrencyCode `json:"currency"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// EffectiveFrom The date and time when the plan becomes `active`. When not specified, the plan
	// is in `draft` status.
	EffectiveFrom *DateTime `json:"effective_from,omitempty"`

	// EffectiveTo A scheduled date and time when the plan becomes `archived`. When not specified,
	// the plan is in `active` status indefinitely.
	EffectiveTo *DateTime `json:"effective_to,omitempty"`
	Id          ULID      `json:"id"`

	// Key A key is a semi-unique string that is used to identify the plan. It is used to
	// reference the latest `active` version of the plan and is unique with the version
	// number.
	Key ResourceKey `json:"key"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Phases The plan phases define the pricing ramp for a subscription. A phase switch
	// occurs only at the end of a billing period. At least one phase is required.
	Phases []BillingPlanPhase `json:"phases"`

	// ProRatingEnabled Whether pro-rating is enabled for this plan.
	ProRatingEnabled *bool `json:"pro_rating_enabled,omitempty"`

	// SettlementMode Settlement mode for plan.
	//
	// Values:
	//
	// - `credit_then_invoice`: Credits are applied first, then any remainder is
	// invoiced.
	// - `credit_only`: Usage is settled exclusively against credits.
	SettlementMode *BillingSettlementMode `json:"settlement_mode,omitempty"`

	// Status The status of the plan. Computed based on the effective start and end dates:
	//
	// - `draft`: `effective_from` is not set.
	// - `scheduled`: `now < effective_from`.
	// - `active`: `effective_from <= now` and (`effective_to` is not set or
	// `now < effective_to`).
	// - `archived`: `effective_to <= now`.
	Status BillingPlanStatus `json:"status"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// ValidationErrors List of validation errors in `draft` state that prevent the plan from being
	// published.
	ValidationErrors *[]ProductCatalogValidationError `json:"validation_errors,omitempty"`

	// Version Plans are versioned to allow you to make changes without affecting running
	// subscriptions.
	Version int `json:"version"`
}

type BillingPlanPhase struct {
	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Duration The duration of the phase. When not specified, the phase runs indefinitely. Only
	// the last phase may omit the duration.
	Duration *ISO8601Duration `json:"duration,omitempty"`

	// Key A key is a unique string that is used to identify a resource.
	Key ResourceKey `json:"key"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// RateCards The rate cards of the plan.
	RateCards []BillingRateCard `json:"rate_cards"`
}

type BillingPlanStatus string

type BillingPrice struct {
	// contains filtered or unexported fields
}

type BillingPriceFlat struct {
	// Amount The amount of the flat price.
	Amount Numeric `json:"amount"`

	// Type The type of the price.
	Type BillingPriceFlatType `json:"type"`
}

type BillingPriceFlatType string

type BillingPriceFree struct {
	// Type The type of the price.
	Type BillingPriceFreeType `json:"type"`
}

type BillingPriceFreeType string

type BillingPriceGraduated struct {
	// Tiers The tiers of the graduated price. At least one tier is required.
	Tiers []BillingPriceTier `json:"tiers"`

	// Type The type of the price.
	Type BillingPriceGraduatedType `json:"type"`
}

type BillingPriceGraduatedType string

type BillingPricePaymentTerm string

type BillingPriceTier struct {
	// FlatPrice The flat price component of the tier. Charged once when the tier is entered.
	FlatPrice *BillingPriceFlat `json:"flat_price,omitempty"`

	// UnitPrice The unit price component of the tier. Charged per billing unit within the tier.
	UnitPrice *BillingPriceUnit `json:"unit_price,omitempty"`

	// UpToAmount Up to and including this quantity will be contained in the tier. If undefined,
	// the tier is open-ended (the last tier).
	UpToAmount *Numeric `json:"up_to_amount,omitempty"`
}

type BillingPriceUnit struct {
	// Amount The amount of the unit price.
	Amount Numeric `json:"amount"`

	// Type The type of the price.
	Type BillingPriceUnitType `json:"type"`
}

type BillingPriceUnitType string

type BillingPriceVolume struct {
	// Tiers The tiers of the volume price. At least one tier is required.
	Tiers []BillingPriceTier `json:"tiers"`

	// Type The type of the price.
	Type BillingPriceVolumeType `json:"type"`
}

type BillingPriceVolumeType string

type BillingProfile struct {
	// Apps The applications used by this billing profile.
	Apps BillingProfileAppReferences `json:"apps"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// Default Whether this is the default profile.
	Default bool `json:"default"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`
	Id          ULID    `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// Supplier The name and contact information for the supplier this billing profile
	// represents
	Supplier BillingParty `json:"supplier"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`

	// Workflow The billing workflow settings for this profile
	Workflow BillingWorkflow `json:"workflow"`
}

type BillingProfileAppReferences struct {
	// Invoicing The invoicing app used for this workflow.
	Invoicing BillingAppReference `json:"invoicing"`

	// Payment The payment app used for this workflow.
	Payment BillingAppReference `json:"payment"`

	// Tax The tax app used for this workflow.
	Tax BillingAppReference `json:"tax"`
}

type BillingProfilePagePaginatedResponse struct {
	Data []BillingProfile `json:"data"`

	// Meta returns the pagination information
	Meta PaginatedMeta `json:"meta"`
}

type BillingProfileReference struct {
	// Id The ID of the billing profile.
	Id ULID `json:"id"`
}

type BillingRateCard struct {
	// BillingCadence The billing cadence of the rate card. When null, the charge is one-time
	// (non-recurring). Only valid for flat prices.
	BillingCadence *ISO8601Duration `json:"billing_cadence,omitempty"`

	// Commitments Spend commitments for this rate card. Only applicable to usage-based prices
	// (unit, graduated, volume).
	Commitments *BillingSpendCommitments `json:"commitments,omitempty"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,omitempty"`

	// Discounts The discounts of the rate card.
	Discounts *BillingRateCardDiscounts `json:"discounts,omitempty"`

	// Entitlement The entitlement template granted to subscribers of a plan or addon containing
	// this rate card. Requires `feature` to be set.
	Entitlement *BillingRateCardEntitlement `json:"entitlement,omitempty"`

	// Feature The feature associated with the rate card.
	Feature *FeatureReference `json:"feature,omitempty"`

	// Key A key is a unique string that is used to identify a resource.
	Key ResourceKey `json:"key"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Name Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`

	// PaymentTerm The payment term of the rate card. In advance payment term can only be used for
	// flat prices.
	PaymentTerm *BillingPricePaymentTerm `json:"payment_term,omitempty"`

	// Price The price of the rate card.
	Price BillingPrice `json:"price"`

	// TaxConfig The tax config of the rate card.
	TaxConfig *BillingRateCardTaxConfig `json:"tax_config,omitempty"`

	// UnitConfig Unit conversion configuration for the rate card.
	//
	// Synthesized on read for plans authored with v1 dynamic or package prices:
	// dynamic prices map to a unit price with a multiply unit config, and package
	// prices map to a unit price with a divide unit config.
	//
	// Accepted on create and update only when the UnitConfig feature is enabled on the
	// deployment; otherwise rejected.
	UnitConfig *BillingUnitConfig `json:"unit_config,omitempty"`
}

type BillingRateCardBooleanEntitlement struct {
	// Type The type of the entitlement template.
	Type BillingRateCardBooleanEntitlementType `json:"type"`
}

type BillingRateCardBooleanEntitlementType string

type BillingRateCardDiscounts struct {
	// Percentage Percentage discount applied to the price (0–100).
	Percentage *float32 `json:"percentage,omitempty"`

	// Usage Number of usage units granted free before billing starts. Only applies to
	// usage-based lines (not flat fees). Usage is treated as zero until this amount is
	// exhausted.
	Usage *Numeric `json:"usage,omitempty"`
}

type BillingRateCardEntitlement struct {
	// contains filtered or unexported fields
}

type BillingRateCardMeteredEntitlement struct {
	// IsSoftLimit If soft limit is true, the subject can use the feature even if the entitlement
	// is exhausted; access remains granted.
	IsSoftLimit *bool `json:"is_soft_limit,omitempty"`

	// Limit The amount of usage granted each usage period, in the feature's unit. Usage is
	// counted against this allowance and the balance resets every usage period. When
	// `is_soft_limit` is true the subject keeps access after the limit is reached;
	// otherwise access is denied once the allowance is exhausted.
	Limit *float64 `json:"limit,omitempty"`

	// Type The type of the entitlement template.
	Type BillingRateCardMeteredEntitlementType `json:"type"`

	// UsagePeriod The reset interval of the metered entitlement in ISO8601 format. Defaults to the
	// billing cadence of the rate card.
	UsagePeriod *ISO8601Duration `json:"usage_period,omitempty"`
}

type BillingRateCardMeteredEntitlementType string

type BillingRateCardProrationConfiguration struct {
	// Mode The proration mode of the rate card.
	Mode BillingRateCardProrationMode `json:"mode"`
}

type BillingRateCardProrationMode string

type BillingRateCardStaticEntitlement struct {
	// Config The entitlement config as a JSON object. Returned when checking entitlement
	// access; useful for configuring fine-grained access settings implemented in your
	// own system.
	Config interface{} `json:"config"`

	// Type The type of the entitlement template.
	Type BillingRateCardStaticEntitlementType `json:"type"`
}

type BillingRateCardStaticEntitlementType string

type BillingRateCardTaxConfig struct {
	// Behavior Tax behavior.
	//
	// This enum is used to specify whether tax is included in the price or excluded
	// from the price.
	Behavior *BillingTaxBehavior `json:"behavior,omitempty"`

	// Code TaxCode reference.
	Code TaxCodeReference `json:"code"`
}

type BillingSettlementMode string

type BillingSpendCommitments struct {
	// MaximumAmount The customer is limited to spend at most the amount.
	MaximumAmount *Numeric `json:"maximum_amount,omitempty"`

	// MinimumAmount The customer is committed to spend at least the amount.
	MinimumAmount *Numeric `json:"minimum_amount,omitempty"`
}

type BillingSubscription struct {
	// BillingAnchor A billing anchor is the fixed point in time that determines the subscription's
	// recurring billing cycle. It affects when charges occur and how prorations are
	// calculated. Common anchors:
	//
	// - Calendar month (1st of each month): `2025-01-01T00:00:00Z`
	// - Subscription anniversary (day customer signed up)
	// - Custom date (customer-specified day)
	BillingAnchor DateTime `json:"billing_anchor"`

	// CreatedAt An ISO-8601 timestamp representation of entity creation date.
	CreatedAt DateTime `json:"created_at"`

	// CustomerId The customer ID of the subscription.
	CustomerId ULID `json:"customer_id"`

	// DeletedAt An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *DateTime `json:"deleted_at,omitempty"`
	Id        ULID      `json:"id"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// PlanId The plan ID of the subscription. Set if subscription is created from a plan.
	PlanId *ULID `json:"plan_id,omitempty"`

	// SettlementMode Settlement mode for billing.
	//
	// Values:
	//
	// - `credit_then_invoice`: Credits are applied first, then any remainder is
	// invoiced.
	// - `credit_only`: Usage is settled exclusively against credits.
	SettlementMode *BillingSettlementMode `json:"settlement_mode,omitempty"`

	// Status The status of the subscription.
	Status BillingSubscriptionStatus `json:"status"`

	// UpdatedAt An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt DateTime `json:"updated_at"`
}

type BillingSubscriptionCancel struct {
	// Timing If not provided the subscription is canceled immediately.
	Timing *BillingSubscriptionEditTiming `json:"timing,omitempty"`
}

type BillingSubscriptionChange struct {
	// BillingAnchor A billing anchor is the fixed point in time that determines the subscription's
	// recurring billing cycle. It affects when charges occur and how prorations are
	// calculated. Common anchors:
	//
	// - Calendar month (1st of each month): `2025-01-01T00:00:00Z`
	// - Subscription anniversary (day customer signed up)
	// - Custom date (customer-specified day)
	//
	// If not provided, the subscription will be created with the subscription's
	// creation time as the billing anchor.
	BillingAnchor *DateTime `json:"billing_anchor,omitempty"`

	// Customer The customer to create the subscription for.
	Customer struct {
		// Id The ID of the customer to create the subscription for.
		//
		// Either customer ID or customer key must be provided. If both are provided, the
		// ID will be used.
		Id *ULID `json:"id,omitempty"`

		// Key The key of the customer to create the subscription for.
		//
		// Either customer ID or customer key must be provided. If both are provided, the
		// ID will be used.
		Key *ExternalResourceKey `json:"key,omitempty"`
	} `json:"customer"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Plan The plan reference of the subscription.
	Plan struct {
		// Id The plan ID of the subscription. Set if subscription is created from a plan.
		//
		// ID or Key of the plan is required if creating a subscription from a plan. If
		// both are provided, the ID will be used.
		Id *ULID `json:"id,omitempty"`

		// Key The plan Key of the subscription, if any. Set if subscription is created from a
		// plan.
		//
		// ID or Key of the plan is required if creating a subscription from a plan. If
		// both are provided, the ID will be used.
		Key *ResourceKey `json:"key,omitempty"`

		// Version The plan version of the subscription, if any. If not provided, the latest
		// version of the plan will be used.
		Version *int `json:"version,omitempty"`
	} `json:"plan"`

	// SettlementMode Settlement mode for billing.
	//
	// Values:
	//
	// - `credit_then_invoice`: Credits are applied first, then any remainder is
	// invoiced.
	// - `credit_only`: Usage is settled exclusively against credits.
	SettlementMode *BillingSettlementMode `json:"settlement_mode,omitempty"`

	// Timing Timing configuration for the change, when the change should take effect. For
	// changing a subscription, the accepted values depend on the subscription
	// configuration.
	Timing BillingSubscriptionEditTiming `json:"timing"`
}

type BillingSubscriptionChangeResponse struct {
	// Current The current subscription before the change.
	Current BillingSubscription `json:"current"`

	// Next The new state of the subscription after the change.
	Next BillingSubscription `json:"next"`
}

type BillingSubscriptionCreate struct {
	// BillingAnchor A billing anchor is the fixed point in time that determines the subscription's
	// recurring billing cycle. It affects when charges occur and how prorations are
	// calculated. Common anchors:
	//
	// - Calendar month (1st of each month): `2025-01-01T00:00:00Z`
	// - Subscription anniversary (day customer signed up)
	// - Custom date (customer-specified day)
	//
	// If not provided, the subscription will be created with the subscription's
	// creation time as the billing anchor.
	BillingAnchor *DateTime `json:"billing_anchor,omitempty"`

	// Customer The customer to create the subscription for.
	Customer struct {
		// Id The ID of the customer to create the subscription for.
		//
		// Either customer ID or customer key must be provided. If both are provided, the
		// ID will be used.
		Id *ULID `json:"id,omitempty"`

		// Key The key of the customer to create the subscription for.
		//
		// Either customer ID or customer key must be provided. If both are provided, the
		// ID will be used.
		Key *ExternalResourceKey `json:"key,omitempty"`
	} `json:"customer"`

	// Labels Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
	//
	// Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
	Labels *Labels `json:"labels,omitempty"`

	// Plan The plan reference of the subscription.
	Plan struct {
		// Id The plan ID of the subscription. Set if subscription is created from a plan.
		//
		// ID or Key of the plan is required if creating a subscription from a plan. If
		// both are provided, the ID will be used.
		Id *ULID `json:"id,omitempty"`

		// Key The plan Key of the subscription, if any. Set if subscription is created from a
		// plan.
		//
		// ID or Key of the plan is required if creating a subscription from a plan. If
		// both are provided, the ID will be used.
		Key *ResourceKey `json:"key,omitempty"`

		// Version The plan version of the subscription, if any. If not provided, the latest
		// version of the plan will be used.
		Version *int `json:"version,omitempty"`
	} `json:"plan"`

	// SettlementMode Settlement mode for billing.
	//
	// Values:
	//
	// - `credit_then_invoice`: Credits are applied first, then any remainder is
	// invoiced.
	// - `credit_only`: Usage is settled exclusively against credits.
	SettlementMode *BillingSettlementMode `json:"settlement_mode,omitempty"`
}

type BillingSubscriptionEditTiming struct {
	// contains filtered or unexported fields
}