GET
/
prices
/
{price_id}
Fetch price
curl --request GET \
  --url https://api.withorb.com/v1/prices/{price_id} \
  --header 'Authorization: Bearer <token>'
{
  "model_type": "unit",
  "unit_config": {
    "unit_amount": "<string>",
    "scaling_factor": 123
  },
  "metadata": {},
  "id": "<string>",
  "name": "<string>",
  "external_price_id": "<string>",
  "replaces_price_id": "<string>",
  "price_type": "usage_price",
  "created_at": "2023-11-07T05:31:56Z",
  "cadence": "one_time",
  "billing_cycle_configuration": {
    "duration": 123,
    "duration_unit": "day"
  },
  "invoicing_cycle_configuration": {
    "duration": 123,
    "duration_unit": "day"
  },
  "billable_metric": {
    "id": "<string>"
  },
  "dimensional_price_configuration": {
    "dimensional_price_group_id": "<string>",
    "dimension_values": [
      "<string>"
    ]
  },
  "fixed_price_quantity": 123,
  "plan_phase_order": 123,
  "currency": "<string>",
  "conversion_rate": 123,
  "conversion_rate_config": {
    "conversion_rate_type": "unit",
    "unit_config": {
      "unit_amount": "<string>"
    }
  },
  "item": {
    "id": "<string>",
    "name": "<string>"
  },
  "credit_allocation": {
    "currency": "<string>",
    "allows_rollover": true,
    "custom_expiration": {
      "duration": 123,
      "duration_unit": "day"
    }
  },
  "composite_price_filters": [
    {
      "field": "price_id",
      "operator": "includes",
      "values": [
        "<any>"
      ]
    }
  ],
  "discount": {
    "discount_type": "percentage",
    "applies_to_price_ids": [
      "h74gfhdjvn7ujokd",
      "7hfgtgjnbvc3ujkl"
    ],
    "filters": [
      {
        "field": "price_id",
        "operator": "includes",
        "values": [
          "<any>"
        ]
      }
    ],
    "reason": "<string>",
    "percentage_discount": 0.15
  },
  "minimum": {
    "minimum_amount": "<string>",
    "filters": [
      {
        "field": "price_id",
        "operator": "includes",
        "values": [
          "<any>"
        ]
      }
    ],
    "applies_to_price_ids": [
      "<string>"
    ]
  },
  "minimum_amount": "<string>",
  "maximum": {
    "maximum_amount": "<string>",
    "filters": [
      {
        "field": "price_id",
        "operator": "includes",
        "values": [
          "<any>"
        ]
      }
    ],
    "applies_to_price_ids": [
      "<string>"
    ]
  },
  "maximum_amount": "<string>"
}

Authorizations

​
Authorization
string
header
required

API Keys can be issued in the Orb's web application.

Path Parameters

​
price_id
string
required

Response

OK

The Price resource represents a price that can be billed on a subscription, resulting in a charge on an invoice in the form of an invoice line item. Prices take a quantity and determine an amount to bill.

Orb supports a few different pricing models out of the box. Each of these models is serialized differently in a given Price object. The model_type field determines the key for the configuration object that is present.

For more on the types of prices, see the core concepts documentation

​
model_type
enum<string>
required

The pricing model type

Available options:
unit
​
unit_config
object
required

Configuration for unit pricing

​
metadata
object
required

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.

​
id
string
required
​
name
string
required
​
external_price_id
string | null
required
​
replaces_price_id
string | null
required

The price id this price replaces. This price will take the place of the replaced price in plan version migrations.

​
price_type
enum<string>
required
Available options:
usage_price,
fixed_price,
composite_price
​
created_at
string<date-time>
required
​
cadence
enum<string>
required
Available options:
one_time,
monthly,
quarterly,
semi_annual,
annual,
custom
​
billing_cycle_configuration
object
required
​
invoicing_cycle_configuration
object | null
required
​
billable_metric
object | null
required
​
fixed_price_quantity
number | null
required
​
plan_phase_order
integer | null
required
​
currency
string
required
​
conversion_rate
number | null
required
​
conversion_rate_config
object | null
required
​
item
object
required
​
credit_allocation
object | null
required
​
composite_price_filters
TransformPriceFilter · object[] | null
required
​
discount
object | null
required
deprecated
​
minimum
object | null
required
deprecated
​
minimum_amount
string | null
required
deprecated
​
maximum
object | null
required
deprecated
​
maximum_amount
string | null
required
deprecated
​
dimensional_price_configuration
object | null