orb-billing 1.48.0 → 1.49.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a525b92a1a6f29957b2cb25a56d07bffb8e69a009852a1f2ca72132a2e2f531
-  data.tar.gz: 429829175519be27c097d4d1cc1079eb358bf57038303228085e85c9ddda4242
+  metadata.gz: a9de5e66a507e201cfc16aabb8c3b05315d34c90cc18ea4ddd4ec5af2f20397d
+  data.tar.gz: 9ce23da33a1d9052453b788b969f4bd7759cbf336d89bd48737313375870ebce
 SHA512:
-  metadata.gz: e89d1b03c858c4f8971a925951a800ccba1c58b072f791db95c732b216e8b507b7e9ced541a96c4a6be656c6f1f2ba9237b63a7c697fe8c67cd7757d9bc74a33
-  data.tar.gz: 5fcd2c53b737a529881de5d8391224ac614d71592c3e73a0857f56e7e9043996243155ddce23da4efe6b2e91c9fc2682b1267d055169b9eb75f92bf2cb13969c
+  metadata.gz: 56b985ac015716ca1d328c60cc1d5659dd6f5ea69052bc541aa7a6258d0ad5f5ed685b46dd2b2a9e837d4efb8ea709426ca9773113e1205fa34deb4d383b0611
+  data.tar.gz: ac6d59ad41d20c3878c9531ff2ff899da372cb44a5ce349eea3bbd8ec01144fd199049c5ed31fd309aa2190ed9acdad252cadf0fbf8c892aa6f6e4c1e1e8cb79

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.49.0](https://github.com/orbcorp/orb-ruby/compare/v1.48.0...v1.49.0) (2026-10-27)
+
+
+### Features
+
+* **api:** allow up to 50 spend_exceeded alerts per plan or subscription ([0448a00](https://github.com/orbcorp/orb-ruby/commit/0448a002cbad582b428b77b530b62460e6f96274))
+
 ## [1.48.0](https://github.com/orbcorp/orb-ruby/compare/v1.47.0...v1.48.0) (2026-10-24)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "orb-billing", "~> 1.48.0"
+gem "orb-billing", "~> 1.49.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/orb/models/subscription_list_summary_params.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+module Orb
+  module Models
+    # @see Orb::Resources::Subscriptions#list_summary
+    class SubscriptionListSummaryParams < Orb::Internal::Type::BaseModel
+      extend Orb::Internal::Type::RequestParameters::Converter
+      include Orb::Internal::Type::RequestParameters
+
+      # @!attribute created_at_gt
+      #
+      #   @return [Time, nil]
+      optional :created_at_gt, Time, nil?: true
+
+      # @!attribute created_at_gte
+      #
+      #   @return [Time, nil]
+      optional :created_at_gte, Time, nil?: true
+
+      # @!attribute created_at_lt
+      #
+      #   @return [Time, nil]
+      optional :created_at_lt, Time, nil?: true
+
+      # @!attribute created_at_lte
+      #
+      #   @return [Time, nil]
+      optional :created_at_lte, Time, nil?: true
+
+      # @!attribute cursor
+      #   Cursor for pagination. This can be populated by the `next_cursor` value returned
+      #   from the initial request.
+      #
+      #   @return [String, nil]
+      optional :cursor, String, nil?: true
+
+      # @!attribute customer_id
+      #
+      #   @return [String, nil]
+      optional :customer_id, String, nil?: true
+
+      # @!attribute external_customer_id
+      #
+      #   @return [String, nil]
+      optional :external_customer_id, String, nil?: true
+
+      # @!attribute external_plan_id
+      #
+      #   @return [String, nil]
+      optional :external_plan_id, String, nil?: true
+
+      # @!attribute limit
+      #   The number of items to fetch. Defaults to 20.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute plan_id
+      #
+      #   @return [String, nil]
+      optional :plan_id, String, nil?: true
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Orb::Models::SubscriptionListSummaryParams::Status, nil]
+      optional :status, enum: -> { Orb::SubscriptionListSummaryParams::Status }, nil?: true
+
+      # @!method initialize(created_at_gt: nil, created_at_gte: nil, created_at_lt: nil, created_at_lte: nil, cursor: nil, customer_id: nil, external_customer_id: nil, external_plan_id: nil, limit: nil, plan_id: nil, status: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Orb::Models::SubscriptionListSummaryParams} for more details.
+      #
+      #   @param created_at_gt [Time, nil]
+      #
+      #   @param created_at_gte [Time, nil]
+      #
+      #   @param created_at_lt [Time, nil]
+      #
+      #   @param created_at_lte [Time, nil]
+      #
+      #   @param cursor [String, nil] Cursor for pagination. This can be populated by the `next_cursor` value returned
+      #
+      #   @param customer_id [String, nil]
+      #
+      #   @param external_customer_id [String, nil]
+      #
+      #   @param external_plan_id [String, nil]
+      #
+      #   @param limit [Integer] The number of items to fetch. Defaults to 20.
+      #
+      #   @param plan_id [String, nil]
+      #
+      #   @param status [Symbol, Orb::Models::SubscriptionListSummaryParams::Status, nil]
+      #
+      #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
+
+      module Status
+        extend Orb::Internal::Type::Enum
+
+        ACTIVE = :active
+        ENDED = :ended
+        UPCOMING = :upcoming
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/orb/models/subscription_list_summary_response.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+module Orb
+  module Models
+    # @see Orb::Resources::Subscriptions#list_summary
+    class SubscriptionListSummaryResponse < Orb::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute customer
+      #
+      #   @return [Orb::Models::CustomerMinified]
+      required :customer, -> { Orb::CustomerMinified }
+
+      # @!attribute end_date
+      #   The date Orb stops billing for this subscription.
+      #
+      #   @return [Time, nil]
+      required :end_date, Time, nil?: true
+
+      # @!attribute metadata
+      #   User specified key-value pairs for the resource. If not present, this defaults
+      #   to an empty dictionary. Individual keys can be removed by setting the value to
+      #   `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+      #   `null`.
+      #
+      #   @return [Hash{Symbol=>String}]
+      required :metadata, Orb::Internal::Type::HashOf[String]
+
+      # @!attribute name
+      #   The name of the subscription.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute plan
+      #
+      #   @return [Orb::Models::SubscriptionListSummaryResponse::Plan, nil]
+      required :plan, -> { Orb::Models::SubscriptionListSummaryResponse::Plan }, nil?: true
+
+      # @!attribute start_date
+      #   The date Orb starts billing for this subscription.
+      #
+      #   @return [Time]
+      required :start_date, Time
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Orb::Models::SubscriptionListSummaryResponse::Status]
+      required :status, enum: -> { Orb::Models::SubscriptionListSummaryResponse::Status }
+
+      # @!method initialize(id:, created_at:, customer:, end_date:, metadata:, name:, plan:, start_date:, status:)
+      #   Some parameter documentations has been truncated, see
+      #   {Orb::Models::SubscriptionListSummaryResponse} for more details.
+      #
+      #   A subscription's own fields, with its plan and customer as references, as listed
+      #   by List subscription summaries and carried in standard webhook payloads. Fetch
+      #   the subscription for its price intervals, billing periods, plan phases and other
+      #   derived fields.
+      #
+      #   @param id [String]
+      #
+      #   @param created_at [Time]
+      #
+      #   @param customer [Orb::Models::CustomerMinified]
+      #
+      #   @param end_date [Time, nil] The date Orb stops billing for this subscription.
+      #
+      #   @param metadata [Hash{Symbol=>String}] User specified key-value pairs for the resource. If not present, this defaults t
+      #
+      #   @param name [String] The name of the subscription.
+      #
+      #   @param plan [Orb::Models::SubscriptionListSummaryResponse::Plan, nil]
+      #
+      #   @param start_date [Time] The date Orb starts billing for this subscription.
+      #
+      #   @param status [Symbol, Orb::Models::SubscriptionListSummaryResponse::Status]
+
+      # @see Orb::Models::SubscriptionListSummaryResponse#plan
+      class Plan < Orb::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        required :id, String, nil?: true
+
+        # @!attribute external_plan_id
+        #   An optional user-defined ID for this plan resource, used throughout the system
+        #   as an alias for this Plan. Use this field to identify a plan by an existing
+        #   identifier in your system.
+        #
+        #   @return [String, nil]
+        required :external_plan_id, String, nil?: true
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        required :name, String, nil?: true
+
+        # @!method initialize(id:, external_plan_id:, name:)
+        #   Some parameter documentations has been truncated, see
+        #   {Orb::Models::SubscriptionListSummaryResponse::Plan} for more details.
+        #
+        #   @param id [String, nil]
+        #
+        #   @param external_plan_id [String, nil] An optional user-defined ID for this plan resource, used throughout the system a
+        #
+        #   @param name [String, nil]
+      end
+
+      # @see Orb::Models::SubscriptionListSummaryResponse#status
+      module Status
+        extend Orb::Internal::Type::Enum
+
+        ACTIVE = :active
+        ENDED = :ended
+        UPCOMING = :upcoming
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/orb/models.rb

@@ -751,6 +751,8 @@ module Orb
 
   SubscriptionListParams = Orb::Models::SubscriptionListParams
 
+  SubscriptionListSummaryParams = Orb::Models::SubscriptionListSummaryParams
+
   SubscriptionMinified = Orb::Models::SubscriptionMinified
 
   SubscriptionPlanChangedWebhookEvent = Orb::Models::SubscriptionPlanChangedWebhookEvent

data/lib/orb/resources/alerts.rb

@@ -233,8 +233,9 @@ module Orb
       # before invoice-level adjustments and credits) denominated in the alert's
       # currency exceeds predefined thresholds during the current billing cycle;
       # `price_filters` can scope which prices contribute. Each plan can have one
-      # `cost_exceeded` alert and one `usage_exceeded` alert per metric that is a part
-      # of the plan.
+      # `cost_exceeded` alert, one `usage_exceeded` alert per metric that is a part of
+      # the plan, and up to 50 `spend_exceeded` alerts, one per combination of currency
+      # and `price_filters`, so separate products can each have their own spend alert.
       #
       # @overload create_for_plan(plan_id, thresholds:, type:, currency: nil, grouping_keys: nil, metric_id: nil, plan_version: nil, price_filters: nil, request_options: {})
       #
@@ -285,8 +286,10 @@ module Orb
       # spend (the pricing subtotal, before invoice-level adjustments and credits)
       # denominated in the alert's currency exceeds predefined thresholds during the
       # current billing cycle; `price_filters` can scope which prices contribute. Each
-      # subscription can have one `cost_exceeded` alert and one `usage_exceeded` alert
-      # per metric that is a part of the subscription.
+      # subscription can have one `cost_exceeded` alert, one `usage_exceeded` alert per
+      # metric that is a part of the subscription, and up to 50 `spend_exceeded` alerts,
+      # one per combination of currency and `price_filters`, so separate products can
+      # each have their own spend alert.
       #
       # @overload create_for_subscription(subscription_id, thresholds:, type:, currency: nil, grouping_keys: nil, metric_id: nil, price_filters: nil, threshold_overrides: nil, request_options: {})
       #

data/lib/orb/resources/subscriptions.rb

@@ -897,6 +897,66 @@ module Orb
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Orb::Models::SubscriptionListSummaryParams} for more details.
+      #
+      # This is a lighter-weight version of
+      # [List subscriptions](/api-reference/subscription/list-subscriptions), with the
+      # same filters, pagination and order. It returns each subscription's own fields,
+      # with its plan and customer as references, and leaves out price intervals,
+      # billing periods, plan phases and other derived fields, making it faster to
+      # respond. Fetch a subscription for those.
+      #
+      # This is the same summary of a subscription that standard
+      # [webhook payloads](/integrations-and-exports/webhook-payload-styles) carry.
+      #
+      # @overload list_summary(created_at_gt: nil, created_at_gte: nil, created_at_lt: nil, created_at_lte: nil, cursor: nil, customer_id: nil, external_customer_id: nil, external_plan_id: nil, limit: nil, plan_id: nil, status: nil, request_options: {})
+      #
+      # @param created_at_gt [Time, nil]
+      #
+      # @param created_at_gte [Time, nil]
+      #
+      # @param created_at_lt [Time, nil]
+      #
+      # @param created_at_lte [Time, nil]
+      #
+      # @param cursor [String, nil] Cursor for pagination. This can be populated by the `next_cursor` value returned
+      #
+      # @param customer_id [String, nil]
+      #
+      # @param external_customer_id [String, nil]
+      #
+      # @param external_plan_id [String, nil]
+      #
+      # @param limit [Integer] The number of items to fetch. Defaults to 20.
+      #
+      # @param plan_id [String, nil]
+      #
+      # @param status [Symbol, Orb::Models::SubscriptionListSummaryParams::Status, nil]
+      #
+      # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Orb::Internal::Page<Orb::Models::SubscriptionListSummaryResponse>]
+      #
+      # @see Orb::Models::SubscriptionListSummaryParams
+      def list_summary(params = {})
+        parsed, options = Orb::SubscriptionListSummaryParams.dump_request(params)
+        query = Orb::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "subscriptions/summary",
+          query: query.transform_keys(
+            created_at_gt: "created_at[gt]",
+            created_at_gte: "created_at[gte]",
+            created_at_lt: "created_at[lt]",
+            created_at_lte: "created_at[lte]"
+          ),
+          page: Orb::Internal::Page,
+          model: Orb::Models::SubscriptionListSummaryResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Orb::Models::SubscriptionPriceIntervalsParams} for more details.
       #

data/lib/orb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Orb
-  VERSION = "1.48.0"
+  VERSION = "1.49.0"
 end

data/lib/orb.rb

@@ -495,6 +495,8 @@ require_relative "orb/models/subscription_invoicing_threshold_exceeded_webhook_e
 require_relative "orb/models/subscription_license_allocation_reset_webhook_event"
 require_relative "orb/models/subscription_license_balance_threshold_reached_webhook_event"
 require_relative "orb/models/subscription_list_params"
+require_relative "orb/models/subscription_list_summary_params"
+require_relative "orb/models/subscription_list_summary_response"
 require_relative "orb/models/subscription_minified"
 require_relative "orb/models/subscription_plan_changed_webhook_event"
 require_relative "orb/models/subscription_plan_change_scheduled_webhook_event"

data/rbi/orb/models/subscription_list_summary_params.rbi

@@ -0,0 +1,148 @@
+# typed: strong
+
+module Orb
+  module Models
+    class SubscriptionListSummaryParams < Orb::Internal::Type::BaseModel
+      extend Orb::Internal::Type::RequestParameters::Converter
+      include Orb::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Orb::SubscriptionListSummaryParams, Orb::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :created_at_gt
+
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :created_at_gte
+
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :created_at_lt
+
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :created_at_lte
+
+      # Cursor for pagination. This can be populated by the `next_cursor` value returned
+      # from the initial request.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :cursor
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :customer_id
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :external_customer_id
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :external_plan_id
+
+      # The number of items to fetch. Defaults to 20.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :limit
+
+      sig { params(limit: Integer).void }
+      attr_writer :limit
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :plan_id
+
+      sig do
+        returns(T.nilable(Orb::SubscriptionListSummaryParams::Status::OrSymbol))
+      end
+      attr_accessor :status
+
+      sig do
+        params(
+          created_at_gt: T.nilable(Time),
+          created_at_gte: T.nilable(Time),
+          created_at_lt: T.nilable(Time),
+          created_at_lte: T.nilable(Time),
+          cursor: T.nilable(String),
+          customer_id: T.nilable(String),
+          external_customer_id: T.nilable(String),
+          external_plan_id: T.nilable(String),
+          limit: Integer,
+          plan_id: T.nilable(String),
+          status:
+            T.nilable(Orb::SubscriptionListSummaryParams::Status::OrSymbol),
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        created_at_gt: nil,
+        created_at_gte: nil,
+        created_at_lt: nil,
+        created_at_lte: nil,
+        # Cursor for pagination. This can be populated by the `next_cursor` value returned
+        # from the initial request.
+        cursor: nil,
+        customer_id: nil,
+        external_customer_id: nil,
+        external_plan_id: nil,
+        # The number of items to fetch. Defaults to 20.
+        limit: nil,
+        plan_id: nil,
+        status: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            created_at_gt: T.nilable(Time),
+            created_at_gte: T.nilable(Time),
+            created_at_lt: T.nilable(Time),
+            created_at_lte: T.nilable(Time),
+            cursor: T.nilable(String),
+            customer_id: T.nilable(String),
+            external_customer_id: T.nilable(String),
+            external_plan_id: T.nilable(String),
+            limit: Integer,
+            plan_id: T.nilable(String),
+            status:
+              T.nilable(Orb::SubscriptionListSummaryParams::Status::OrSymbol),
+            request_options: Orb::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Status
+        extend Orb::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Orb::SubscriptionListSummaryParams::Status)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ACTIVE =
+          T.let(
+            :active,
+            Orb::SubscriptionListSummaryParams::Status::TaggedSymbol
+          )
+        ENDED =
+          T.let(
+            :ended,
+            Orb::SubscriptionListSummaryParams::Status::TaggedSymbol
+          )
+        UPCOMING =
+          T.let(
+            :upcoming,
+            Orb::SubscriptionListSummaryParams::Status::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Orb::SubscriptionListSummaryParams::Status::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/orb/models/subscription_list_summary_response.rbi

@@ -0,0 +1,214 @@
+# typed: strong
+
+module Orb
+  module Models
+    class SubscriptionListSummaryResponse < Orb::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Orb::Models::SubscriptionListSummaryResponse,
+            Orb::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig { returns(Time) }
+      attr_accessor :created_at
+
+      sig { returns(Orb::CustomerMinified) }
+      attr_reader :customer
+
+      sig { params(customer: Orb::CustomerMinified::OrHash).void }
+      attr_writer :customer
+
+      # The date Orb stops billing for this subscription.
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :end_date
+
+      # User specified key-value pairs for the resource. If not present, this defaults
+      # to an empty dictionary. Individual keys can be removed by setting the value to
+      # `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+      # `null`.
+      sig { returns(T::Hash[Symbol, String]) }
+      attr_accessor :metadata
+
+      # The name of the subscription.
+      sig { returns(String) }
+      attr_accessor :name
+
+      sig do
+        returns(T.nilable(Orb::Models::SubscriptionListSummaryResponse::Plan))
+      end
+      attr_reader :plan
+
+      sig do
+        params(
+          plan:
+            T.nilable(
+              Orb::Models::SubscriptionListSummaryResponse::Plan::OrHash
+            )
+        ).void
+      end
+      attr_writer :plan
+
+      # The date Orb starts billing for this subscription.
+      sig { returns(Time) }
+      attr_accessor :start_date
+
+      sig do
+        returns(
+          Orb::Models::SubscriptionListSummaryResponse::Status::TaggedSymbol
+        )
+      end
+      attr_accessor :status
+
+      # A subscription's own fields, with its plan and customer as references, as listed
+      # by List subscription summaries and carried in standard webhook payloads. Fetch
+      # the subscription for its price intervals, billing periods, plan phases and other
+      # derived fields.
+      sig do
+        params(
+          id: String,
+          created_at: Time,
+          customer: Orb::CustomerMinified::OrHash,
+          end_date: T.nilable(Time),
+          metadata: T::Hash[Symbol, String],
+          name: String,
+          plan:
+            T.nilable(
+              Orb::Models::SubscriptionListSummaryResponse::Plan::OrHash
+            ),
+          start_date: Time,
+          status: Orb::Models::SubscriptionListSummaryResponse::Status::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        created_at:,
+        customer:,
+        # The date Orb stops billing for this subscription.
+        end_date:,
+        # User specified key-value pairs for the resource. If not present, this defaults
+        # to an empty dictionary. Individual keys can be removed by setting the value to
+        # `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+        # `null`.
+        metadata:,
+        # The name of the subscription.
+        name:,
+        plan:,
+        # The date Orb starts billing for this subscription.
+        start_date:,
+        status:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created_at: Time,
+            customer: Orb::CustomerMinified,
+            end_date: T.nilable(Time),
+            metadata: T::Hash[Symbol, String],
+            name: String,
+            plan: T.nilable(Orb::Models::SubscriptionListSummaryResponse::Plan),
+            start_date: Time,
+            status:
+              Orb::Models::SubscriptionListSummaryResponse::Status::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Plan < Orb::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Orb::Models::SubscriptionListSummaryResponse::Plan,
+              Orb::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :id
+
+        # An optional user-defined ID for this plan resource, used throughout the system
+        # as an alias for this Plan. Use this field to identify a plan by an existing
+        # identifier in your system.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :external_plan_id
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :name
+
+        sig do
+          params(
+            id: T.nilable(String),
+            external_plan_id: T.nilable(String),
+            name: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          # An optional user-defined ID for this plan resource, used throughout the system
+          # as an alias for this Plan. Use this field to identify a plan by an existing
+          # identifier in your system.
+          external_plan_id:,
+          name:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: T.nilable(String),
+              external_plan_id: T.nilable(String),
+              name: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
+      module Status
+        extend Orb::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Orb::Models::SubscriptionListSummaryResponse::Status)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ACTIVE =
+          T.let(
+            :active,
+            Orb::Models::SubscriptionListSummaryResponse::Status::TaggedSymbol
+          )
+        ENDED =
+          T.let(
+            :ended,
+            Orb::Models::SubscriptionListSummaryResponse::Status::TaggedSymbol
+          )
+        UPCOMING =
+          T.let(
+            :upcoming,
+            Orb::Models::SubscriptionListSummaryResponse::Status::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Orb::Models::SubscriptionListSummaryResponse::Status::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/orb/models.rbi

@@ -813,6 +813,8 @@ module Orb
 
   SubscriptionListParams = Orb::Models::SubscriptionListParams
 
+  SubscriptionListSummaryParams = Orb::Models::SubscriptionListSummaryParams
+
   SubscriptionMinified = Orb::Models::SubscriptionMinified
 
   SubscriptionPlanChangedWebhookEvent =

data/rbi/orb/resources/alerts.rbi

@@ -187,8 +187,9 @@ module Orb
       # before invoice-level adjustments and credits) denominated in the alert's
       # currency exceeds predefined thresholds during the current billing cycle;
       # `price_filters` can scope which prices contribute. Each plan can have one
-      # `cost_exceeded` alert and one `usage_exceeded` alert per metric that is a part
-      # of the plan.
+      # `cost_exceeded` alert, one `usage_exceeded` alert per metric that is a part of
+      # the plan, and up to 50 `spend_exceeded` alerts, one per combination of currency
+      # and `price_filters`, so separate products can each have their own spend alert.
       sig do
         params(
           plan_id: String,
@@ -243,8 +244,10 @@ module Orb
       # spend (the pricing subtotal, before invoice-level adjustments and credits)
       # denominated in the alert's currency exceeds predefined thresholds during the
       # current billing cycle; `price_filters` can scope which prices contribute. Each
-      # subscription can have one `cost_exceeded` alert and one `usage_exceeded` alert
-      # per metric that is a part of the subscription.
+      # subscription can have one `cost_exceeded` alert, one `usage_exceeded` alert per
+      # metric that is a part of the subscription, and up to 50 `spend_exceeded` alerts,
+      # one per combination of currency and `price_filters`, so separate products can
+      # each have their own spend alert.
       sig do
         params(
           subscription_id: String,

data/rbi/orb/resources/subscriptions.rbi

@@ -923,6 +923,53 @@ module Orb
       )
       end
 
+      # This is a lighter-weight version of
+      # [List subscriptions](/api-reference/subscription/list-subscriptions), with the
+      # same filters, pagination and order. It returns each subscription's own fields,
+      # with its plan and customer as references, and leaves out price intervals,
+      # billing periods, plan phases and other derived fields, making it faster to
+      # respond. Fetch a subscription for those.
+      #
+      # This is the same summary of a subscription that standard
+      # [webhook payloads](/integrations-and-exports/webhook-payload-styles) carry.
+      sig do
+        params(
+          created_at_gt: T.nilable(Time),
+          created_at_gte: T.nilable(Time),
+          created_at_lt: T.nilable(Time),
+          created_at_lte: T.nilable(Time),
+          cursor: T.nilable(String),
+          customer_id: T.nilable(String),
+          external_customer_id: T.nilable(String),
+          external_plan_id: T.nilable(String),
+          limit: Integer,
+          plan_id: T.nilable(String),
+          status:
+            T.nilable(Orb::SubscriptionListSummaryParams::Status::OrSymbol),
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(
+          Orb::Internal::Page[Orb::Models::SubscriptionListSummaryResponse]
+        )
+      end
+      def list_summary(
+        created_at_gt: nil,
+        created_at_gte: nil,
+        created_at_lt: nil,
+        created_at_lte: nil,
+        # Cursor for pagination. This can be populated by the `next_cursor` value returned
+        # from the initial request.
+        cursor: nil,
+        customer_id: nil,
+        external_customer_id: nil,
+        external_plan_id: nil,
+        # The number of items to fetch. Defaults to 20.
+        limit: nil,
+        plan_id: nil,
+        status: nil,
+        request_options: {}
+      )
+      end
+
       # This endpoint is used to add and edit subscription
       # [price intervals](/api-reference/price-interval/add-or-edit-price-intervals). By
       # making modifications to a subscription’s price intervals, you can

data/sig/orb/models/subscription_list_summary_params.rbs

@@ -0,0 +1,90 @@
+module Orb
+  module Models
+    type subscription_list_summary_params =
+      {
+        created_at_gt: Time?,
+        created_at_gte: Time?,
+        created_at_lt: Time?,
+        created_at_lte: Time?,
+        cursor: String?,
+        customer_id: String?,
+        external_customer_id: String?,
+        external_plan_id: String?,
+        limit: Integer,
+        plan_id: String?,
+        status: Orb::Models::SubscriptionListSummaryParams::status?
+      }
+      & Orb::Internal::Type::request_parameters
+
+    class SubscriptionListSummaryParams < Orb::Internal::Type::BaseModel
+      extend Orb::Internal::Type::RequestParameters::Converter
+      include Orb::Internal::Type::RequestParameters
+
+      attr_accessor created_at_gt: Time?
+
+      attr_accessor created_at_gte: Time?
+
+      attr_accessor created_at_lt: Time?
+
+      attr_accessor created_at_lte: Time?
+
+      attr_accessor cursor: String?
+
+      attr_accessor customer_id: String?
+
+      attr_accessor external_customer_id: String?
+
+      attr_accessor external_plan_id: String?
+
+      attr_reader limit: Integer?
+
+      def limit=: (Integer) -> Integer
+
+      attr_accessor plan_id: String?
+
+      attr_accessor status: Orb::Models::SubscriptionListSummaryParams::status?
+
+      def initialize: (
+        ?created_at_gt: Time?,
+        ?created_at_gte: Time?,
+        ?created_at_lt: Time?,
+        ?created_at_lte: Time?,
+        ?cursor: String?,
+        ?customer_id: String?,
+        ?external_customer_id: String?,
+        ?external_plan_id: String?,
+        ?limit: Integer,
+        ?plan_id: String?,
+        ?status: Orb::Models::SubscriptionListSummaryParams::status?,
+        ?request_options: Orb::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        created_at_gt: Time?,
+        created_at_gte: Time?,
+        created_at_lt: Time?,
+        created_at_lte: Time?,
+        cursor: String?,
+        customer_id: String?,
+        external_customer_id: String?,
+        external_plan_id: String?,
+        limit: Integer,
+        plan_id: String?,
+        status: Orb::Models::SubscriptionListSummaryParams::status?,
+        request_options: Orb::RequestOptions
+      }
+
+      type status = :active | :ended | :upcoming
+
+      module Status
+        extend Orb::Internal::Type::Enum
+
+        ACTIVE: :active
+        ENDED: :ended
+        UPCOMING: :upcoming
+
+        def self?.values: -> ::Array[Orb::Models::SubscriptionListSummaryParams::status]
+      end
+    end
+  end
+end

data/sig/orb/models/subscription_list_summary_response.rbs

@@ -0,0 +1,94 @@
+module Orb
+  module Models
+    type subscription_list_summary_response =
+      {
+        id: String,
+        created_at: Time,
+        customer: Orb::CustomerMinified,
+        end_date: Time?,
+        metadata: ::Hash[Symbol, String],
+        name: String,
+        plan: Orb::Models::SubscriptionListSummaryResponse::Plan?,
+        start_date: Time,
+        status: Orb::Models::SubscriptionListSummaryResponse::status
+      }
+
+    class SubscriptionListSummaryResponse < Orb::Internal::Type::BaseModel
+      attr_accessor id: String
+
+      attr_accessor created_at: Time
+
+      attr_accessor customer: Orb::CustomerMinified
+
+      attr_accessor end_date: Time?
+
+      attr_accessor metadata: ::Hash[Symbol, String]
+
+      attr_accessor name: String
+
+      attr_accessor plan: Orb::Models::SubscriptionListSummaryResponse::Plan?
+
+      attr_accessor start_date: Time
+
+      attr_accessor status: Orb::Models::SubscriptionListSummaryResponse::status
+
+      def initialize: (
+        id: String,
+        created_at: Time,
+        customer: Orb::CustomerMinified,
+        end_date: Time?,
+        metadata: ::Hash[Symbol, String],
+        name: String,
+        plan: Orb::Models::SubscriptionListSummaryResponse::Plan?,
+        start_date: Time,
+        status: Orb::Models::SubscriptionListSummaryResponse::status
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        created_at: Time,
+        customer: Orb::CustomerMinified,
+        end_date: Time?,
+        metadata: ::Hash[Symbol, String],
+        name: String,
+        plan: Orb::Models::SubscriptionListSummaryResponse::Plan?,
+        start_date: Time,
+        status: Orb::Models::SubscriptionListSummaryResponse::status
+      }
+
+      type plan = { id: String?, external_plan_id: String?, name: String? }
+
+      class Plan < Orb::Internal::Type::BaseModel
+        attr_accessor id: String?
+
+        attr_accessor external_plan_id: String?
+
+        attr_accessor name: String?
+
+        def initialize: (
+          id: String?,
+          external_plan_id: String?,
+          name: String?
+        ) -> void
+
+        def to_hash: -> {
+          id: String?,
+          external_plan_id: String?,
+          name: String?
+        }
+      end
+
+      type status = :active | :ended | :upcoming
+
+      module Status
+        extend Orb::Internal::Type::Enum
+
+        ACTIVE: :active
+        ENDED: :ended
+        UPCOMING: :upcoming
+
+        def self?.values: -> ::Array[Orb::Models::SubscriptionListSummaryResponse::status]
+      end
+    end
+  end
+end

data/sig/orb/models.rbs

@@ -687,6 +687,8 @@ module Orb
 
   class SubscriptionListParams = Orb::Models::SubscriptionListParams
 
+  class SubscriptionListSummaryParams = Orb::Models::SubscriptionListSummaryParams
+
   class SubscriptionMinified = Orb::Models::SubscriptionMinified
 
   class SubscriptionPlanChangedWebhookEvent = Orb::Models::SubscriptionPlanChangedWebhookEvent

data/sig/orb/resources/subscriptions.rbs

@@ -113,6 +113,21 @@ module Orb
         ?request_options: Orb::request_opts
       ) -> Orb::Models::subscription_usage
 
+      def list_summary: (
+        ?created_at_gt: Time?,
+        ?created_at_gte: Time?,
+        ?created_at_lt: Time?,
+        ?created_at_lte: Time?,
+        ?cursor: String?,
+        ?customer_id: String?,
+        ?external_customer_id: String?,
+        ?external_plan_id: String?,
+        ?limit: Integer,
+        ?plan_id: String?,
+        ?status: Orb::Models::SubscriptionListSummaryParams::status?,
+        ?request_options: Orb::request_opts
+      ) -> Orb::Internal::Page[Orb::Models::SubscriptionListSummaryResponse]
+
       def price_intervals: (
         String subscription_id,
         ?add: ::Array[Orb::SubscriptionPriceIntervalsParams::Add],

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: orb-billing
 version: !ruby/object:Gem::Version
-  version: 1.48.0
+  version: 1.49.0
 platform: ruby
 authors:
 - Orb
@@ -510,6 +510,8 @@ files:
 - lib/orb/models/subscription_license_allocation_reset_webhook_event.rb
 - lib/orb/models/subscription_license_balance_threshold_reached_webhook_event.rb
 - lib/orb/models/subscription_list_params.rb
+- lib/orb/models/subscription_list_summary_params.rb
+- lib/orb/models/subscription_list_summary_response.rb
 - lib/orb/models/subscription_minified.rb
 - lib/orb/models/subscription_plan_change_scheduled_webhook_event.rb
 - lib/orb/models/subscription_plan_changed_webhook_event.rb
@@ -1144,6 +1146,8 @@ files:
 - rbi/orb/models/subscription_license_allocation_reset_webhook_event.rbi
 - rbi/orb/models/subscription_license_balance_threshold_reached_webhook_event.rbi
 - rbi/orb/models/subscription_list_params.rbi
+- rbi/orb/models/subscription_list_summary_params.rbi
+- rbi/orb/models/subscription_list_summary_response.rbi
 - rbi/orb/models/subscription_minified.rbi
 - rbi/orb/models/subscription_plan_change_scheduled_webhook_event.rbi
 - rbi/orb/models/subscription_plan_changed_webhook_event.rbi
@@ -1777,6 +1781,8 @@ files:
 - sig/orb/models/subscription_license_allocation_reset_webhook_event.rbs
 - sig/orb/models/subscription_license_balance_threshold_reached_webhook_event.rbs
 - sig/orb/models/subscription_list_params.rbs
+- sig/orb/models/subscription_list_summary_params.rbs
+- sig/orb/models/subscription_list_summary_response.rbs
 - sig/orb/models/subscription_minified.rbs
 - sig/orb/models/subscription_plan_change_scheduled_webhook_event.rbs
 - sig/orb/models/subscription_plan_changed_webhook_event.rbs