Get pricing

Retrieve the prices on your organization's plan, one entry per price point, grouped by the product sections of the Usage page 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 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.

GET https://betterstack.com/api/v2/pricing

Query parameters

category
string
product
string
region
string
organization_id
integer

Headers

Authorization
required string
200

Response 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"
      }
    }
  ]
}
200

Response 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
      }
    }
  ]
}
401

Response body

{
  "errors": "We could not authenticate your request. Please provide a valid Global API token or Better Stack OAuth token."
}
403

Response body

{
  "errors": "Your role does not allow viewing billing in this organization."
}
404

Response body

{
  "errors": "Organization 123456 not found."
}
422

Response body

{
  "errors": "You can access more than one organization. Select one with `organization_id`: 123456, 234567."
}

Response attributes

id
string
type
string
attributes.category
string or null
attributes.product
string
attributes.description
string
attributes.price
number or null
attributes.currency
string
attributes.quantity
number or null
attributes.unit
string or null
attributes.period
string or null
attributes.included
number or null
attributes.included_unit
string
attributes.region
string

Example cURL

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