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 AddonReferenceItem 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 BillingAddress 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 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 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 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"`

	// 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"`

	// Filters Filters for the credit grant.
	Filters *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"`
	} `json:"filters,omitempty"`

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

	// Invoice Invoice references for the grant. Available when `funding_method` is `invoice`.
	Invoice *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"`
	} `json:"invoice,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 Purchase and payment terms of the grant. Present when a funding workflow applies
	// (funding_method is not `none`).
	Purchase *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"`
	} `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 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 *BillingTaxCodeReference `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"`

	// Description Description of the currency.
	Description *string `json:"description,omitempty"`
	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"`

	// Description Description of the currency.
	Description *string `json:"description,omitempty"`
	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 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 *BillingAddress `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 BillingFlatFeeCharge 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 *BillingFlatFeeDiscounts `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"`

	// ManagedBy The charge is managed by the following entity.
	ManagedBy ResourceManagedBy `json:"managed_by"`

	// 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"`

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

	// Type The type of the charge.
	Type BillingFlatFeeChargeType `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 BillingFlatFeeChargeType string

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

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"`

	// 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"`

	// Feature The feature associated with the rate card.
	Feature *FeatureReferenceItem `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"`
}

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 BillingRateCardProrationConfiguration struct {
	// Mode The proration mode of the rate card.
	Mode BillingRateCardProrationMode `json:"mode"`
}

type BillingRateCardProrationMode 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 TaxCodeReferenceItem `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"`

	// 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"`

	// 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"`
}

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

type BillingSubscriptionEditTimingEnum string

type BillingSubscriptionReference struct {
	// Id The ID of the subscription.
	Id ULID `json:"id"`

	// Phase The phase of the subscription.
	Phase struct {
		// Id The ID of the phase.
		Id ULID `json:"id"`

		// Item The item of the phase.
		Item struct {
			// Id The ID of the item.
			Id ULID `json:"id"`
		} `json:"item"`
	} `json:"phase"`
}

type BillingSubscriptionStatus string

type BillingTaxBehavior string

type BillingTaxCode struct {
	// AppMappings Mapping of app types to tax codes.
	AppMappings []BillingTaxCodeAppMapping `json:"app_mappings"`

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

	// 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 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"`

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

type BillingTaxCodeAppMapping struct {
	// AppType The app type that the tax code is associated with.
	AppType BillingAppType `json:"app_type"`

	// TaxCode Tax code.
	TaxCode string `json:"tax_code"`
}

type BillingTaxCodeReference = TaxCodeReference

type BillingTaxConfig struct {
	// Behavior Tax behavior.
	//
	// If not specified the billing profile is used to determine the tax behavior. If
	// not specified in the billing profile, the provider's default behavior is used.
	Behavior *BillingTaxBehavior `json:"behavior,omitempty"`

	// ExternalInvoicing External invoicing tax config.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	ExternalInvoicing *BillingTaxConfigExternalInvoicing `json:"external_invoicing,omitempty"`

	// Stripe Stripe tax config.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	Stripe *BillingTaxConfigStripe `json:"stripe,omitempty"`

	// TaxCode Tax code reference.
	//
	// When both `tax_code` and `tax_code_id` are provided, `tax_code` takes
	// precedence. When `stripe.code` is also provided, `tax_code` still wins and
	// `stripe.code` is ignored.
	TaxCode *BillingTaxCodeReference `json:"tax_code,omitempty"`

	// TaxCodeId Tax code ID.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	TaxCodeId *ULID `json:"tax_code_id,omitempty"`
}

type BillingTaxConfigExternalInvoicing struct {
	// Code The tax code should be interpreted by the external invoicing provider.
	Code string `json:"code"`
}

type BillingTaxConfigStripe struct {
	// Code Product [tax code](https://docs.stripe.com/tax/tax-codes).
	Code string `json:"code"`
}

type BillingTaxIdentificationCode = string

type BillingTotals struct {
	// Amount The total value of the resource before taxes, discounts and commitments.
	Amount Numeric `json:"amount"`

	// ChargesTotal The total amount contributed by additional charges.
	ChargesTotal Numeric `json:"charges_total"`

	// CreditsTotal The total amount deducted through credits before taxes are applied.
	CreditsTotal Numeric `json:"credits_total"`

	// DiscountsTotal The total amount deducted through discounts.
	DiscountsTotal Numeric `json:"discounts_total"`

	// TaxesExclusiveTotal The total tax amount added on top of the resource amount.
	TaxesExclusiveTotal Numeric `json:"taxes_exclusive_total"`

	// TaxesInclusiveTotal The total tax amount already included in the resource amount.
	TaxesInclusiveTotal Numeric `json:"taxes_inclusive_total"`

	// TaxesTotal The total tax amount applied to the resource.
	TaxesTotal Numeric `json:"taxes_total"`

	// Total The final total value of the resource after taxes, discounts and commitments.
	Total Numeric `json:"total"`
}

type BillingUsageBasedCharge 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"`

	// ManagedBy The charge is managed by the following entity.
	ManagedBy ResourceManagedBy `json:"managed_by"`

	// 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"`

	// 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 BillingUsageBasedChargeType `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 BillingUsageBasedChargeType string

type BillingWorkflow struct {
	// Collection The collection settings for this workflow
	Collection *BillingWorkflowCollectionSettings `json:"collection,omitempty"`

	// Invoicing The invoicing settings for this workflow
	Invoicing *BillingWorkflowInvoicingSettings `json:"invoicing,omitempty"`

	// Payment The payment settings for this workflow
	Payment *BillingWorkflowPaymentSettings `json:"payment,omitempty"`

	// Tax The tax settings for this workflow
	Tax *BillingWorkflowTaxSettings `json:"tax,omitempty"`
}

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

type BillingWorkflowCollectionAlignmentAnchored struct {
	// RecurringPeriod The recurring period for the alignment.
	RecurringPeriod RecurringPeriod `json:"recurring_period"`

	// Type The type of alignment.
	Type BillingWorkflowCollectionAlignmentAnchoredType `json:"type"`
}

type BillingWorkflowCollectionAlignmentAnchoredType string

type BillingWorkflowCollectionAlignmentSubscription struct {
	// Type The type of alignment.
	Type BillingWorkflowCollectionAlignmentSubscriptionType `json:"type"`
}

type BillingWorkflowCollectionAlignmentSubscriptionType string

type BillingWorkflowCollectionSettings struct {
	// Alignment The alignment for collecting the pending line items into an invoice.
	Alignment *BillingWorkflowCollectionAlignment `json:"alignment,omitempty"`

	// Interval This grace period can be used to delay the collection of the pending line items
	// specified in alignment.
	//
	// This is useful, in case of multiple subscriptions having slightly different
	// billing periods.
	Interval *string `json:"interval,omitempty"`
}

type BillingWorkflowInvoicingSettings struct {
	// AutoAdvance Whether to automatically issue the invoice after the draftPeriod 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"`

	// ProgressiveBilling Should progressive billing be allowed for this workflow?
	ProgressiveBilling *bool `json:"progressive_billing,omitempty"`
}

type BillingWorkflowPaymentChargeAutomaticallySettings struct {
	// CollectionMethod The collection method for the invoice.
	CollectionMethod BillingWorkflowPaymentChargeAutomaticallySettingsCollectionMethod `json:"collection_method"`
}

type BillingWorkflowPaymentChargeAutomaticallySettingsCollectionMethod string

type BillingWorkflowPaymentSendInvoiceSettings struct {
	// CollectionMethod The collection method for the invoice.
	CollectionMethod BillingWorkflowPaymentSendInvoiceSettingsCollectionMethod `json:"collection_method"`

	// DueAfter The period after which the invoice is due. With some payment solutions it's only
	// applicable for manual collection method.
	DueAfter *string `json:"due_after,omitempty"`
}

type BillingWorkflowPaymentSendInvoiceSettingsCollectionMethod string

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

type BillingWorkflowTaxSettings struct {
	// DefaultTaxConfig Default tax configuration to apply to the invoices for line items.
	DefaultTaxConfig *BillingTaxConfig `json:"default_tax_config,omitempty"`

	// Enabled Enable automatic tax calculation when tax is supported by the app. For example,
	// with Stripe Invoicing when enabled, tax is calculated via Stripe Tax.
	Enabled *bool `json:"enabled,omitempty"`

	// Enforced Enforce tax calculation when tax is supported by the app. When enabled, the
	// billing system will not allow to create an invoice without tax calculation.
	// Enforcement is different per apps, for example, Stripe app requires customer to
	// have a tax location when starting a paid subscription.
	Enforced *bool `json:"enforced,omitempty"`
}

type CancelSubscriptionJSONRequestBody = BillingSubscriptionCancel

type ChangeSubscriptionJSONRequestBody = BillingSubscriptionChange

type ChargePagePaginatedResponse struct {
	Data []BillingCharge `json:"data"`

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

type ChiServerOptions struct {
	BaseURL          string
	BaseRouter       chi.Router
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type ClosedPeriod struct {
	// From The start of the period.
	//
	// The period is inclusive at the start.
	From DateTime `json:"from"`

	// To The end of the period.
	//
	// The period is exclusive at the end.
	To DateTime `json:"to"`
}

type Conflict = ConflictError

type ConflictError struct {
	Detail   interface{} `json:"detail"`
	Instance interface{} `json:"instance"`
	Status   interface{} `json:"status"`
	Title    interface{} `json:"title"`
	Type     interface{} `json:"type,omitempty"`
}

type CostBasisPagePaginatedResponse struct {
	Data []BillingCostBasis `json:"data"`

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

type CountryCode = string

type CreateAddonJSONRequestBody = CreateAddonRequest

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

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

	// 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"`
}

type CreateBillingProfileJSONRequestBody = CreateBillingProfileRequest

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

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

	// 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"`

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

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

type CreateCostBasisJSONRequestBody = CreateCostBasisRequest

type CreateCostBasisRequest struct {
	// 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"`

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

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

type CreateCreditAdjustmentJSONRequestBody = CreateCreditAdjustmentRequest

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

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

	// 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 CreateCreditGrantJSONRequestBody = CreateCreditGrantRequest

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

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

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

	// Filters Filters for the credit grant.
	Filters *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"`
	} `json:"filters,omitempty"`

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

	// 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 Purchase and payment terms of the grant. Present when a funding workflow applies
	// (funding_method is not `none`).
	Purchase *struct {
		// 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"`
	} `json:"purchase,omitempty"`

	// 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"`
}

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

	// Description Description of the currency.
	Description *string `json:"description,omitempty"`

	// 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 CreateCustomCurrencyJSONRequestBody = CreateCurrencyCustomRequest

type CreateCustomerJSONRequestBody = CreateCustomerRequest

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

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

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

	// 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"`

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

type CreateCustomerStripeCheckoutSessionJSONRequestBody = BillingCustomerStripeCreateCheckoutSessionRequest

type CreateCustomerStripePortalSessionJSONRequestBody = BillingCustomerStripeCreateCustomerPortalSessionRequest

type CreateFeatureJSONRequestBody = CreateFeatureRequest

type CreateFeatureRequest struct {
	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,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"`

	// Meter The meter that the feature is associated with and based on which usage is
	// calculated. If not specified, the feature is static.
	Meter *FeatureMeterReference `json:"meter,omitempty"`

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

	// UnitCost Optional per-unit cost configuration. Use "manual" for a fixed per-unit cost, or
	// "llm" to look up cost from the LLM cost database based on meter group-by
	// properties.
	UnitCost *BillingFeatureUnitCost `json:"unit_cost,omitempty"`
}

type CreateLlmCostOverrideJSONRequestBody = LLMCostOverrideCreate

type CreateMeterJSONRequestBody = CreateMeterRequest

type CreateMeterRequest struct {
	// Aggregation The aggregation type to use for the meter.
	Aggregation MeterAggregation `json:"aggregation"`

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

	// Dimensions Named JSONPath expressions to extract the group by values from the event data.
	//
	// Keys must be unique and consist only alphanumeric and underscore characters.
	Dimensions *map[string]string `json:"dimensions,omitempty"`

	// EventType The event type to include in the aggregation.
	EventType string `json:"event_type"`

	// EventsFrom The date since the meter should include events. Useful to skip old events. If
	// not specified, all historical events are included.
	EventsFrom *DateTime `json:"events_from,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"`

	// ValueProperty JSONPath expression to extract the value from the ingested event's data
	// property.
	//
	// The ingested value for sum, avg, min, and max aggregations is a number or a
	// string that can be parsed to a number.
	//
	// For unique_count aggregation, the ingested value must be a string. For count
	// aggregation the value_property is ignored.
	ValueProperty *string `json:"value_property,omitempty"`
}

type CreatePlanAddonJSONRequestBody = CreatePlanAddonRequest

type CreatePlanAddonRequest struct {
	// Addon The add-on associated with the plan.
	Addon AddonReference `json:"addon"`

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

	// FromPlanPhase The key of the plan phase from which the add-on becomes available for purchase.
	FromPlanPhase ResourceKey `json:"from_plan_phase"`

	// 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"`

	// MaxQuantity The maximum number of times the add-on can be purchased for the plan. For
	// single-instance add-ons this field must be omitted. For multi-instance add-ons
	// when omitted, unlimited quantity can be purchased.
	MaxQuantity *int `json:"max_quantity,omitempty"`

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

type CreatePlanJSONRequestBody = CreatePlanRequest

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

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

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

	// 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"`
}

type CreateSubscriptionJSONRequestBody = BillingSubscriptionCreate

type CreateTaxCodeJSONRequestBody = CreateTaxCodeRequest

type CreateTaxCodeRequest struct {
	// AppMappings Mapping of app types to tax codes.
	AppMappings []BillingTaxCodeAppMapping `json:"app_mappings"`

	// Description Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string `json:"description,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"`
}

type CreditBalance struct {
	// Available Credits that can be consumed right now. Derived from cleared grants after
	// applying eligibility and restriction rules.
	Available Numeric             `json:"available"`
	Currency  BillingCurrencyCode `json:"currency"`

	// Pending Credits that have been granted but cannot yet be consumed. Includes grants
	// awaiting payment clearance or with a future effective date.
	Pending Numeric `json:"pending"`
}

type CreditGrantPagePaginatedResponse struct {
	Data []BillingCreditGrant `json:"data"`

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

type CreditTransactionPaginatedResponse struct {
	Data []BillingCreditTransaction `json:"data"`

	// Meta Pagination metadata.
	Meta CursorMeta `json:"meta"`
}

type CurrencyAmount struct {
	// Amount Numeric represents an arbitrary precision number.
	Amount Numeric `json:"amount"`

	// Currency Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html)
	// currency code. Custom three-letter currency codes are also supported for
	// convenience.
	Currency CurrencyCode `json:"currency"`
}

type CurrencyCode = string

type CurrencyPagePaginatedResponse struct {
	Data []BillingCurrency `json:"data"`

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

type CursorMeta struct {
	Page CursorMetaPage `json:"page"`
}

type CursorMetaPage struct {
	// First URI to the first page
	First *string `json:"first,omitempty"`

	// Last URI to the last page
	Last *string `json:"last,omitempty"`

	// Next URI to the next page
	Next nullable.Nullable[string] `json:"next"`

	// Previous URI to the previous page
	Previous nullable.Nullable[string] `json:"previous"`

	// Size Requested page size
	Size float32 `json:"size"`
}

type CursorPaginationQuery = CursorPaginationQueryPage

type CursorPaginationQueryPage struct {
	// After Request the next page of data, starting with the item after this parameter.
	After *string `json:"after,omitempty"`

	// Before Request the previous page of data, starting with the item before this parameter.
	Before *string `json:"before,omitempty"`

	// Size The number of items to include per page.
	Size *int `json:"size,omitempty"`
}

type CustomerPagePaginatedResponse struct {
	Data []BillingCustomer `json:"data"`

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

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

type DateTime = time.Time

type DateTimeFieldFilter = filters.FilterDateTime

type ExternalResourceKey = string

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

	// 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 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"`

	// Meter The meter that the feature is associated with and based on which usage is
	// calculated. If not specified, the feature is static.
	Meter *FeatureMeterReference `json:"meter,omitempty"`

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

	// UnitCost Optional per-unit cost configuration. Use "manual" for a fixed per-unit cost, or
	// "llm" to look up cost from the LLM cost database based on meter group-by
	// properties.
	UnitCost *BillingFeatureUnitCost `json:"unit_cost,omitempty"`

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

type FeatureCostQueryResult struct {
	// Data The cost data rows.
	Data []FeatureCostQueryRow `json:"data"`

	// From Start of the queried period.
	From *DateTime `json:"from,omitempty"`

	// To End of the queried period.
	To *DateTime `json:"to,omitempty"`
}

type FeatureCostQueryRow struct {
	// Cost The computed cost amount (usage × unit cost). Null when pricing is not available
	// for the given combination of dimensions.
	Cost nullable.Nullable[Numeric] `json:"cost"`

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

	// Detail Detail message when cost amount is null, explaining why the cost could not be
	// resolved.
	Detail *string `json:"detail,omitempty"`

	// Dimensions The dimensions the value is aggregated over. `subject` and `customer_id` are
	// reserved dimensions.
	Dimensions map[string]string `json:"dimensions"`

	// From The start of the time bucket the value is aggregated over.
	From DateTime `json:"from"`

	// To The end of the time bucket the value is aggregated over.
	To DateTime `json:"to"`

	// Usage The metered usage value for the period.
	Usage Numeric `json:"usage"`
}

type FeatureMeterReference struct {
	// Filters Filters to apply to the dimensions of the meter.
	Filters *map[string]QueryFilterStringMapItem `json:"filters,omitempty"`

	// Id The ID of the meter to associate with this feature.
	Id ULID `json:"id"`
}

type FeaturePagePaginatedResponse struct {
	Data []Feature `json:"data"`

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

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

type Forbidden = ForbiddenError

type ForbiddenError struct {
	Detail   interface{} `json:"detail"`
	Instance interface{} `json:"instance"`
	Status   interface{} `json:"status"`
	Title    interface{} `json:"title"`
	Type     interface{} `json:"type,omitempty"`
}

type GetCreditBalanceParamsFilter struct {
	// Currency Filter credit balance by currency.
	Currency *BillingCurrencyCode `json:"currency,omitempty"`
}

type GetCustomerCreditBalanceParams struct {
	Filter *GetCreditBalanceParamsFilter `json:"filter,omitempty"`
}