# Get pricing

Retrieve the prices on your organization's plan, one entry per price point, grouped by the product sections of the [Usage page](https://betterstack.com/settings/usage ";_blank") in your billing settings. Each entry carries the price, what it buys, and what your plan includes.

The pricing API accepts a [global API token](https://betterstack.com/docs/uptime/api/getting-started-with-uptime-api/#get-a-global-api-token) or a signed-in user's OAuth token. A user who belongs to more than one organization selects one with `organization_id`.

Results are returned without pagination.

[endpoint]
base_url = "https://betterstack.com"
path = "/api/v2/pricing"
method = "GET"

[[query_param]]
name = "category"
description = "Return only the prices in this category, by its name or its dashed form, for example `Incident management` or `incident-management`. Case doesn't matter."
required = false
type = "string"

[[query_param]]
name = "product"
description = "Return only the prices of this product, by its name, its dashed form or the product part of an `id`, for example `Monitors`, `monitors` or `status-pages`. Case doesn't matter."
required = false
type = "string"

[[query_param]]
name = "region"
description = "Return only the prices in this data region, for example `us_east` or `germany`. Dashes work in place of underscores."
required = false
type = "string"

[[query_param]]
name = "organization_id"
description = "The ID of the organization to read prices for. The error returned without it lists the IDs to choose from. Required with a user's OAuth token when the user belongs to more than one organization. Not accepted with a global API token, which belongs to one organization."
required = false
type = "integer"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"
[/endpoint]

[responses]
[[response]]
status = 200
description = '''Returns one entry per price point on your organization's plan.'''
body = '''{
  "data": [
    {
      "id": "monitors",
      "type": "price",
      "attributes": {
        "category": "Incident management",
        "product": "Monitors",
        "description": "Monitors",
        "price": 25,
        "currency": "USD",
        "quantity": 50,
        "unit": "monitor",
        "period": "month",
        "included": 10
      }
    },
    {
      "id": "ai-sre",
      "type": "price",
      "attributes": {
        "category": "Incident management",
        "product": "AI SRE",
        "description": "AI SRE is billed by model usage",
        "price": null,
        "currency": "USD",
        "quantity": null,
        "unit": null,
        "period": null,
        "included": null
      }
    },
    {
      "id": "logs-usage:retention:germany",
      "type": "price",
      "attributes": {
        "category": "Observability",
        "product": "Logs usage (Europe)",
        "description": "Logs data retention",
        "price": 0.05,
        "currency": "USD",
        "quantity": 1,
        "unit": "GB",
        "period": "month",
        "included": 3,
        "included_unit": "day",
        "region": "germany"
      }
    }
  ]
}'''

[[response]]
status = 200
description = '''On a plan that doesn't sell more monitors, the price is `null` and the entry shows what the plan includes.'''
body = '''{
  "data": [
    {
      "id": "monitors",
      "type": "price",
      "attributes": {
        "category": "Incident management",
        "product": "Monitors",
        "description": "Monitors",
        "price": null,
        "currency": "USD",
        "quantity": 50,
        "unit": "monitor",
        "period": "month",
        "included": 10
      }
    }
  ]
}'''

[[response]]
status = 401
description = '''Authentication failed due to a missing or invalid token.'''
body = '''{
  "errors": "We could not authenticate your request. Please provide a valid Global API token or Better Stack OAuth token."
}'''

[[response]]
status = 403
description = '''The token can't view prices for this organization.'''
body = '''{
  "errors": "Your role does not allow viewing billing in this organization."
}'''

[[response]]
status = 404
description = '''The `organization_id` isn't one of the user's organizations, or the user has no organization.'''
body = '''{
  "errors": "Organization 123456 not found."
}'''

[[response]]
status = 422
description = '''An unknown query parameter, a malformed `organization_id`, or a user in several organizations who didn't select one.'''
body = '''{
  "errors": "You can access more than one organization. Select one with `organization_id`: 123456, 234567."
}'''
[/responses]

[params]
title = "Response attributes"

[[param]]
name = "id"
type = "string"
description = "The ID of the price point. It starts with the product and adds the price point and the region where a product has several, for example `monitors` or `logs-usage:retention:germany`. IDs use dashes, so the `us_east` region appears as `us-east`."

[[param]]
name = "type"
type = "string"
description = "Always `price`."

[[param]]
name = "attributes.category"
type = "string or null"
description = "The section of the Usage page the product is listed under, for example `Incident management` or `Observability`, or `null` for a product listed outside a section."

[[param]]
name = "attributes.product"
type = "string"
description = "The name of the product, with its data region for a product priced per region, for example `Logs usage (Europe)`."

[[param]]
name = "attributes.description"
type = "string"
description = "What the price is for."

[[param]]
name = "attributes.price"
type = "number or null"
description = "The price of `quantity` units, or `null` when the plan doesn't sell more or the price depends on usage, such as AI SRE's per-model rates."

[[param]]
name = "attributes.currency"
type = "string"
description = "The currency of the price, always `USD`."

[[param]]
name = "attributes.quantity"
type = "number or null"
description = "How many units the price buys, for example `50` for a price per 50 monitors, or `null` when there is no price per unit."

[[param]]
name = "attributes.unit"
type = "string or null"
description = "The unit the price is for, for example `monitor` or `GB`, or `null` for a flat fee."

[[param]]
name = "attributes.period"
type = "string or null"
description = "How long the price lasts, for example `month` for a monthly fee or for data retention, or `null` for usage priced once, such as each GB ingested."

[[param]]
name = "attributes.included"
type = "number or null"
description = "How much the plan includes before the price applies, or `null` when nothing is included."

[[param]]
name = "attributes.included_unit"
type = "string"
description = "The unit of `included`, present only when it differs from `unit`, for example `day` for included data retention or `USD` for included spend."

[[param]]
name = "attributes.region"
type = "string"
description = "The data region the price applies to, for example `us_east` or `germany`, present only on prices that depend on a region."
[/params]

#### Example cURL

[code-tabs]
```shell
[label All prices]
curl --request GET \
  --url "https://betterstack.com/api/v2/pricing" \
  --header "Authorization: Bearer $TOKEN"
```
```shell
[label One product]
curl --request GET \
  --url "https://betterstack.com/api/v2/pricing" \
  --data-urlencode "product=monitors" \
  --header "Authorization: Bearer $TOKEN"
```
```shell
[label One organization]
curl --request GET \
  --url "https://betterstack.com/api/v2/pricing" \
  --data-urlencode "organization_id=123456" \
  --header "Authorization: Bearer $TOKEN"
```
[/code-tabs]
