orb-billing 1.39.0 → 1.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0a9272658203e27f096597fcf707e6f168ba671f7a9b24da1618ab018a7e19f
-  data.tar.gz: d8adf16bf1f52f56468c22783c9d28ec6fec531b4ba25b7b545d942cbc82f5f5
+  metadata.gz: ae1a554ffa1f02c4a6389c6399a1ad669067740cb555aed61f1aa9f9431450f0
+  data.tar.gz: 61e554cca021010bd8a5fb9b05f6737277ebba9d41812e7f517c66c7263f1757
 SHA512:
-  metadata.gz: ed994b60bbfe92f2faebb1eb6f479187f0c903e04357740976a63ff383b0329cee0e0ef990aeba26f7ed8fa56067d967ea92f1347c2f84448785ce89c9e61770
-  data.tar.gz: 9e5940453306f3ff24b0027885138b31d095fdfa42865fabccf8ba5585f510832decf24770165b5b3890c212a6f85eec78e554e46be15b9873aacb2a9fa7fe6e
+  metadata.gz: 504c8ea65bf2ed7be2e1f88dc3a5cfef668638559902cecafaad975b8281019d86e3d25a0f9d20d06c758cc616b811bb22d5fd0fa980f8ac8cdb6724834f41ec
+  data.tar.gz: 9b751116050e2768715cdbc5b196c145f4efdcba8547c58fd1ac51d05208fa1d146c30b8bec593a4fa93954b8b8454275aaee2dd0535ae57885b4d40b6ab3772

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.40.0](https://github.com/orbcorp/orb-ruby/compare/v1.39.0...v1.40.0) (2026-10-07)
+
+
+### Features
+
+* **api:** add billable_metric_id filter, price_count, and prices list endpoint for dimensional price groups ([3b4e02a](https://github.com/orbcorp/orb-ruby/commit/3b4e02a8ad9286a0e1496a484e5255805c9a75ea))
+
 ## [1.39.0](https://github.com/orbcorp/orb-ruby/compare/v1.38.0...v1.39.0) (2026-10-01)
 
 

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.39.0"
+gem "orb-billing", "~> 1.40.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/orb/models/dimensional_price_group.rb

@@ -44,7 +44,14 @@ module Orb
       #   @return [String]
       required :name, String
 
-      # @!method initialize(id:, billable_metric_id:, dimensions:, external_dimensional_price_group_id:, metadata:, name:)
+      # @!attribute price_count
+      #   The number of prices in this group. Archived prices and subscription overrides
+      #   are excluded.
+      #
+      #   @return [Integer]
+      required :price_count, Integer
+
+      # @!method initialize(id:, billable_metric_id:, dimensions:, external_dimensional_price_group_id:, metadata:, name:, price_count:)
       #   Some parameter documentations has been truncated, see
       #   {Orb::Models::DimensionalPriceGroup} for more details.
       #
@@ -63,6 +70,8 @@ module Orb
       #   @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 dimensional price group
+      #
+      #   @param price_count [Integer] The number of prices in this group. Archived prices and subscription overrides a
     end
   end
 end

data/lib/orb/models/dimensional_price_group_list_params.rb

@@ -7,6 +7,12 @@ module Orb
       extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
+      # @!attribute billable_metric_id
+      #   Filter to groups that use this billable metric.
+      #
+      #   @return [String, nil]
+      optional :billable_metric_id, String, nil?: true
+
       # @!attribute cursor
       #   Cursor for pagination. This can be populated by the `next_cursor` value returned
       #   from the initial request.
@@ -20,10 +26,12 @@ module Orb
       #   @return [Integer, nil]
       optional :limit, Integer
 
-      # @!method initialize(cursor: nil, limit: nil, request_options: {})
+      # @!method initialize(billable_metric_id: nil, cursor: nil, limit: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Orb::Models::DimensionalPriceGroupListParams} for more details.
       #
+      #   @param billable_metric_id [String, nil] Filter to groups that use this billable metric.
+      #
       #   @param cursor [String, nil] Cursor for pagination. This can be populated by the `next_cursor` value returned
       #
       #   @param limit [Integer] The number of items to fetch. Defaults to 20.

data/lib/orb/resources/dimensional_price_groups.rb

@@ -107,10 +107,15 @@ module Orb
       # dimensions, and the prices in the group specify which partition their usage is
       # derived from.
       #
+      # Filter with `billable_metric_id`. Each group includes `price_count`:
+      # non-archived prices in the group. Subscription overrides are not counted.
+      #
       # The response also includes pagination_metadata, which lets the caller retrieve
       # the next page of results if they exist.
       #
-      # @overload list(cursor: nil, limit: nil, request_options: {})
+      # @overload list(billable_metric_id: nil, cursor: nil, limit: nil, request_options: {})
+      #
+      # @param billable_metric_id [String, nil] Filter to groups that use this billable metric.
       #
       # @param cursor [String, nil] Cursor for pagination. This can be populated by the `next_cursor` value returned
       #

data/lib/orb/version.rb

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

data/rbi/orb/models/dimensional_price_group.rbi

@@ -36,6 +36,11 @@ module Orb
       sig { returns(String) }
       attr_accessor :name
 
+      # The number of prices in this group. Archived prices and subscription overrides
+      # are excluded.
+      sig { returns(Integer) }
+      attr_accessor :price_count
+
       # A dimensional price group is used to partition the result of a billable metric
       # by a set of dimensions. Prices in a price group must specify the partition used
       # to derive their usage.
@@ -46,7 +51,8 @@ module Orb
           dimensions: T::Array[String],
           external_dimensional_price_group_id: T.nilable(String),
           metadata: T::Hash[Symbol, String],
-          name: String
+          name: String,
+          price_count: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -65,7 +71,10 @@ module Orb
         # `null`.
         metadata:,
         # The name of the dimensional price group
-        name:
+        name:,
+        # The number of prices in this group. Archived prices and subscription overrides
+        # are excluded.
+        price_count:
       )
       end
 
@@ -77,7 +86,8 @@ module Orb
             dimensions: T::Array[String],
             external_dimensional_price_group_id: T.nilable(String),
             metadata: T::Hash[Symbol, String],
-            name: String
+            name: String,
+            price_count: Integer
           }
         )
       end

data/rbi/orb/models/dimensional_price_group_list_params.rbi

@@ -11,6 +11,10 @@ module Orb
           T.any(Orb::DimensionalPriceGroupListParams, Orb::Internal::AnyHash)
         end
 
+      # Filter to groups that use this billable metric.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :billable_metric_id
+
       # Cursor for pagination. This can be populated by the `next_cursor` value returned
       # from the initial request.
       sig { returns(T.nilable(String)) }
@@ -25,12 +29,15 @@ module Orb
 
       sig do
         params(
+          billable_metric_id: T.nilable(String),
           cursor: T.nilable(String),
           limit: Integer,
           request_options: Orb::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # Filter to groups that use this billable metric.
+        billable_metric_id: nil,
         # Cursor for pagination. This can be populated by the `next_cursor` value returned
         # from the initial request.
         cursor: nil,
@@ -43,6 +50,7 @@ module Orb
       sig do
         override.returns(
           {
+            billable_metric_id: T.nilable(String),
             cursor: T.nilable(String),
             limit: Integer,
             request_options: Orb::RequestOptions

data/rbi/orb/resources/dimensional_price_groups.rbi

@@ -86,16 +86,22 @@ module Orb
       # dimensions, and the prices in the group specify which partition their usage is
       # derived from.
       #
+      # Filter with `billable_metric_id`. Each group includes `price_count`:
+      # non-archived prices in the group. Subscription overrides are not counted.
+      #
       # The response also includes pagination_metadata, which lets the caller retrieve
       # the next page of results if they exist.
       sig do
         params(
+          billable_metric_id: T.nilable(String),
           cursor: T.nilable(String),
           limit: Integer,
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Internal::Page[Orb::DimensionalPriceGroup])
       end
       def list(
+        # Filter to groups that use this billable metric.
+        billable_metric_id: nil,
         # Cursor for pagination. This can be populated by the `next_cursor` value returned
         # from the initial request.
         cursor: nil,

data/sig/orb/models/dimensional_price_group.rbs

@@ -7,7 +7,8 @@ module Orb
         dimensions: ::Array[String],
         external_dimensional_price_group_id: String?,
         metadata: ::Hash[Symbol, String],
-        name: String
+        name: String,
+        price_count: Integer
       }
 
     class DimensionalPriceGroup < Orb::Internal::Type::BaseModel
@@ -23,13 +24,16 @@ module Orb
 
       attr_accessor name: String
 
+      attr_accessor price_count: Integer
+
       def initialize: (
         id: String,
         billable_metric_id: String,
         dimensions: ::Array[String],
         external_dimensional_price_group_id: String?,
         metadata: ::Hash[Symbol, String],
-        name: String
+        name: String,
+        price_count: Integer
       ) -> void
 
       def to_hash: -> {
@@ -38,7 +42,8 @@ module Orb
         dimensions: ::Array[String],
         external_dimensional_price_group_id: String?,
         metadata: ::Hash[Symbol, String],
-        name: String
+        name: String,
+        price_count: Integer
       }
     end
   end

data/sig/orb/models/dimensional_price_group_list_params.rbs

@@ -1,13 +1,15 @@
 module Orb
   module Models
     type dimensional_price_group_list_params =
-      { cursor: String?, limit: Integer }
+      { billable_metric_id: String?, cursor: String?, limit: Integer }
       & Orb::Internal::Type::request_parameters
 
     class DimensionalPriceGroupListParams < Orb::Internal::Type::BaseModel
       extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
+      attr_accessor billable_metric_id: String?
+
       attr_accessor cursor: String?
 
       attr_reader limit: Integer?
@@ -15,12 +17,14 @@ module Orb
       def limit=: (Integer) -> Integer
 
       def initialize: (
+        ?billable_metric_id: String?,
         ?cursor: String?,
         ?limit: Integer,
         ?request_options: Orb::request_opts
       ) -> void
 
       def to_hash: -> {
+        billable_metric_id: String?,
         cursor: String?,
         limit: Integer,
         request_options: Orb::RequestOptions

data/sig/orb/resources/dimensional_price_groups.rbs

@@ -25,6 +25,7 @@ module Orb
       ) -> Orb::DimensionalPriceGroup
 
       def list: (
+        ?billable_metric_id: String?,
         ?cursor: String?,
         ?limit: Integer,
         ?request_options: Orb::request_opts

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: orb-billing
 version: !ruby/object:Gem::Version
-  version: 1.39.0
+  version: 1.40.0
 platform: ruby
 authors:
 - Orb