Prices API — set pricing for your products

A price defines how much and how often you charge for a product. Each price belongs to a product and specifies a type of either one_time or recurring. Recurring prices support flexible intervals, tiered pricing structures, and metered usage billing. Once a price is created, its core monetary fields are immutable — create a new price if you need to change the amount.

Create a price

POST /v1/prices Creates a new price for an existing product.

Request parameters

string

required

The ID of the product this price belongs to (e.g. prod_xxx).

string

Three-letter ISO 4217 currency code (e.g. ISK, EUR, USD). Defaults to the merchant’s default currency.

string

required

Pricing type. One of one_time or recurring.

number

Price per unit in the currency’s smallest unit. Minimum value is 0. Required when tiers_mode is not set.

object

Required when type is recurring. Defines the billing interval.

Show properties

string

required

Billing interval. One of day, week, month, or year.

number

Number of intervals between billing cycles. For example, interval: "month" and interval_count: 3 bills every three months. Defaults to 1.

string

How usage is determined for metered prices. One of licensed (fixed quantity per period) or metered (sum of usage events). Defaults to licensed.

string

How usage events are aggregated for metered prices. One of sum, max, or last_during_period.

string

Enables tiered pricing. One of graduated (each tier applies to usage within that range) or volume (the tier price applies to the entire quantity based on total usage).

object[]

Array of tier objects. Required when tiers_mode is set.

Show tier properties

number

Upper bound for this tier. Use null to indicate the final open-ended tier.

number

Price per unit within this tier.

number

Fixed fee charged for this tier regardless of quantity.

string

ID of the meter to use for metered usage billing. Required when recurring.usage_type is metered.

number

Number of units included in the base price before metered usage billing begins.

string

GL account code to associate with this price for accounting export.

object

Set of key-value pairs you can attach to the price. Values must be strings.

One-time price
Recurring price

curl --request POST \
  --url https://api.borga.is/v1/prices \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx" \
  --header "Content-Type: application/json" \
  --data '{
    "product": "prod_01hx9z3k2mfq7nbvd4cw8ej5rt",
    "currency": "ISK",
    "type": "one_time",
    "unit_amount": 9900,
    "accounting_code": "4000"
  }'

curl --request POST \
  --url https://api.borga.is/v1/prices \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx" \
  --header "Content-Type: application/json" \
  --data '{
    "product": "prod_01hx9z3k2mfq7nbvd4cw8ej5rt",
    "currency": "ISK",
    "type": "recurring",
    "unit_amount": 4990,
    "recurring": {
      "interval": "month",
      "interval_count": 1,
      "usage_type": "licensed"
    },
    "accounting_code": "4000"
  }'

Response fields

string

required

Unique identifier for the price (e.g. price_xxx).

string

required

ID of the associated product.

string

required

Three-letter ISO 4217 currency code.

string

required

Pricing type. One of one_time or recurring.

number

Price per unit. null when tiers_mode is set.

object

Recurring billing configuration. null for one-time prices.

Show properties

string

required

Billing interval.

number

required

Number of intervals between billing cycles.

string

required

Usage type: licensed or metered.

string

Aggregation method for metered usage.

string

Tier mode: graduated or volume. null if not using tiered pricing.

object[]

Array of tier configuration objects. null if not using tiered pricing.

string

ID of the associated meter, if applicable.

boolean

required

Whether the price is currently active.

object

Key-value pairs attached to the price.

{
  "id": "price_01hx9z3k2mfq7nbvd4cw8ej5rt",
  "product": "prod_01hx9z3k2mfq7nbvd4cw8ej5rt",
  "currency": "ISK",
  "type": "recurring",
  "unit_amount": 4990,
  "recurring": {
    "interval": "month",
    "interval_count": 1,
    "usage_type": "licensed",
    "aggregate_usage": null
  },
  "tiers_mode": null,
  "tiers": null,
  "meter": null,
  "active": true,
  "metadata": {},
  "created_at": "2026-04-29T10:15:00Z"
}

List prices

GET /v1/prices Returns a paginated list of prices, ordered by creation date descending.

Query parameters

string

Filter prices by product ID.

string

Cursor for pagination. Pass the id of the last price from the previous page to retrieve the next page.

number

Maximum number of prices to return per page.

curl --request GET \
  --url "https://api.borga.is/v1/prices?product=prod_01hx9z3k2mfq7nbvd4cw8ej5rt&limit=20" \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

object[]

required

Array of price objects.

boolean

required

Whether more prices exist beyond this page.

{
  "data": [
    {
      "id": "price_01hx9z3k2mfq7nbvd4cw8ej5rt",
      "product": "prod_01hx9z3k2mfq7nbvd4cw8ej5rt",
      "currency": "ISK",
      "type": "recurring",
      "unit_amount": 4990,
      "recurring": {
        "interval": "month",
        "interval_count": 1,
        "usage_type": "licensed",
        "aggregate_usage": null
      },
      "active": true,
      "metadata": {}
    }
  ],
  "has_more": false
}

Retrieve a price

GET /v1/prices/{id} Retrieves the details of an existing price.

Path parameters

string

required

The ID of the price to retrieve.

curl --request GET \
  --url https://api.borga.is/v1/prices/price_01hx9z3k2mfq7nbvd4cw8ej5rt \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

Returns a price object. See create a price for the full field reference.

{
  "id": "price_01hx9z3k2mfq7nbvd4cw8ej5rt",
  "product": "prod_01hx9z3k2mfq7nbvd4cw8ej5rt",
  "currency": "ISK",
  "type": "recurring",
  "unit_amount": 4990,
  "recurring": {
    "interval": "month",
    "interval_count": 1,
    "usage_type": "licensed",
    "aggregate_usage": null
  },
  "tiers_mode": null,
  "tiers": null,
  "meter": null,
  "active": true,
  "metadata": {},
  "created_at": "2026-04-29T10:15:00Z"
}

Update a price

PATCH /v1/prices/{id} Updates a price. Only active, accounting_code, and metadata can be modified after creation. To change the amount, currency, or interval, create a new price.

Path parameters

string

required

The ID of the price to update.

Request parameters

boolean

Set to false to deactivate this price. Deactivating does not affect subscriptions already using it.

string

Updated GL account code.

object

Updated metadata. Replaces the existing metadata object entirely.

curl --request PATCH \
  --url https://api.borga.is/v1/prices/price_01hx9z3k2mfq7nbvd4cw8ej5rt \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx" \
  --header "Content-Type: application/json" \
  --data '{
    "active": false,
    "accounting_code": "4001"
  }'

Response fields

Returns the updated price object. See retrieve a price for the full field reference.

{
  "id": "price_01hx9z3k2mfq7nbvd4cw8ej5rt",
  "product": "prod_01hx9z3k2mfq7nbvd4cw8ej5rt",
  "currency": "ISK",
  "type": "recurring",
  "unit_amount": 4990,
  "recurring": {
    "interval": "month",
    "interval_count": 1,
    "usage_type": "licensed",
    "aggregate_usage": null
  },
  "tiers_mode": null,
  "tiers": null,
  "meter": null,
  "active": false,
  "metadata": {},
  "created_at": "2026-04-29T10:15:00Z"
}

Overview

Payments

Subscriptions

Billing

Configuration

Prices API — set pricing for your products

Create a price

Request parameters

Response fields

List prices

Query parameters

Response fields

Retrieve a price

Path parameters

Response fields

Update a price

Path parameters

Request parameters

Response fields

​Create a price

​Request parameters

​Response fields

​List prices

​Query parameters

​Response fields

​Retrieve a price

​Path parameters

​Response fields

​Update a price

​Path parameters

​Request parameters

​Response fields

Create a price

Request parameters

Response fields

List prices

Query parameters

Response fields

Retrieve a price

Path parameters

Response fields

Update a price

Path parameters

Request parameters

Response fields