Endpoints
Read pricing
Read current rates, sizes, trial terms, and admission tiers without authentication.
GET
/
v1
/
pricing
curl --request GET \
--url "https://api.bead.run/v1/pricing"
{
"version": "<string>",
"currency": "<string>",
"tax": "<string>",
"default_size": "<string>",
"term": {
"kind": "<string>",
"days": 123,
"activation_ms": 123
},
"units": {
"gib_bytes": 123,
"credit_units_per_usd": 123
},
"rates": {
"cpu": {
"unit": "<string>",
"usd": "<string>",
"meter": "<string>",
"boundary": "<string>",
"while": "<string>",
"month_hours": 123,
"applies_to": "<string>"
},
"memory": {
"unit": "<string>",
"usd": "<string>",
"meter": "<string>",
"boundary": "<string>",
"while": "<string>",
"month_hours": 123,
"applies_to": "<string>"
},
"storage": {
"unit": "<string>",
"usd": "<string>",
"meter": "<string>",
"boundary": "<string>",
"while": "<string>",
"month_hours": 123,
"applies_to": "<string>"
},
"desktop": {
"unit": "<string>",
"usd": "<string>",
"meter": "<string>",
"boundary": "<string>",
"while": "<string>",
"month_hours": 123,
"applies_to": "<string>"
},
"operations": {
"usd": "<string>"
},
"egress": {
"usd_per_gib": "<string>",
"policy": "<string>"
}
},
"permanent_rates": {
"cpu": "<string>",
"memory": "<string>"
},
"shapes": [
{
"id": "<string>",
"vcpus": 123,
"memory_mib": 123,
"disk_gb": 123,
"disk_allocation_gib": 123,
"warm": true,
"concurrency": 123,
"compute_cap_usd_per_hour": "<string>",
"busy_usd_per_hour": "<string>",
"waiting_usd_per_hour": "<string>"
}
],
"caps": {
"optional": true,
"scope": "<string>"
},
"trial": {
"amount_minor": 123,
"expires_days": 123,
"once_per_org": true,
"enrollment": "<string>",
"cash_redeemable": true,
"spend_order": "<string>",
"sizes": [
"<string>"
]
},
"limits": {
"window": "<string>",
"currency": "<string>",
"units_per_dollar": 123,
"burst_requires_opt_in": true,
"burst_charged_once_per_extra_start": true,
"hard_batch_maximum": {
"fleet": 123,
"fork": 123,
"swarm": 123
},
"tiers": [
{
"name": "<string>",
"minimum_spend_minor": 123,
"verified": true,
"policy": {
"max_vcpus": 123,
"max_memory_mib": 123,
"starts_minute": 123,
"starts_hour": 123,
"starts_day": 123,
"concurrent_per_shape": 123,
"saved_templates": 123,
"batch_size": 123,
"burst_multiple": 123,
"burst_units": 123,
"shape_limits": {}
}
}
]
},
"regions": [
"<string>"
],
"templates": [
{
"templateID": "<string>",
"default_kind": "<string>"
}
],
"estimator": {
"month_hours": 123,
"memory": "<string>",
"storage": "<string>",
"trial_applied": true
},
"capabilities": {
"discounted_shared_fork_billing": true,
"off_host_durability": true
}
}Run
bead pricing or call GET /v1/pricing for current rates.
Authentication
This endpoint is public and does not require authentication.curl --request GET \
--url "https://api.bead.run/v1/pricing"
Response
200
Live tariff and available machine sizes.string
required
Current tariff version.
string
required
Billing currency.
string
required
Whether tax is included in displayed rates.
string
required
Size selected when no name or dimensions are supplied.
object
required
object
required
object
required
Current unit prices.
Show Properties
Show Properties
object
required
One rate in the active tariff.
Show Properties
Show Properties
string
Usage unit priced by this rate.
string
USD price per usage unit.
string
Usage meter identifier, when this rate uses a measured meter.
string
Usage included in this rate.
string
Machine state in which this rate applies.
integer
Hours in one billed storage month.
string
Templates or features charged by this add-on.
object
required
One rate in the active tariff.
Show Properties
Show Properties
string
Usage unit priced by this rate.
string
USD price per usage unit.
string
Usage meter identifier, when this rate uses a measured meter.
string
Usage included in this rate.
string
Machine state in which this rate applies.
integer
Hours in one billed storage month.
string
Templates or features charged by this add-on.
object
required
One rate in the active tariff.
Show Properties
Show Properties
string
Usage unit priced by this rate.
string
USD price per usage unit.
string
Usage meter identifier, when this rate uses a measured meter.
string
Usage included in this rate.
string
Machine state in which this rate applies.
integer
Hours in one billed storage month.
string
Templates or features charged by this add-on.
object
One rate in the active tariff.
Show Properties
Show Properties
string
Usage unit priced by this rate.
string
USD price per usage unit.
string
Usage meter identifier, when this rate uses a measured meter.
string
Usage included in this rate.
string
Machine state in which this rate applies.
integer
Hours in one billed storage month.
string
Templates or features charged by this add-on.
object
object[]
required
Available machine sizes and hourly compute quotes.
Show Properties
Show Properties
string
required
Size name.
integer
required
CPU count.
integer
required
Configured memory in MiB.
integer
required
Advertised usable disk in GiB.
integer
required
Allocated disk in GiB including image and filesystem metadata.
boolean
required
Whether the size supports warm capacity.
integer
required
Catalog concurrency for this size.
string
Maximum compute charge for a fully busy hour under the current tariff.
string
Compute quote for a fully busy hour.
string
Compute quote for an idle running hour.
object
required
object
required
Trial credit eligibility and spending terms.
Show Properties
Show Properties
integer
required
Trial amount in minor currency units.
integer
required
Trial lifetime in days.
boolean
required
Whether trial credit is granted once per organization.
string
required
Enrollment requirements.
boolean
required
Whether trial credit can be redeemed for cash.
string
required
Order in which trial and paid credit are consumed.
string[]
required
Machine sizes eligible for trial funding.
object
required
Admission tier catalog.
Show Properties
Show Properties
string
required
UTC windows used for admission counting.
string
required
Currency used for tier thresholds.
integer
required
Credit units per USD.
boolean
required
Whether burst starts require consent.
boolean
required
Whether a burst fee is charged once for each extra start.
object
required
object[]
required
Available admission tiers.
Show Properties
Show Properties
string
required
Tier name.
integer
required
Minimum spend to qualify in minor currency units.
boolean
required
Whether verification is required.
object
required
Admission policy applied to your organization.
Show Properties
Show Properties
integer
Maximum CPU count per machine, when constrained.
integer
Maximum memory per machine in MiB, when constrained.
integer
required
Allowed starts in a UTC minute.
integer
required
Allowed starts in a UTC hour.
integer
required
Allowed starts in a UTC day.
integer
required
Maximum concurrent machines per size.
integer
required
Maximum saved templates.
integer
required
Maximum attempts admitted in one batch.
integer
required
Multiplier for consented burst starts.
integer
required
Credit units charged per extra start.
object
required
Lower concurrency caps keyed by vCPUs-memoryMiB. Additional keys accept
integer values.string[]
required
Available region identifiers.
object[]
required
object
required
object
required
Errors
| Status | Meaning |
|---|---|
| 503 | Service or persistence is temporarily unavailable. |
⌘I
curl --request GET \
--url "https://api.bead.run/v1/pricing"
{
"version": "<string>",
"currency": "<string>",
"tax": "<string>",
"default_size": "<string>",
"term": {
"kind": "<string>",
"days": 123,
"activation_ms": 123
},
"units": {
"gib_bytes": 123,
"credit_units_per_usd": 123
},
"rates": {
"cpu": {
"unit": "<string>",
"usd": "<string>",
"meter": "<string>",
"boundary": "<string>",
"while": "<string>",
"month_hours": 123,
"applies_to": "<string>"
},
"memory": {
"unit": "<string>",
"usd": "<string>",
"meter": "<string>",
"boundary": "<string>",
"while": "<string>",
"month_hours": 123,
"applies_to": "<string>"
},
"storage": {
"unit": "<string>",
"usd": "<string>",
"meter": "<string>",
"boundary": "<string>",
"while": "<string>",
"month_hours": 123,
"applies_to": "<string>"
},
"desktop": {
"unit": "<string>",
"usd": "<string>",
"meter": "<string>",
"boundary": "<string>",
"while": "<string>",
"month_hours": 123,
"applies_to": "<string>"
},
"operations": {
"usd": "<string>"
},
"egress": {
"usd_per_gib": "<string>",
"policy": "<string>"
}
},
"permanent_rates": {
"cpu": "<string>",
"memory": "<string>"
},
"shapes": [
{
"id": "<string>",
"vcpus": 123,
"memory_mib": 123,
"disk_gb": 123,
"disk_allocation_gib": 123,
"warm": true,
"concurrency": 123,
"compute_cap_usd_per_hour": "<string>",
"busy_usd_per_hour": "<string>",
"waiting_usd_per_hour": "<string>"
}
],
"caps": {
"optional": true,
"scope": "<string>"
},
"trial": {
"amount_minor": 123,
"expires_days": 123,
"once_per_org": true,
"enrollment": "<string>",
"cash_redeemable": true,
"spend_order": "<string>",
"sizes": [
"<string>"
]
},
"limits": {
"window": "<string>",
"currency": "<string>",
"units_per_dollar": 123,
"burst_requires_opt_in": true,
"burst_charged_once_per_extra_start": true,
"hard_batch_maximum": {
"fleet": 123,
"fork": 123,
"swarm": 123
},
"tiers": [
{
"name": "<string>",
"minimum_spend_minor": 123,
"verified": true,
"policy": {
"max_vcpus": 123,
"max_memory_mib": 123,
"starts_minute": 123,
"starts_hour": 123,
"starts_day": 123,
"concurrent_per_shape": 123,
"saved_templates": 123,
"batch_size": 123,
"burst_multiple": 123,
"burst_units": 123,
"shape_limits": {}
}
}
]
},
"regions": [
"<string>"
],
"templates": [
{
"templateID": "<string>",
"default_kind": "<string>"
}
],
"estimator": {
"month_hours": 123,
"memory": "<string>",
"storage": "<string>",
"trial_applied": true
},
"capabilities": {
"discounted_shared_fork_billing": true,
"off_host_durability": true
}
}