openmeter

type APIError struct {
	// StatusCode is the HTTP status code of the response.
	StatusCode int `json:"-"`

	// Status is the status code echoed in the problem body (usually equal to
	// StatusCode).
	Status int `json:"status"`
	// Title is a short, stable, human-readable summary of the problem.
	Title string `json:"title"`
	// Type is an optional machine-readable error type.
	Type string `json:"type,omitempty"`
	// Detail is a human-readable explanation specific to this occurrence.
	Detail string `json:"detail"`
	// Instance carries the correlation ID, formatted as kong:trace:<id>.
	Instance string `json:"instance"`

	// RawBody is the undecoded response body, always populated.
	RawBody []byte `json:"-"`
}

type Addon struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	// 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 string `json:"key"`
	// Version of the add-on. Incremented when the add-on is updated.
	Version int64 `json:"version"`
	// The InstanceType of the add-ons. Can be "single" or "multiple".
	InstanceType AddonInstanceType `json:"instance_type"`
	// The currency code of the add-on.
	Currency BillingCurrencyCode `json:"currency"`
	// The date and time when the add-on becomes effective. When not specified, the
	// add-on is a draft.
	EffectiveFrom *time.Time `json:"effective_from,omitempty"`
	// The date and time when the add-on is no longer effective. When not specified,
	// the add-on is effective indefinitely.
	EffectiveTo *time.Time `json:"effective_to,omitempty"`
	// 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"`
	// The rate cards of the add-on.
	RateCards []RateCard `json:"rate_cards"`
	// List of validation errors.
	ValidationErrors []ProductCatalogValidationError `json:"validation_errors,omitempty"`
}

type AddonFilter struct {
	ID       *StringExactFilter
	Key      *StringFilter
	Name     *StringFilter
	Status   *StringExactFilter
	Currency *StringExactFilter
}

type AddonInstanceType string

type AddonListParams struct {
	Page   *PageParams
	Sort   *Sort
	Filter *AddonFilter
}

type AddonPagePaginatedResponse struct {
	Data []Addon       `json:"data"`
	Meta PaginatedMeta `json:"meta"`
}

type AddonReference struct {
	ID string `json:"id"`
}

type AddonStatus string

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

type Address struct {
	// Country code in [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html)
	// alpha-2 format.
	Country *string `json:"country,omitempty"`
	// Postal code.
	PostalCode *string `json:"postal_code,omitempty"`
	// State or province.
	State *string `json:"state,omitempty"`
	// City.
	City *string `json:"city,omitempty"`
	// First line of the address.
	Line1 *string `json:"line1,omitempty"`
	// Second line of the address.
	Line2 *string `json:"line2,omitempty"`
	// Phone number.
	PhoneNumber *string `json:"phone_number,omitempty"`
}

type App struct {
	Type string `json:"type"`
	// contains filtered or unexported fields
}

type AppCatalogItem struct {
	// Type of the app.
	Type AppType `json:"type"`
	// Name of the app.
	Name string `json:"name"`
	// Description of the app.
	Description string `json:"description"`
}

type AppCustomerData struct {
	// Used if the customer has a linked Stripe app.
	Stripe *AppCustomerDataStripe `json:"stripe,omitempty"`
	// Used if the customer has a linked external invoicing app.
	ExternalInvoicing *AppCustomerDataExternalInvoicing `json:"external_invoicing,omitempty"`
}

type AppCustomerDataExternalInvoicing struct {
	// Labels for this external invoicing integration on the customer.
	Labels map[string]string `json:"labels,omitempty"`
}

type AppCustomerDataExternalInvoicingInput struct {
	// Labels for this external invoicing integration on the customer.
	Labels *map[string]string `json:"labels,omitempty"`
}

type AppCustomerDataInput struct {
	// Used if the customer has a linked Stripe app.
	Stripe *AppCustomerDataStripeInput `json:"stripe,omitempty"`
	// Used if the customer has a linked external invoicing app.
	ExternalInvoicing *AppCustomerDataExternalInvoicingInput `json:"external_invoicing,omitempty"`
}

type AppCustomerDataStripe struct {
	// The Stripe customer ID used.
	CustomerID *string `json:"customer_id,omitempty"`
	// The Stripe default payment method ID.
	DefaultPaymentMethodID *string `json:"default_payment_method_id,omitempty"`
	// Labels for this Stripe integration on the customer.
	Labels map[string]string `json:"labels,omitempty"`
}

type AppCustomerDataStripeInput struct {
	// The Stripe customer ID used.
	CustomerID *string `json:"customer_id,omitempty"`
	// The Stripe default payment method ID.
	DefaultPaymentMethodID *string `json:"default_payment_method_id,omitempty"`
	// Labels for this Stripe integration on the customer.
	Labels *map[string]string `json:"labels,omitempty"`
}

type AppExternalInvoicing struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	// The app type.
	Type AppType `json:"type"`
	// The app catalog definition that this installed app is based on.
	Definition AppCatalogItem `json:"definition"`
	// Status of the app connection.
	Status AppStatus `json:"status"`
	// 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"`
	// 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"`
}

type AppListParams struct {
	Page *PageParams
}

type AppPagePaginatedResponse struct {
	Data []App         `json:"data"`
	Meta PaginatedMeta `json:"meta"`
}

type AppReference struct {
	// The ID of the app.
	ID string `json:"id"`
}

type AppSandbox struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	// The app type.
	Type AppType `json:"type"`
	// The app catalog definition that this installed app is based on.
	Definition AppCatalogItem `json:"definition"`
	// Status of the app connection.
	Status AppStatus `json:"status"`
}

type AppStatus string

type AppStripe struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	// The app type.
	Type AppType `json:"type"`
	// The app catalog definition that this installed app is based on.
	Definition AppCatalogItem `json:"definition"`
	// Status of the app connection.
	Status AppStatus `json:"status"`
	// The Stripe account ID associated with the connected Stripe account.
	AccountID string `json:"account_id"`
	// Indicates whether the app is connected to a live Stripe account.
	Livemode bool `json:"livemode"`
	// The masked Stripe API key that only exposes the first and last few characters.
	MaskedAPIKey string `json:"masked_api_key"`
}

type AppStripeCheckoutSessionCustomTextParams struct {
	// Text displayed after the payment confirmation button.
	AfterSubmit *AppStripeCheckoutSessionCustomTextParamsAfterSubmit `json:"after_submit,omitempty"`
	// Text displayed alongside shipping address collection.
	ShippingAddress *AppStripeCheckoutSessionCustomTextParamsShippingAddress `json:"shipping_address,omitempty"`
	// Text displayed alongside the payment confirmation button.
	Submit *AppStripeCheckoutSessionCustomTextParamsSubmit `json:"submit,omitempty"`
	// Text replacing the default terms of service agreement text.
	TermsOfServiceAcceptance *AppStripeCheckoutSessionCustomTextParamsTermsOfServiceAcceptance `json:"terms_of_service_acceptance,omitempty"`
}

type AppStripeCheckoutSessionCustomTextParamsAfterSubmit struct {
	// The custom message text (max 1200 characters).
	Message *string `json:"message,omitempty"`
}

type AppStripeCheckoutSessionCustomTextParamsShippingAddress struct {
	// The custom message text (max 1200 characters).
	Message *string `json:"message,omitempty"`
}

type AppStripeCheckoutSessionCustomTextParamsSubmit struct {
	// The custom message text (max 1200 characters).
	Message *string `json:"message,omitempty"`
}

type AppStripeCheckoutSessionCustomTextParamsTermsOfServiceAcceptance struct {
	// The custom message text (max 1200 characters).
	Message *string `json:"message,omitempty"`
}

type AppStripeCheckoutSessionMode string

type AppStripeCheckoutSessionUiMode string

type AppStripeCreateCheckoutSessionBillingAddressCollection string

type AppStripeCreateCheckoutSessionConsentCollection struct {
	// Controls the visibility of payment method reuse agreement.
	PaymentMethodReuseAgreement *AppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement `json:"payment_method_reuse_agreement,omitempty"`
	// 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 *AppStripeCreateCheckoutSessionConsentCollectionPromotions `json:"promotions,omitempty"`
	// Requires customers to accept terms of service before payment.
	//
	// Requires a valid terms of service URL in your Stripe Dashboard settings.
	TermsOfService *AppStripeCreateCheckoutSessionConsentCollectionTermsOfService `json:"terms_of_service,omitempty"`
}

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

type AppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreementPosition string

type AppStripeCreateCheckoutSessionConsentCollectionPromotions string

type AppStripeCreateCheckoutSessionConsentCollectionTermsOfService string

type AppStripeCreateCheckoutSessionCustomerUpdate struct {
	// Whether to save the billing address to customer.address.
	//
	// Defaults to "never".
	Address *AppStripeCreateCheckoutSessionCustomerUpdateBehavior `json:"address,omitempty"`
	// Whether to save the customer name to customer.name.
	//
	// Defaults to "never".
	Name *AppStripeCreateCheckoutSessionCustomerUpdateBehavior `json:"name,omitempty"`
	// Whether to save shipping information to customer.shipping.
	//
	// Defaults to "never".
	Shipping *AppStripeCreateCheckoutSessionCustomerUpdateBehavior `json:"shipping,omitempty"`
}

type AppStripeCreateCheckoutSessionCustomerUpdateBehavior string

type AppStripeCreateCheckoutSessionRedirectOnCompletion string

type AppStripeCreateCheckoutSessionRequestOptions struct {
	// Whether to collect the customer's billing address.
	//
	// Defaults to auto, which only collects the address when necessary for tax
	// calculation.
	BillingAddressCollection *AppStripeCreateCheckoutSessionBillingAddressCollection `json:"billing_address_collection,omitempty"`
	// URL to redirect customers who cancel the checkout session.
	//
	// Not allowed when ui_mode is "embedded".
	CancelURL *string `json:"cancel_url,omitempty"`
	// 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"`
	// Controls which customer fields can be updated by the checkout session.
	CustomerUpdate *AppStripeCreateCheckoutSessionCustomerUpdate `json:"customer_update,omitempty"`
	// Configuration for collecting customer consent during checkout.
	ConsentCollection *AppStripeCreateCheckoutSessionConsentCollection `json:"consent_collection,omitempty"`
	// Three-letter ISO 4217 currency code in uppercase.
	//
	// Required for payment mode sessions. Optional for setup mode sessions.
	Currency *string `json:"currency,omitempty"`
	// Custom text to display during checkout at various stages.
	CustomText *AppStripeCheckoutSessionCustomTextParams `json:"custom_text,omitempty"`
	// 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"`
	// 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"`
	// Set of key-value pairs to attach to the checkout session.
	//
	// Useful for storing additional structured information.
	Metadata *map[string]string `json:"metadata,omitempty"`
	// 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"`
	// 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"`
	// The UI mode for the checkout session.
	//
	// "hosted" displays a Stripe-hosted page. "embedded" integrates directly into your
	// app. Defaults to "hosted".
	UiMode *AppStripeCheckoutSessionUiMode `json:"ui_mode,omitempty"`
	// 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"`
	// 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 *AppStripeCreateCheckoutSessionRedirectOnCompletion `json:"redirect_on_completion,omitempty"`
	// Configuration for collecting tax IDs during checkout.
	TaxIDCollection *AppStripeCreateCheckoutSessionTaxIDCollection `json:"tax_id_collection,omitempty"`
}

type AppStripeCreateCheckoutSessionResult struct {
	// The customer ID in the billing system.
	CustomerID string `json:"customer_id"`
	// The Stripe customer ID.
	StripeCustomerID string `json:"stripe_customer_id"`
	// The Stripe checkout session ID.
	SessionID string `json:"session_id"`
	// The setup intent ID created for collecting the payment method.
	SetupIntentID string `json:"setup_intent_id"`
	// 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"`
	// The client reference ID provided in the request.
	//
	// Useful for reconciling the session with your internal systems.
	ClientReferenceID *string `json:"client_reference_id,omitempty"`
	// Customer's email address if provided to Stripe.
	CustomerEmail *string `json:"customer_email,omitempty"`
	// Currency code for the checkout session.
	Currency *string `json:"currency,omitempty"`
	// Timestamp when the checkout session was created.
	CreatedAt time.Time `json:"created_at"`
	// Timestamp when the checkout session will expire.
	ExpiresAt *time.Time `json:"expires_at,omitempty"`
	// Metadata attached to the checkout session.
	Metadata map[string]string `json:"metadata,omitempty"`
	// The status of the checkout session.
	//
	// See:
	// https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-status
	Status *string `json:"status,omitempty"`
	// URL to redirect customers to the checkout page (for hosted mode).
	URL *string `json:"url,omitempty"`
	// Mode of the checkout session.
	//
	// Currently only "setup" mode is supported for collecting payment methods.
	Mode AppStripeCheckoutSessionMode `json:"mode"`
	// The cancel URL where customers are redirected if they cancel.
	CancelURL *string `json:"cancel_url,omitempty"`
	// The success URL where customers are redirected after completion.
	SuccessURL *string `json:"success_url,omitempty"`
	// The return URL for embedded sessions after authentication.
	ReturnURL *string `json:"return_url,omitempty"`
}

type AppStripeCreateCheckoutSessionTaxIDCollection struct {
	// Enable tax ID collection during checkout.
	//
	// Defaults to false.
	Enabled *bool `json:"enabled,omitempty"`
	// Whether tax ID collection is required.
	//
	// Defaults to "never".
	Required *AppStripeCreateCheckoutSessionTaxIDCollectionRequired `json:"required,omitempty"`
}

type AppStripeCreateCheckoutSessionTaxIDCollectionRequired string

type AppStripeCreateCustomerPortalSessionOptions struct {
	// 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"`
	// 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"`
	// 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 AppStripeCreateCustomerPortalSessionResult struct {
	// 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"`
	// The ID of the stripe customer.
	StripeCustomerID string `json:"stripe_customer_id"`
	// 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"`
	// Livemode.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-livemode
	Livemode bool `json:"livemode"`
	// Created at.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-created
	CreatedAt time.Time `json:"created_at"`
	// Return URL.
	//
	// See:
	// https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-return_url
	ReturnURL string `json:"return_url"`
	// 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"`
	// The URL to redirect the customer to after they have completed their requested
	// actions.
	URL string `json:"url"`
}

type AppType string

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

type BillingCurrencyCode string

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

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

type BillingSubscription struct {
	ID     string            `json:"id"`
	Labels map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	// The customer ID of the subscription.
	CustomerID string `json:"customer_id"`
	// The plan ID of the subscription. Set if subscription is created from a plan.
	PlanID *string `json:"plan_id,omitempty"`
	// 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 time.Time `json:"billing_anchor"`
	// The status of the subscription.
	Status SubscriptionStatus `json:"status"`
	// Settlement mode for billing.
	//
	// Values:
	//
	// - `credit_then_invoice`: Credits are applied first, then any remainder is
	// invoiced.
	// - `credit_only`: Usage is settled exclusively against credits.
	SettlementMode *SettlementMode `json:"settlement_mode,omitempty"`
}

type BillingSubscriptionFilter struct {
	ID         *StringExactFilter
	CustomerID *StringExactFilter
	Status     *StringExactFilter
	PlanID     *StringExactFilter
	PlanKey    *StringExactFilter
}

type BillingSubscriptionListParams struct {
	Page   *PageParams
	Sort   *Sort
	Filter *BillingSubscriptionFilter
}

type BooleanFilter struct {
	Eq *bool
}

type Charge struct {
	Type string `json:"type"`
	// contains filtered or unexported fields
}

type ChargeFilter struct {
	// Filter charges by status.
	//
	// Supported statuses are:
	//
	// - `created`
	// - `active`
	// - `final`
	// - `deleted`
	//
	// If omitted, all statuses are returned except for `deleted`.
	Status *StringExactFilter
}

type ChargeFlatFee struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	// The type of the charge.
	Type ChargeType `json:"type"`
	// The customer owning the charge.
	Customer BillingCustomerReference `json:"customer"`
	// Indicates whether the charge lifecycle is controlled by OpenMeter or manually
	// overridden by the API user.
	LifecycleController LifecycleController `json:"lifecycle_controller"`
	// The subscription that originated the charge, when the charge was created from a
	// subscription item.
	Subscription *SubscriptionReference `json:"subscription,omitempty"`
	// The currency of the charge.
	Currency string `json:"currency"`
	// The lifecycle status of the charge.
	Status ChargeStatus `json:"status"`
	// The timestamp when the charge is intended to be invoiced.
	InvoiceAt time.Time `json:"invoice_at"`
	// The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`
	// The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`
	// The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`
	// The earliest time when the charge should be advanced again by background
	// processing.
	AdvanceAfter *time.Time `json:"advance_after,omitempty"`
	// Unique reference ID of the charge.
	UniqueReferenceID *string `json:"unique_reference_id,omitempty"`
	// Settlement mode of the charge.
	SettlementMode SettlementMode `json:"settlement_mode"`
	// Tax configuration of the charge.
	TaxConfig *TaxConfig `json:"tax_config,omitempty"`
	// Payment term of the flat fee charge.
	PaymentTerm PricePaymentTerm `json:"payment_term"`
	// The discounts applied to the charge.
	Discounts *ChargeFlatFeeDiscounts `json:"discounts,omitempty"`
	// The feature associated with the charge, when applicable.
	FeatureKey *string `json:"feature_key,omitempty"`
	// The proration configuration of the charge.
	ProrationConfiguration RateCardProrationConfiguration `json:"proration_configuration"`
	// The amount after proration of the charge.
	AmountAfterProration CurrencyAmount `json:"amount_after_proration"`
	// The price of the charge.
	Price Price `json:"price"`
	// Current intent from the system lifecycle controller for a charge that has an
	// active manual override. The top-level charge fields remain the effective
	// customer-facing intent.
	SystemIntent *ChargeFlatFeeSystemIntent `json:"system_intent,omitempty"`
}

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

type ChargeFlatFeeSystemIntent struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// The timestamp when the charge is intended to be invoiced.
	InvoiceAt time.Time `json:"invoice_at"`
	// The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`
	// The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`
	// The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`
	// Payment term of the flat fee charge.
	PaymentTerm PricePaymentTerm `json:"payment_term"`
	// The discounts applied to the charge.
	Discounts *ChargeFlatFeeDiscounts `json:"discounts,omitempty"`
	// The proration configuration of the charge.
	ProrationConfiguration RateCardProrationConfiguration `json:"proration_configuration"`
	// The amount before proration of the system lifecycle controller flat fee intent.
	AmountBeforeProration CurrencyAmount `json:"amount_before_proration"`
	// The timestamp when the system lifecycle controller intent was deleted. The
	// effective charge can remain visible while a manual override is active.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
}

type ChargeListParams struct {
	Page   *PageParams
	Sort   *Sort
	Filter *ChargeFilter
	Expand []ChargesExpand
}

type ChargePagePaginatedResponse struct {
	Data []Charge      `json:"data"`
	Meta PaginatedMeta `json:"meta"`
}

type ChargeReference struct {
	// Unique identifier for the charge.
	ID string `json:"id"`
}

type ChargeStatus string

type ChargeTotals struct {
	// The amount of the charge already booked to the internal accounting system.
	Booked Totals `json:"booked"`
	// The realtime amount of the charge.
	//
	// Requires the `realtime_usage` expand.
	Realtime *Totals `json:"realtime,omitempty"`
}

type ChargeType string

type ChargeUsageBased struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	// The type of the charge.
	Type ChargeType `json:"type"`
	// The customer owning the charge.
	Customer BillingCustomerReference `json:"customer"`
	// Indicates whether the charge lifecycle is controlled by OpenMeter or manually
	// overridden by the API user.
	LifecycleController LifecycleController `json:"lifecycle_controller"`
	// The subscription that originated the charge, when the charge was created from a
	// subscription item.
	Subscription *SubscriptionReference `json:"subscription,omitempty"`
	// The currency of the charge.
	Currency string `json:"currency"`
	// The lifecycle status of the charge.
	Status ChargeStatus `json:"status"`
	// The timestamp when the charge is intended to be invoiced.
	InvoiceAt time.Time `json:"invoice_at"`
	// The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`
	// The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`
	// The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`
	// The earliest time when the charge should be advanced again by background
	// processing.
	AdvanceAfter *time.Time `json:"advance_after,omitempty"`
	// Unique reference ID of the charge.
	UniqueReferenceID *string `json:"unique_reference_id,omitempty"`
	// Settlement mode of the charge.
	SettlementMode SettlementMode `json:"settlement_mode"`
	// Tax configuration of the charge.
	TaxConfig *TaxConfig `json:"tax_config,omitempty"`
	// Discounts applied to the usage-based charge.
	Discounts *RateCardDiscounts `json:"discounts,omitempty"`
	// The feature associated with the charge.
	FeatureKey string `json:"feature_key"`
	// Aggregated booked and realtime totals for the charge.
	Totals ChargeTotals `json:"totals"`
	// The price of the charge.
	Price Price `json:"price"`
	// Current intent from the system lifecycle controller for a charge that has an
	// active manual override. The top-level charge fields remain the effective
	// customer-facing intent.
	SystemIntent *ChargeUsageBasedSystemIntent `json:"system_intent,omitempty"`
}

type ChargeUsageBasedSystemIntent struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// The timestamp when the charge is intended to be invoiced.
	InvoiceAt time.Time `json:"invoice_at"`
	// The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`
	// The full, unprorated service period of the charge.
	FullServicePeriod ClosedPeriod `json:"full_service_period"`
	// The billing period the charge belongs to.
	BillingPeriod ClosedPeriod `json:"billing_period"`
	// Discounts applied to the usage-based charge.
	Discounts *RateCardDiscounts `json:"discounts,omitempty"`
	// The price of the charge.
	Price Price `json:"price"`
	// The timestamp when the system lifecycle controller intent was deleted. The
	// effective charge can remain visible while a manual override is active.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
}

type ChargesExpand string

type Client struct {
	Events        *EventsService
	Meters        *MetersService
	Customers     *CustomersService
	Entitlements  *EntitlementsService
	Subscriptions *SubscriptionsService
	Apps          *AppsService
	Billing       *BillingService
	Invoices      *InvoicesService
	Tax           *TaxService
	Currencies    *CurrenciesService
	Features      *FeaturesService
	LLMCost       *LLMCostService
	Plans         *PlansService
	Addons        *AddonsService
	PlanAddons    *PlanAddonsService
	Defaults      *DefaultsService
	Governance    *GovernanceService
	// contains filtered or unexported fields
}

type ClosedPeriod struct {
	// The start of the period.
	//
	// The period is inclusive at the start.
	From time.Time `json:"from"`
	// The end of the period.
	//
	// The period is exclusive at the end.
	To time.Time `json:"to"`
}

type CollectionAlignment string

type CollectionMethod string

type CostBasis struct {
	ID string `json:"id"`
	// The fiat currency code for the cost basis.
	FiatCode string `json:"fiat_code"`
	// The cost rate for the currency.
	Rate Numeric `json:"rate"`
	// 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 *time.Time `json:"effective_from,omitempty"`
	// An ISO-8601 timestamp representation of the date until which the cost basis is
	// effective. If provided, it must be later than `effective_from`. If not provided,
	// it remains effective until superseded.
	EffectiveTo *time.Time `json:"effective_to,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
}

type CostBasisFilter struct {
	// Filter cost bases by fiat currency code.
	FiatCode *string
}

type CostBasisListParams struct {
	Filter *CostBasisFilter
	Page   *PageParams
}

type CostBasisPagePaginatedResponse struct {
	Data []CostBasis   `json:"data"`
	Meta PaginatedMeta `json:"meta"`
}

type CreateAddonRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	// 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 string `json:"key"`
	// The InstanceType of the add-ons. Can be "single" or "multiple".
	InstanceType AddonInstanceType `json:"instance_type"`
	// The currency code of the add-on.
	Currency BillingCurrencyCode `json:"currency"`
	// The rate cards of the add-on.
	RateCards []RateCardInput `json:"rate_cards"`
}

type CreateBillingProfileRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	// The name and contact information for the supplier this billing profile
	// represents
	Supplier Party `json:"supplier"`
	// The billing workflow settings for this profile
	Workflow Workflow `json:"workflow"`
	// The applications used by this billing profile.
	Apps ProfileAppReferences `json:"apps"`
	// Whether this is the default profile.
	Default bool `json:"default"`
}

type CreateChargeFlatFeeRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	// The type of the charge.
	Type ChargeType `json:"type"`
	// The currency of the charge.
	Currency string `json:"currency"`
	// The timestamp when the charge is intended to be invoiced.
	InvoiceAt time.Time `json:"invoice_at"`
	// The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`
	// Unique reference ID of the charge.
	UniqueReferenceID *string `json:"unique_reference_id,omitempty"`
	// Settlement mode of the charge.
	SettlementMode SettlementMode `json:"settlement_mode"`
	// Tax configuration of the charge.
	TaxConfig *TaxConfig `json:"tax_config,omitempty"`
	// Payment term of the flat fee charge.
	PaymentTerm PricePaymentTerm `json:"payment_term"`
	// The discounts applied to the charge.
	Discounts *ChargeFlatFeeDiscounts `json:"discounts,omitempty"`
	// The feature associated with the charge, when applicable.
	FeatureKey *string `json:"feature_key,omitempty"`
	// The proration configuration of the charge.
	ProrationConfiguration RateCardProrationConfiguration `json:"proration_configuration"`
	// The amount before proration of the charge.
	AmountBeforeProration CurrencyAmount `json:"amount_before_proration"`
	// The full, unprorated service period of the charge.
	FullServicePeriod *ClosedPeriod `json:"full_service_period,omitempty"`
	// The billing period the charge belongs to.
	BillingPeriod *ClosedPeriod `json:"billing_period,omitempty"`
}

type CreateChargeRequest struct {
	Type string `json:"type"`
	// contains filtered or unexported fields
}

type CreateChargeUsageBasedRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	// The type of the charge.
	Type ChargeType `json:"type"`
	// The currency of the charge.
	Currency string `json:"currency"`
	// The timestamp when the charge is intended to be invoiced.
	InvoiceAt time.Time `json:"invoice_at"`
	// The effective service period covered by the charge.
	ServicePeriod ClosedPeriod `json:"service_period"`
	// Unique reference ID of the charge.
	UniqueReferenceID *string `json:"unique_reference_id,omitempty"`
	// Settlement mode of the charge.
	SettlementMode SettlementMode `json:"settlement_mode"`
	// Tax configuration of the charge.
	TaxConfig *TaxConfig `json:"tax_config,omitempty"`
	// Discounts applied to the usage-based charge.
	Discounts *RateCardDiscounts `json:"discounts,omitempty"`
	// The feature associated with the charge.
	FeatureKey string `json:"feature_key"`
	// The price of the charge.
	Price Price `json:"price"`
	// The full, unprorated service period of the charge.
	FullServicePeriod *ClosedPeriod `json:"full_service_period,omitempty"`
	// The billing period the charge belongs to.
	BillingPeriod *ClosedPeriod `json:"billing_period,omitempty"`
}

type CreateCostBasisRequest struct {
	// The fiat currency code for the cost basis.
	FiatCode string `json:"fiat_code"`
	// The cost rate for the currency.
	Rate Numeric `json:"rate"`
	// 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 *time.Time `json:"effective_from,omitempty"`
	// An ISO-8601 timestamp representation of the date until which the cost basis is
	// effective. If provided, it must be later than `effective_from`. If not provided,
	// it remains effective until superseded.
	EffectiveTo *time.Time `json:"effective_to,omitempty"`
}

type CreateCreditAdjustmentRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	// The currency of the granted credits.
	Currency BillingCurrencyCode `json:"currency"`
	// Granted credit amount.
	Amount Numeric `json:"amount"`
}

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

type CreateCreditGrantPurchase struct {
	// Currency of the purchase amount.
	Currency string `json:"currency"`
	// 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"`
	// Controls when credits become available for consumption.
	//
	// Defaults to `on_creation`.
	AvailabilityPolicy *CreditAvailabilityPolicy `json:"availability_policy,omitempty"`
}

type CreateCreditGrantRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	// Funding method of the grant.
	FundingMethod CreditFundingMethod `json:"funding_method"`
	// The currency of the granted credits.
	Currency BillingCurrencyCode `json:"currency"`
	// Granted credit amount.
	Amount Numeric `json:"amount"`
	// Present when a funding workflow applies (funding_method is not `none`).
	Purchase *CreateCreditGrantPurchase `json:"purchase,omitempty"`
	// 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 *CreditGrantTaxConfig     `json:"tax_config,omitempty"`
	Filters   *CreateCreditGrantFilters `json:"filters,omitempty"`
	// Draw-down priority of the grant. Lower values have higher priority.
	Priority *int16 `json:"priority,omitempty"`
	// The timestamp when the credit grant becomes effective.
	//
	// Defaults to the current date and time.
	EffectiveAt *time.Time `json:"effective_at,omitempty"`
	// The duration after which the credit grant expires.
	//
	// Defaults to never expiring.
	ExpiresAfter *string `json:"expires_after,omitempty"`
	// Idempotency key for the credit grant creation request.
	//
	// When provided, reusing the same key returns an HTTP 409 Conflict instead of
	// creating a duplicate grant, which makes create requests safe to retry.
	Key *string `json:"key,omitempty"`
}

type CreateCurrencyCustomRequest struct {
	// 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"`
	// 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"`
	Code   string  `json:"code"`
}

type CreateCustomerRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	Key         string             `json:"key"`
	// Mapping to attribute metered usage to the customer by the event subject.
	UsageAttribution *CustomerUsageAttribution `json:"usage_attribution,omitempty"`
	// The primary email address of the customer.
	PrimaryEmail *string `json:"primary_email,omitempty"`
	// Currency of the customer. Used for billing, tax and invoicing.
	Currency *string `json:"currency,omitempty"`
	// The billing address of the customer. Used for tax and invoicing.
	BillingAddress *Address `json:"billing_address,omitempty"`
}

type CreateFeatureRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	Key         string             `json:"key"`
	// The meter that the feature is associated with and based on which usage is
	// calculated. If not specified, the feature is static.
	Meter *FeatureMeterReferenceInput `json:"meter,omitempty"`
	// 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 *FeatureUnitCost `json:"unit_cost,omitempty"`
}

type CreateMeterRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	Key         string             `json:"key"`
	// The aggregation type to use for the meter.
	Aggregation MeterAggregation `json:"aggregation"`
	// The event type to include in the aggregation.
	EventType string `json:"event_type"`
	// The date since the meter should include events. Useful to skip old events. If
	// not specified, all historical events are included.
	EventsFrom *time.Time `json:"events_from,omitempty"`
	// 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"`
	// 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"`
}

type CreatePlanAddonRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	// The add-on associated with the plan.
	Addon AddonReference `json:"addon"`
	// The key of the plan phase from which the add-on becomes available for purchase.
	FromPlanPhase string `json:"from_plan_phase"`
	// 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 *int64 `json:"max_quantity,omitempty"`
}

type CreatePlanRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	// 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 string `json:"key"`
	// The currency code of the plan.
	Currency string `json:"currency"`
	// The billing cadence for subscriptions using this plan.
	BillingCadence string `json:"billing_cadence"`
	// Whether pro-rating is enabled for this plan.
	ProRatingEnabled *bool `json:"pro_rating_enabled,omitempty"`
	// 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 []PlanPhaseInput `json:"phases"`
}

type CreateSubscriptionAddonRequest struct {
	Labels *map[string]string `json:"labels,omitempty"`
	// The add-on associated with the subscription.
	Addon AddonReference `json:"addon"`
	// The quantity of the add-on. Always 1 for single instance add-ons.
	Quantity int64 `json:"quantity"`
	// The timing of the operation. After the create or update, a new entry will be
	// created in the timeline.
	Timing SubscriptionEditTiming `json:"timing"`
}

type CreateTaxCodeRequest struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string            `json:"description,omitempty"`
	Labels      *map[string]string `json:"labels,omitempty"`
	Key         string             `json:"key"`
	// Mapping of app types to tax codes.
	AppMappings []TaxCodeAppMapping `json:"app_mappings"`
}

type CreditAdjustment struct {
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
}

type CreditAvailabilityPolicy string

type CreditBalance struct {
	Currency BillingCurrencyCode `json:"currency"`
	// Credits available after applying currently live charge impacts.
	Live Numeric `json:"live"`
	// Credits that have been booked on the ledger as of the balance timestamp.
	Settled Numeric `json:"settled"`
	// Credits that have been granted but are not yet written to the ledger, or are
	// written to the ledger with a future booked time.
	Pending Numeric `json:"pending"`
}

type CreditBalances struct {
	// The timestamp of the balance retrieval.
	RetrievedAt time.Time `json:"retrieved_at"`
	// The balances by currencies.
	Balances []CreditBalance `json:"balances"`
}

type CreditFundingMethod string

type CreditGrant struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	// Funding method of the grant.
	FundingMethod CreditFundingMethod `json:"funding_method"`
	// The currency of the granted credits.
	Currency BillingCurrencyCode `json:"currency"`
	// Granted credit amount.
	Amount Numeric `json:"amount"`
	// Present when a funding workflow applies (funding_method is not `none`).
	Purchase *CreditGrantPurchase `json:"purchase,omitempty"`
	// 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 *CreditGrantTaxConfig `json:"tax_config,omitempty"`
	// Available when `funding_method` is `invoice`.
	Invoice *CreditGrantInvoiceReference `json:"invoice,omitempty"`
	Filters *CreditGrantFilters          `json:"filters,omitempty"`
	// Draw-down priority of the grant. Lower values have higher priority.
	Priority *int16 `json:"priority,omitempty"`
	// The timestamp when the credit grant becomes effective.
	//
	// Defaults to the current date and time.
	EffectiveAt *time.Time `json:"effective_at,omitempty"`
	// Idempotency key for the credit grant creation request.
	//
	// When provided, reusing the same key returns an HTTP 409 Conflict instead of
	// creating a duplicate grant, which makes create requests safe to retry.
	Key *string `json:"key,omitempty"`
	// The timestamp when the credit grant expires.
	//
	// Calculated from the grant effective time and `expires_after` if provided.
	ExpiresAt *time.Time `json:"expires_at,omitempty"`
	// Timestamp when the grant was voided.
	VoidedAt *time.Time `json:"voided_at,omitempty"`
	// Current lifecycle status of the grant.
	Status CreditGrantStatus `json:"status"`
}

type CreditGrantFilter struct {
	// Filter credit grants by status.
	Status *CreditGrantStatus
	// Filter credit grants by currency.
	Currency *string
	// Filter credit grants by key.
	Key *StringFilter
}

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

type CreditGrantInvoiceReference struct {
	// Identifier of the invoice associated with the grant.
	ID *string `json:"id,omitempty"`
	// Identifier of the invoice line associated with the grant.
	Line *CreditGrantInvoiceReferenceLine `json:"line,omitempty"`
}

type CreditGrantInvoiceReferenceLine struct {
	ID string `json:"id"`
}

type CreditGrantListParams struct {
	Page   *PageParams
	Filter *CreditGrantFilter
}

type CreditGrantPagePaginatedResponse struct {
	Data []CreditGrant `json:"data"`
	Meta PaginatedMeta `json:"meta"`
}

type CreditGrantPurchase struct {
	// Currency of the purchase amount.
	Currency string `json:"currency"`
	// 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"`
	// The purchase amount. Calculated from `per_unit_cost_basis` and credit `amount`.
	Amount Numeric `json:"amount"`
	// Controls when credits become available for consumption.
	//
	// Defaults to `on_creation`.
	AvailabilityPolicy *CreditAvailabilityPolicy `json:"availability_policy,omitempty"`
	// Current payment settlement status.
	SettlementStatus *CreditPurchasePaymentSettlementStatus `json:"settlement_status,omitempty"`
}

type CreditGrantStatus string

type CreditGrantTaxConfig struct {
	// Tax behavior applied to the invoice line item.
	Behavior *TaxBehavior `json:"behavior,omitempty"`
	// Tax code applied to the invoice line item.
	TaxCode *TaxCodeReference `json:"tax_code,omitempty"`
}

type CreditPurchasePaymentSettlementStatus string

type CreditTransaction struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// The date and time the transaction was booked.
	BookedAt time.Time `json:"booked_at"`
	// The type of credit transaction.
	Type CreditTransactionType `json:"type"`
	// Currency of the balance affected by the transaction.
	Currency BillingCurrencyCode `json:"currency"`
	// Signed amount of the credit movement. Positive values add balance, negative
	// values reduce balance.
	Amount Numeric `json:"amount"`
	// The available balance before and after the transaction.
	AvailableBalance CreditTransactionAvailableBalance `json:"available_balance"`
}

type CreditTransactionAvailableBalance struct {
	Before Numeric `json:"before"`
	After  Numeric `json:"after"`
}

type CreditTransactionFilter struct {
	// Filter credit transactions by type.
	Type *CreditTransactionType
	// Filter credit transactions by currency.
	Currency *BillingCurrencyCode
	// Filter credit transactions by feature key. Omit to return all credit
	// transactions. Use `exists=false` to return only unrestricted credit
	// transactions.
	FeatureKey *StringFilter
}

type CreditTransactionListParams struct {
	Page   *CursorPageParams
	Filter *CreditTransactionFilter
}

type CreditTransactionPaginatedResponse struct {
	Data []CreditTransaction `json:"data"`
	Meta CursorMeta          `json:"meta"`
}

type CreditTransactionType string

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

type Currency struct {
	Type string `json:"type"`
	// contains filtered or unexported fields
}

type CurrencyAmount struct {
	Amount   Numeric `json:"amount"`
	Currency string  `json:"currency"`
}

type CurrencyCustom struct {
	// The type of the currency.
	Type CurrencyType `json:"type"`
	// 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"`
	// 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"`
	ID     string  `json:"id"`
	Code   string  `json:"code"`
	// An ISO-8601 timestamp representation of the custom currency creation date.
	CreatedAt time.Time `json:"created_at"`
}

type CurrencyFiat struct {
	// The type of the currency.
	Type CurrencyType `json:"type"`
	// 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"`
	// 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"`
	Code   string  `json:"code"`
}

type CurrencyFilter struct {
	Type *CurrencyType
	Code *StringFilter
}

type CurrencyListParams struct {
	Page   *PageParams
	Sort   *Sort
	Filter *CurrencyFilter
}

type CurrencyPagePaginatedResponse struct {
	Data []Currency    `json:"data"`
	Meta PaginatedMeta `json:"meta"`
}

type CurrencyType string

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

type CursorMetaPage struct {
	// URI to the first page.
	First *string `json:"first,omitempty"`
	// URI to the last page.
	Last *string `json:"last,omitempty"`
	// URI to the next page.
	Next *string `json:"next,omitempty"`
	// URI to the previous page.
	Previous *string `json:"previous,omitempty"`
	// Requested page size.
	Size *int64 `json:"size,omitempty"`
}

type CursorPageParams struct {
	Size   *int
	After  *string
	Before *string
}

type CursorPaginationQueryPage struct {
	// The number of items to include per page.
	Size *int64 `json:"size,omitempty"`
	// Request the next page of data, starting with the item after this parameter.
	After *string `json:"after,omitempty"`
	// Request the previous page of data, starting with the item before this parameter.
	Before *string `json:"before,omitempty"`
}

type Customer struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	Key       string     `json:"key"`
	// Mapping to attribute metered usage to the customer by the event subject.
	UsageAttribution *CustomerUsageAttribution `json:"usage_attribution,omitempty"`
	// The primary email address of the customer.
	PrimaryEmail *string `json:"primary_email,omitempty"`
	// Currency of the customer. Used for billing, tax and invoicing.
	Currency *string `json:"currency,omitempty"`
	// The billing address of the customer. Used for tax and invoicing.
	BillingAddress *Address `json:"billing_address,omitempty"`
}

type CustomerData struct {
	// The billing profile for the customer.
	//
	// If not provided, the default billing profile will be used.
	BillingProfile *ProfileReference `json:"billing_profile,omitempty"`
	// App customer data.
	AppData *AppCustomerData `json:"app_data,omitempty"`
}

type CustomerFilter struct {
	Key                        *StringFilter
	Name                       *StringFilter
	PrimaryEmail               *StringFilter
	UsageAttributionSubjectKey *StringFilter
	PlanKey                    *StringFilter
	BillingProfileID           *StringExactFilter
}

type CustomerListParams struct {
	Page   *PageParams
	Sort   *Sort
	Filter *CustomerFilter
}

type CustomerPagePaginatedResponse struct {
	Data []Customer    `json:"data"`
	Meta PaginatedMeta `json:"meta"`
}

type CustomerReference struct {
	ID string `json:"id"`
}

type CustomerStripeCreateCheckoutSessionRequest struct {
	// 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 AppStripeCreateCheckoutSessionRequestOptions `json:"stripe_options"`
}

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

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

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

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

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

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

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

type CustomersCreditsService struct {
	Grants       *CustomersCreditsGrantsService
	Balance      *CustomersCreditsBalanceService
	Adjustments  *CustomersCreditsAdjustmentsService
	Transactions *CustomersCreditsTransactionsService
	// contains filtered or unexported fields
}

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

type CustomersService struct {
	Billing *CustomersBillingService
	Credits *CustomersCreditsService
	Charges *CustomersChargesService
	// contains filtered or unexported fields
}

type DateTimeFilter struct {
	Eq  *time.Time
	Gt  *time.Time
	Gte *time.Time
	Lt  *time.Time
	Lte *time.Time
}

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

type EntitlementAccessResult struct {
	// The type of the entitlement.
	Type EntitlementType `json:"type"`
	// The feature key of the entitlement.
	FeatureKey string `json:"feature_key"`
	// 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"`
	// 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"`
}

type EntitlementType string

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

type Event struct {
	// Identifies the event.
	ID string `json:"id"`
	// Identifies the context in which an event happened.
	Source string `json:"source"`
	// The version of the CloudEvents specification which the event uses.
	Specversion string `json:"specversion"`
	// Contains a value describing the type of event related to the originating
	// occurrence.
	Type string `json:"type"`
	// Content type of the CloudEvents data value. Only the value "application/json" is
	// allowed over HTTP.
	Datacontenttype Nullable[string] `json:"datacontenttype,omitempty"`
	// Identifies the schema that data adheres to.
	Dataschema Nullable[string] `json:"dataschema,omitempty"`
	// Describes the subject of the event in the context of the event producer
	// (identified by source).
	Subject string `json:"subject"`
	// Timestamp of when the occurrence happened. Must adhere to RFC 3339.
	Time Nullable[time.Time] `json:"time,omitempty"`
	// The event payload. Optional, if present it must be a JSON object.
	Data Nullable[map[string]any] `json:"data,omitempty"`
}

type EventInput struct {
	// Identifies the event.
	ID string `json:"id"`
	// Identifies the context in which an event happened.
	Source string `json:"source"`
	// The version of the CloudEvents specification which the event uses.
	Specversion *string `json:"specversion,omitempty"`
	// Contains a value describing the type of event related to the originating
	// occurrence.
	Type string `json:"type"`
	// Content type of the CloudEvents data value. Only the value "application/json" is
	// allowed over HTTP.
	Datacontenttype Nullable[string] `json:"datacontenttype,omitempty"`
	// Identifies the schema that data adheres to.
	Dataschema Nullable[string] `json:"dataschema,omitempty"`
	// Describes the subject of the event in the context of the event producer
	// (identified by source).
	Subject string `json:"subject"`
	// Timestamp of when the occurrence happened. Must adhere to RFC 3339.
	Time Nullable[time.Time] `json:"time,omitempty"`
	// The event payload. Optional, if present it must be a JSON object.
	Data Nullable[map[string]any] `json:"data,omitempty"`
}

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

type Feature struct {
	ID string `json:"id"`
	// Display name of the resource.
	//
	// Between 1 and 256 characters.
	Name string `json:"name"`
	// Optional description of the resource.
	//
	// Maximum 1024 characters.
	Description *string           `json:"description,omitempty"`
	Labels      map[string]string `json:"labels,omitempty"`
	// An ISO-8601 timestamp representation of entity creation date.
	CreatedAt time.Time `json:"created_at"`
	// An ISO-8601 timestamp representation of entity last update date.
	UpdatedAt time.Time `json:"updated_at"`
	// An ISO-8601 timestamp representation of entity deletion date.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`
	Key       string     `json:"key"`
	// 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"`
	// 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 *FeatureUnitCost `json:"unit_cost,omitempty"`
}

type FeatureCostQueryResult struct {
	// Start of the queried period.
	From *time.Time `json:"from,omitempty"`
	// End of the queried period.
	To *time.Time `json:"to,omitempty"`
	// The cost data rows.
	Data []FeatureCostQueryRow `json:"data"`
}

type FeatureCostQueryRow struct {
	// The metered usage value for the period.
	Usage Numeric `json:"usage"`
	// The computed cost amount (usage × unit cost). Null when pricing is not available
	// for the given combination of dimensions.
	Cost Nullable[Numeric] `json:"cost"`
	// The currency code of the cost amount.
	Currency string `json:"currency"`
	// Detail message when cost amount is null, explaining why the cost could not be
	// resolved.
	Detail *string `json:"detail,omitempty"`
	// The start of the time bucket the value is aggregated over.
	From time.Time `json:"from"`
	// The end of the time bucket the value is aggregated over.
	To time.Time `json:"to"`
	// The dimensions the value is aggregated over. `subject` and `customer_id` are
	// reserved dimensions.
	Dimensions map[string]string `json:"dimensions"`
}

type FeatureFilter struct {
	MeterID *StringExactFilter
	Key     *StringFilter
	Name    *StringFilter
}

type FeatureLLMTokenType string

type FeatureLLMUnitCost struct {
	// The type discriminator for LLM unit cost.
	Type FeatureUnitCostType `json:"type"`
	// 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"`
	// 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"`
	// 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"`
	// 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"`
	// 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"`
	// 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 *FeatureLLMTokenType `json:"token_type,omitempty"`
	// 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 *FeatureLLMUnitCostPricing `json:"pricing,omitempty"`
}

type FeatureLLMUnitCostPricing struct {
	// Cost per input token in USD.
	InputPerToken Numeric `json:"input_per_token"`
	// Cost per output token in USD.
	OutputPerToken Numeric `json:"output_per_token"`
	// Cost per cache read token in USD.
	CacheReadPerToken *Numeric `json:"cache_read_per_token,omitempty"`
	// Cost per reasoning token in USD.
	ReasoningPerToken *Numeric `json:"reasoning_per_token,omitempty"`
	// Cost per cache write token in USD.
	CacheWritePerToken *Numeric `json:"cache_write_per_token,omitempty"`
}

type FeatureListParams struct {
	Page   *PageParams
	Sort   *Sort
	Filter *FeatureFilter
}

type FeatureManualUnitCost struct {
	// The type discriminator for manual unit cost.
	Type FeatureUnitCostType `json:"type"`
	// Fixed per-unit cost amount in USD.
	Amount Numeric `json:"amount"`
}

type FeatureMeterReference struct {
	// The ID of the meter to associate with this feature.
	ID string `json:"id"`
	// Filters to apply to the dimensions of the meter.
	Filters map[string]QueryFilterStringMapItem `json:"filters,omitempty"`
}

type FeatureMeterReferenceInput struct {
	// The ID of the meter to associate with this feature.
	ID string `json:"id"`
	// Filters to apply to the dimensions of the meter.
	Filters *map[string]QueryFilterStringMapItemInput `json:"filters,omitempty"`
}

type FeaturePagePaginatedResponse struct {
	Data []Feature     `json:"data"`
	Meta PaginatedMeta `json:"meta"`
}

type FeatureReference struct {
	ID string `json:"id"`
}

type FeatureUnitCost struct {
	Type string `json:"type"`
	// contains filtered or unexported fields
}