orb-billing 0.5.5 → 0.7.0

data/rbi/orb/models/trial_discount.rbi

@@ -6,14 +6,14 @@ module Orb
       OrHash =
         T.type_alias { T.any(Orb::TrialDiscount, Orb::Internal::AnyHash) }
 
+      sig { returns(Orb::TrialDiscount::DiscountType::OrSymbol) }
+      attr_accessor :discount_type
+
       # List of price_ids that this discount applies to. For plan/plan phase discounts,
       # this can be a subset of prices.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :applies_to_price_ids
 
-      sig { returns(Orb::TrialDiscount::DiscountType::OrSymbol) }
-      attr_accessor :discount_type
-
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
 
@@ -27,18 +27,18 @@ module Orb
 
       sig do
         params(
-          applies_to_price_ids: T::Array[String],
           discount_type: Orb::TrialDiscount::DiscountType::OrSymbol,
+          applies_to_price_ids: T.nilable(T::Array[String]),
           reason: T.nilable(String),
           trial_amount_discount: T.nilable(String),
           trial_percentage_discount: T.nilable(Float)
         ).returns(T.attached_class)
       end
       def self.new(
+        discount_type:,
         # List of price_ids that this discount applies to. For plan/plan phase discounts,
         # this can be a subset of prices.
-        applies_to_price_ids:,
-        discount_type:,
+        applies_to_price_ids: nil,
         reason: nil,
         # Only available if discount_type is `trial`
         trial_amount_discount: nil,
@@ -50,8 +50,8 @@ module Orb
       sig do
         override.returns(
           {
-            applies_to_price_ids: T::Array[String],
             discount_type: Orb::TrialDiscount::DiscountType::OrSymbol,
+            applies_to_price_ids: T.nilable(T::Array[String]),
             reason: T.nilable(String),
             trial_amount_discount: T.nilable(String),
             trial_percentage_discount: T.nilable(Float)

data/rbi/orb/models/usage_discount.rbi

@@ -6,11 +6,6 @@ module Orb
       OrHash =
         T.type_alias { T.any(Orb::UsageDiscount, Orb::Internal::AnyHash) }
 
-      # List of price_ids that this discount applies to. For plan/plan phase discounts,
-      # this can be a subset of prices.
-      sig { returns(T::Array[String]) }
-      attr_accessor :applies_to_price_ids
-
       sig { returns(Orb::UsageDiscount::DiscountType::OrSymbol) }
       attr_accessor :discount_type
 
@@ -19,25 +14,30 @@ module Orb
       sig { returns(Float) }
       attr_accessor :usage_discount
 
+      # List of price_ids that this discount applies to. For plan/plan phase discounts,
+      # this can be a subset of prices.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :applies_to_price_ids
+
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
 
       sig do
         params(
-          applies_to_price_ids: T::Array[String],
           discount_type: Orb::UsageDiscount::DiscountType::OrSymbol,
           usage_discount: Float,
+          applies_to_price_ids: T.nilable(T::Array[String]),
           reason: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
-        # List of price_ids that this discount applies to. For plan/plan phase discounts,
-        # this can be a subset of prices.
-        applies_to_price_ids:,
         discount_type:,
         # Only available if discount_type is `usage`. Number of usage units that this
         # discount is for
         usage_discount:,
+        # List of price_ids that this discount applies to. For plan/plan phase discounts,
+        # this can be a subset of prices.
+        applies_to_price_ids: nil,
         reason: nil
       )
       end
@@ -45,9 +45,9 @@ module Orb
       sig do
         override.returns(
           {
-            applies_to_price_ids: T::Array[String],
             discount_type: Orb::UsageDiscount::DiscountType::OrSymbol,
             usage_discount: Float,
+            applies_to_price_ids: T.nilable(T::Array[String]),
             reason: T.nilable(String)
           }
         )

data/rbi/orb/models.rbi

@@ -23,6 +23,14 @@ module Orb
 
   AmountDiscount = Orb::Models::AmountDiscount
 
+  Beta = Orb::Models::Beta
+
+  BetaCreatePlanVersionParams = Orb::Models::BetaCreatePlanVersionParams
+
+  BetaFetchPlanVersionParams = Orb::Models::BetaFetchPlanVersionParams
+
+  BetaSetDefaultPlanVersionParams = Orb::Models::BetaSetDefaultPlanVersionParams
+
   BillableMetric = Orb::Models::BillableMetric
 
   BillingCycleRelativeDate = Orb::Models::BillingCycleRelativeDate
@@ -126,6 +134,8 @@ module Orb
 
   Item = Orb::Models::Item
 
+  ItemArchiveParams = Orb::Models::ItemArchiveParams
+
   ItemCreateParams = Orb::Models::ItemCreateParams
 
   ItemFetchParams = Orb::Models::ItemFetchParams
@@ -158,10 +168,16 @@ module Orb
 
   PlanUpdateParams = Orb::Models::PlanUpdateParams
 
+  PlanVersion = Orb::Models::PlanVersion
+
+  PlanVersionPhase = Orb::Models::PlanVersionPhase
+
   Price = Orb::Models::Price
 
   PriceCreateParams = Orb::Models::PriceCreateParams
 
+  PriceEvaluateMultipleParams = Orb::Models::PriceEvaluateMultipleParams
+
   PriceEvaluateParams = Orb::Models::PriceEvaluateParams
 
   PriceFetchParams = Orb::Models::PriceFetchParams

data/rbi/orb/resources/beta/external_plan_id.rbi

@@ -0,0 +1,118 @@
+# typed: strong
+
+module Orb
+  module Resources
+    class Beta
+      class ExternalPlanID
+        # This API endpoint is in beta and its interface may change. It is recommended for
+        # use only in test mode.
+        #
+        # This endpoint allows the creation of a new plan version for an existing plan.
+        sig do
+          params(
+            external_plan_id: String,
+            version: Integer,
+            add_adjustments:
+              T.nilable(
+                T::Array[
+                  Orb::Beta::ExternalPlanIDCreatePlanVersionParams::AddAdjustment::OrHash
+                ]
+              ),
+            add_prices:
+              T.nilable(
+                T::Array[
+                  Orb::Beta::ExternalPlanIDCreatePlanVersionParams::AddPrice::OrHash
+                ]
+              ),
+            remove_adjustments:
+              T.nilable(
+                T::Array[
+                  Orb::Beta::ExternalPlanIDCreatePlanVersionParams::RemoveAdjustment::OrHash
+                ]
+              ),
+            remove_prices:
+              T.nilable(
+                T::Array[
+                  Orb::Beta::ExternalPlanIDCreatePlanVersionParams::RemovePrice::OrHash
+                ]
+              ),
+            replace_adjustments:
+              T.nilable(
+                T::Array[
+                  Orb::Beta::ExternalPlanIDCreatePlanVersionParams::ReplaceAdjustment::OrHash
+                ]
+              ),
+            replace_prices:
+              T.nilable(
+                T::Array[
+                  Orb::Beta::ExternalPlanIDCreatePlanVersionParams::ReplacePrice::OrHash
+                ]
+              ),
+            set_as_default: T.nilable(T::Boolean),
+            request_options: Orb::RequestOptions::OrHash
+          ).returns(Orb::PlanVersion)
+        end
+        def create_plan_version(
+          external_plan_id,
+          # New version number.
+          version:,
+          # Additional adjustments to be added to the plan.
+          add_adjustments: nil,
+          # Additional prices to be added to the plan.
+          add_prices: nil,
+          # Adjustments to be removed from the plan.
+          remove_adjustments: nil,
+          # Prices to be removed from the plan.
+          remove_prices: nil,
+          # Adjustments to be replaced with additional adjustments on the plan.
+          replace_adjustments: nil,
+          # Prices to be replaced with additional prices on the plan.
+          replace_prices: nil,
+          # Set this new plan version as the default
+          set_as_default: nil,
+          request_options: {}
+        )
+        end
+
+        # This API endpoint is in beta and its interface may change. It is recommended for
+        # use only in test mode.
+        #
+        # This endpoint is used to fetch a plan version. It returns the phases, prices,
+        # and adjustments present on this version of the plan.
+        sig do
+          params(
+            version: String,
+            external_plan_id: String,
+            request_options: Orb::RequestOptions::OrHash
+          ).returns(Orb::PlanVersion)
+        end
+        def fetch_plan_version(version, external_plan_id:, request_options: {})
+        end
+
+        # This API endpoint is in beta and its interface may change. It is recommended for
+        # use only in test mode.
+        #
+        # This endpoint allows setting the default version of a plan.
+        sig do
+          params(
+            external_plan_id: String,
+            version: Integer,
+            request_options: Orb::RequestOptions::OrHash
+          ).returns(Orb::Plan)
+        end
+        def set_default_plan_version(
+          external_plan_id,
+          # Plan version to set as the default.
+          version:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Orb::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/orb/resources/beta.rbi

@@ -0,0 +1,111 @@
+# typed: strong
+
+module Orb
+  module Resources
+    class Beta
+      sig { returns(Orb::Resources::Beta::ExternalPlanID) }
+      attr_reader :external_plan_id
+
+      # This API endpoint is in beta and its interface may change. It is recommended for
+      # use only in test mode.
+      #
+      # This endpoint allows the creation of a new plan version for an existing plan.
+      sig do
+        params(
+          plan_id: String,
+          version: Integer,
+          add_adjustments:
+            T.nilable(
+              T::Array[Orb::BetaCreatePlanVersionParams::AddAdjustment::OrHash]
+            ),
+          add_prices:
+            T.nilable(
+              T::Array[Orb::BetaCreatePlanVersionParams::AddPrice::OrHash]
+            ),
+          remove_adjustments:
+            T.nilable(
+              T::Array[
+                Orb::BetaCreatePlanVersionParams::RemoveAdjustment::OrHash
+              ]
+            ),
+          remove_prices:
+            T.nilable(
+              T::Array[Orb::BetaCreatePlanVersionParams::RemovePrice::OrHash]
+            ),
+          replace_adjustments:
+            T.nilable(
+              T::Array[
+                Orb::BetaCreatePlanVersionParams::ReplaceAdjustment::OrHash
+              ]
+            ),
+          replace_prices:
+            T.nilable(
+              T::Array[Orb::BetaCreatePlanVersionParams::ReplacePrice::OrHash]
+            ),
+          set_as_default: T.nilable(T::Boolean),
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::PlanVersion)
+      end
+      def create_plan_version(
+        plan_id,
+        # New version number.
+        version:,
+        # Additional adjustments to be added to the plan.
+        add_adjustments: nil,
+        # Additional prices to be added to the plan.
+        add_prices: nil,
+        # Adjustments to be removed from the plan.
+        remove_adjustments: nil,
+        # Prices to be removed from the plan.
+        remove_prices: nil,
+        # Adjustments to be replaced with additional adjustments on the plan.
+        replace_adjustments: nil,
+        # Prices to be replaced with additional prices on the plan.
+        replace_prices: nil,
+        # Set this new plan version as the default
+        set_as_default: nil,
+        request_options: {}
+      )
+      end
+
+      # This API endpoint is in beta and its interface may change. It is recommended for
+      # use only in test mode.
+      #
+      # This endpoint is used to fetch a plan version. It returns the phases, prices,
+      # and adjustments present on this version of the plan.
+      sig do
+        params(
+          version: String,
+          plan_id: String,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::PlanVersion)
+      end
+      def fetch_plan_version(version, plan_id:, request_options: {})
+      end
+
+      # This API endpoint is in beta and its interface may change. It is recommended for
+      # use only in test mode.
+      #
+      # This endpoint allows setting the default version of a plan.
+      sig do
+        params(
+          plan_id: String,
+          version: Integer,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::Plan)
+      end
+      def set_default_plan_version(
+        plan_id,
+        # Plan version to set as the default.
+        version:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Orb::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/orb/resources/credit_notes.rbi

@@ -8,17 +8,17 @@ module Orb
       sig do
         params(
           line_items: T::Array[Orb::CreditNoteCreateParams::LineItem::OrHash],
+          reason: Orb::CreditNoteCreateParams::Reason::OrSymbol,
           memo: T.nilable(String),
-          reason: T.nilable(Orb::CreditNoteCreateParams::Reason::OrSymbol),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::CreditNote)
       end
       def create(
         line_items:,
+        # An optional reason for the credit note.
+        reason:,
         # An optional memo to attach to the credit note.
         memo: nil,
-        # An optional reason for the credit note.
-        reason: nil,
         request_options: {}
       )
       end

data/rbi/orb/resources/customers/balance_transactions.rbi

@@ -47,13 +47,6 @@ module Orb
         # This endpoint retrieves all customer balance transactions in reverse
         # chronological order for a single customer, providing a complete audit trail of
         # all adjustments and invoice applications.
-        #
-        # ## Eligibility
-        #
-        # The customer balance can only be applied to invoices or adjusted manually if
-        # invoices are not synced to a separate invoicing provider. If a payment gateway
-        # such as Stripe is used, the balance will be applied to the invoice before
-        # forwarding payment to the gateway.
         sig do
           params(
             customer_id: String,

data/rbi/orb/resources/customers/credits/top_ups.rbi

@@ -45,7 +45,7 @@ module Orb
             # threshold, the top-up will be triggered.
             threshold:,
             # The date from which the top-up is active. If unspecified, the top-up is active
-            # immediately.
+            # immediately. This should not be more than 10 days in the past.
             active_from: nil,
             # The number of days or months after which the top-up expires. If unspecified, it
             # does not expire.
@@ -134,7 +134,7 @@ module Orb
             # threshold, the top-up will be triggered.
             threshold:,
             # The date from which the top-up is active. If unspecified, the top-up is active
-            # immediately.
+            # immediately. This should not be more than 10 days in the past.
             active_from: nil,
             # The number of days or months after which the top-up expires. If unspecified, it
             # does not expire.

data/rbi/orb/resources/customers.rbi

@@ -54,7 +54,8 @@ module Orb
             T.nilable(
               T.any(
                 Orb::CustomerCreateParams::TaxConfiguration::Avalara::OrHash,
-                Orb::CustomerCreateParams::TaxConfiguration::Taxjar::OrHash
+                Orb::CustomerCreateParams::TaxConfiguration::Taxjar::OrHash,
+                Orb::CustomerCreateParams::TaxConfiguration::Sphere::OrHash
               )
             ),
           tax_id: T.nilable(Orb::CustomerCreateParams::TaxID::OrHash),
@@ -252,7 +253,8 @@ module Orb
             T.nilable(
               T.any(
                 Orb::CustomerUpdateParams::TaxConfiguration::Avalara::OrHash,
-                Orb::CustomerUpdateParams::TaxConfiguration::Taxjar::OrHash
+                Orb::CustomerUpdateParams::TaxConfiguration::Taxjar::OrHash,
+                Orb::CustomerUpdateParams::TaxConfiguration::Sphere::OrHash
               )
             ),
           tax_id: T.nilable(Orb::CustomerUpdateParams::TaxID::OrHash),
@@ -453,10 +455,7 @@ module Orb
       # **Note**: This operation happens asynchronously and can be expected to take a
       # few minutes to propagate to related resources. However, querying for the
       # customer on subsequent GET requests while deletion is in process will reflect
-      # its deletion with a `deleted: true` property. Once the customer deletion has
-      # been fully processed, the customer will not be returned in the API.
-      #
-      # On successful processing, this returns an empty dictionary (`{}`) in the API.
+      # its deletion.
       sig do
         params(
           customer_id: String,
@@ -570,7 +569,8 @@ module Orb
             T.nilable(
               T.any(
                 Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Avalara::OrHash,
-                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar::OrHash
+                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar::OrHash,
+                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Sphere::OrHash
               )
             ),
           tax_id:

data/rbi/orb/resources/dimensional_price_groups.rbi

@@ -17,7 +17,7 @@ module Orb
       # For example, suppose we have a billable metric that measures the number of
       # widgets used and we want to charge differently depending on the color of the
       # widget. We can create a price group with a dimension "color" and two prices: one
-      # that charges $10 per red widget and one that charges $20 per blue widget.
+      # that charges \$10 per red widget and one that charges \$20 per blue widget.
       sig do
         params(
           billable_metric_id: String,

data/rbi/orb/resources/items.rbi

@@ -7,12 +7,17 @@ module Orb
       sig do
         params(
           name: String,
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Item)
       end
       def create(
         # The name of the item.
         name:,
+        # User-specified key/value pairs for the resource. 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: nil,
         request_options: {}
       )
       end
@@ -25,6 +30,7 @@ module Orb
             T.nilable(
               T::Array[Orb::ItemUpdateParams::ExternalConnection::OrHash]
             ),
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
           name: T.nilable(String),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Item)
@@ -32,6 +38,10 @@ module Orb
       def update(
         item_id,
         external_connections: nil,
+        # User-specified key/value pairs for the resource. 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: nil,
         name: nil,
         request_options: {}
       )
@@ -56,6 +66,16 @@ module Orb
       )
       end
 
+      # Archive item
+      sig do
+        params(
+          item_id: String,
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::Item)
+      end
+      def archive(item_id, request_options: {})
+      end
+
       # This endpoint returns an item identified by its item_id.
       sig do
         params(

data/rbi/orb/resources/plans/external_plan_id.rbi

@@ -7,7 +7,7 @@ module Orb
         # This endpoint can be used to update the `external_plan_id`, and `metadata` of an
         # existing plan.
         #
-        # Other fields on a customer are currently immutable.
+        # Other fields on a plan are currently immutable.
         sig do
           params(
             other_external_plan_id: String,

data/rbi/orb/resources/plans.rbi

@@ -38,7 +38,10 @@ module Orb
                 Orb::PlanCreateParams::Price::MaxGroupTieredPackage::OrHash,
                 Orb::PlanCreateParams::Price::ScalableMatrixWithUnitPricing::OrHash,
                 Orb::PlanCreateParams::Price::ScalableMatrixWithTieredPricing::OrHash,
-                Orb::PlanCreateParams::Price::CumulativeGroupedBulk::OrHash
+                Orb::PlanCreateParams::Price::CumulativeGroupedBulk::OrHash,
+                Orb::PlanCreateParams::Price::TieredPackageWithMinimum::OrHash,
+                Orb::PlanCreateParams::Price::MatrixWithAllocation::OrHash,
+                Orb::PlanCreateParams::Price::GroupedTiered::OrHash
               )
             ],
           default_invoice_memo: T.nilable(String),
@@ -78,7 +81,7 @@ module Orb
       # This endpoint can be used to update the `external_plan_id`, and `metadata` of an
       # existing plan.
       #
-      # Other fields on a customer are currently immutable.
+      # Other fields on a plan are currently immutable.
       sig do
         params(
           plan_id: String,

data/rbi/orb/resources/prices.rbi

@@ -7,7 +7,7 @@ module Orb
       attr_reader :external_price_id
 
       # This endpoint is used to create a [price](/product-catalog/price-configuration).
-      # A price created using this endpoint is always an add-on, meaning that it’s not
+      # A price created using this endpoint is always an add-on, meaning that it's not
       # associated with a specific plan and can instead be individually added to
       # subscriptions, including subscriptions on different plans.
       #
@@ -60,6 +60,10 @@ module Orb
               Orb::PriceCreateParams::BillingCycleConfiguration::OrHash
             ),
           conversion_rate: T.nilable(Float),
+          dimensional_price_configuration:
+            T.nilable(
+              Orb::PriceCreateParams::DimensionalPriceConfiguration::OrHash
+            ),
           external_price_id: T.nilable(String),
           fixed_price_quantity: T.nilable(Float),
           invoice_grouping_key: T.nilable(String),
@@ -120,6 +124,8 @@ module Orb
         billing_cycle_configuration: nil,
         # The per unit conversion rate of the price currency to the invoicing currency.
         conversion_rate: nil,
+        # For dimensional price: specifies a price group and dimension values
+        dimensional_price_configuration: nil,
         # An alias for the price.
         external_price_id: nil,
         # If the Price represents a fixed cost, this represents the quantity of units
@@ -177,6 +183,10 @@ module Orb
       )
       end
 
+      # [NOTE] It is recommended to use the `/v1/prices/evaluate` which offers further
+      # functionality, such as multiple prices, inline price definitions, and querying
+      # over preview events.
+      #
       # This endpoint is used to evaluate the output of a price for a given customer and
       # time range. It enables filtering and grouping the output using
       # [computed properties](/extensibility/advanced-metrics#computed-properties),
@@ -232,6 +242,68 @@ module Orb
       )
       end
 
+      # This endpoint is used to evaluate the output of price(s) for a given customer
+      # and time range over either ingested events or preview events. It enables
+      # filtering and grouping the output using
+      # [computed properties](/extensibility/advanced-metrics#computed-properties),
+      # supporting the following workflows:
+      #
+      # 1. Showing detailed usage and costs to the end customer.
+      # 2. Auditing subtotals on invoice line items.
+      #
+      # Prices may either reference existing prices in your Orb account or be defined
+      # inline in the request body. Up to 100 prices can be evaluated in a single
+      # request.
+      #
+      # Price evaluation by default uses ingested events, but you can also provide a
+      # list of preview events to use instead. Up to 500 preview events can be provided
+      # in a single request. When using ingested events, the start of the time range
+      # must be no more than 100 days ago.
+      #
+      # For these workflows, the expressiveness of computed properties in both the
+      # filters and grouping is critical. For example, if you'd like to show your
+      # customer their usage grouped by hour and another property, you can do so with
+      # the following `grouping_keys`:
+      # `["hour_floor_timestamp_millis(timestamp_millis)", "my_property"]`. If you'd
+      # like to examine a customer's usage for a specific property value, you can do so
+      # with the following `filter`:
+      # `my_property = 'foo' AND my_other_property = 'bar'`.
+      #
+      # The length of the results must be no greater than 1000. Note that this is a POST
+      # endpoint rather than a GET endpoint because it employs a JSON body rather than
+      # query parameters.
+      sig do
+        params(
+          timeframe_end: Time,
+          timeframe_start: Time,
+          customer_id: T.nilable(String),
+          events:
+            T.nilable(
+              T::Array[Orb::PriceEvaluateMultipleParams::Event::OrHash]
+            ),
+          external_customer_id: T.nilable(String),
+          price_evaluations:
+            T::Array[Orb::PriceEvaluateMultipleParams::PriceEvaluation::OrHash],
+          request_options: Orb::RequestOptions::OrHash
+        ).returns(Orb::Models::PriceEvaluateMultipleResponse)
+      end
+      def evaluate_multiple(
+        # The exclusive upper bound for event timestamps
+        timeframe_end:,
+        # The inclusive lower bound for event timestamps
+        timeframe_start:,
+        # The ID of the customer to which this evaluation is scoped.
+        customer_id: nil,
+        # Optional list of preview events to use instead of actual usage data (max 500)
+        events: nil,
+        # The external customer ID of the customer to which this evaluation is scoped.
+        external_customer_id: nil,
+        # List of prices to evaluate (max 100)
+        price_evaluations: nil,
+        request_options: {}
+      )
+      end
+
       # This endpoint returns a price given an identifier.
       sig do
         params(