> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bead.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Read pricing

> Read current rates, sizes, trial terms, and admission tiers without authentication.

Run `bead pricing` or call `GET /v1/pricing` for current rates.

## Authentication

This endpoint is public and does not require authentication.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
curl --request GET \
  --url "https://api.bead.run/v1/pricing"
```

## Response

### 200

Live tariff and available machine sizes.

**version** `string` *required*

Current tariff version.

**currency** `string` *required*

Billing currency.

**tax** `string` *required*

Whether tax is included in displayed rates.

**default\_size** `string` *required*

Size selected when no name or dimensions are supplied.

**term** `object` *required*

Current permanent pricing term.

**Properties**

**kind** `string` *required*

Term category.

**days** `integer`

Legacy term length in days, when returned.

**activation\_ms** `integer`

Tariff activation in Unix milliseconds.

**units** `object` *required*

Units used by pricing and prepaid credit.

**Properties**

**gib\_bytes** `integer` *required*

Bytes in one GiB.

**credit\_units\_per\_usd** `integer` *required*

Credit units in one USD.

**rates** `object` *required*

Current unit prices.

**Properties**

**cpu** `object` *required*

One rate in the active tariff.

**Properties**

**unit** `string`

Usage unit priced by this rate.

**usd** `string`

USD price per usage unit.

**meter** `string`

Usage meter identifier, when this rate uses a measured meter.

**boundary** `string`

Usage included in this rate.

**while** `string`

Machine state in which this rate applies.

**month\_hours** `integer`

Hours in one billed storage month.

**applies\_to** `string`

Templates or features charged by this add-on.

**memory** `object` *required*

One rate in the active tariff.

**Properties**

**unit** `string`

Usage unit priced by this rate.

**usd** `string`

USD price per usage unit.

**meter** `string`

Usage meter identifier, when this rate uses a measured meter.

**boundary** `string`

Usage included in this rate.

**while** `string`

Machine state in which this rate applies.

**month\_hours** `integer`

Hours in one billed storage month.

**applies\_to** `string`

Templates or features charged by this add-on.

**storage** `object` *required*

One rate in the active tariff.

**Properties**

**unit** `string`

Usage unit priced by this rate.

**usd** `string`

USD price per usage unit.

**meter** `string`

Usage meter identifier, when this rate uses a measured meter.

**boundary** `string`

Usage included in this rate.

**while** `string`

Machine state in which this rate applies.

**month\_hours** `integer`

Hours in one billed storage month.

**applies\_to** `string`

Templates or features charged by this add-on.

**desktop** `object`

One rate in the active tariff.

**Properties**

**unit** `string`

Usage unit priced by this rate.

**usd** `string`

USD price per usage unit.

**meter** `string`

Usage meter identifier, when this rate uses a measured meter.

**boundary** `string`

Usage included in this rate.

**while** `string`

Machine state in which this rate applies.

**month\_hours** `integer`

Hours in one billed storage month.

**applies\_to** `string`

Templates or features charged by this add-on.

**operations** `object` *required*

Operation pricing.

**Properties**

**usd** `string` *required*

USD per operation.

**egress** `object` *required*

Outbound traffic pricing.

**Properties**

**usd\_per\_gib** `string` *required*

USD per GiB sent.

**policy** `string` *required*

Egress usage policy.

**permanent\_rates** `object`

Permanent CPU and memory rates.

**Properties**

**cpu** `string`

USD per CPU hour.

**memory** `string`

USD per configured GiB hour.

**shapes** `object[]` *required*

Available machine sizes and hourly compute quotes.

**Properties**

**id** `string` *required*

Size name.

**vcpus** `integer` *required*

CPU count.

**memory\_mib** `integer` *required*

Configured memory in MiB.

**disk\_gb** `integer` *required*

Advertised usable disk in GiB.

**disk\_allocation\_gib** `integer` *required*

Allocated disk in GiB including image and filesystem metadata.

**warm** `boolean` *required*

Whether the size supports warm capacity.

**concurrency** `integer` *required*

Catalog concurrency for this size.

**compute\_cap\_usd\_per\_hour** `string`

Maximum compute charge for a fully busy hour under the current tariff.

**busy\_usd\_per\_hour** `string`

Compute quote for a fully busy hour.

**waiting\_usd\_per\_hour** `string`

Compute quote for an idle running hour.

**caps** `object` *required*

Compute cap coverage.

**Properties**

**optional** `boolean` *required*

Whether a compute cap is optional.

**scope** `string` *required*

Usage included in the compute cap.

**trial** `object` *required*

Trial credit eligibility and spending terms.

**Properties**

**amount\_minor** `integer` *required*

Trial amount in minor currency units.

**expires\_days** `integer` *required*

Trial lifetime in days.

**once\_per\_org** `boolean` *required*

Whether trial credit is granted once per organization.

**enrollment** `string` *required*

Enrollment requirements.

**cash\_redeemable** `boolean` *required*

Whether trial credit can be redeemed for cash.

**spend\_order** `string` *required*

Order in which trial and paid credit are consumed.

**sizes** `string[]` *required*

Machine sizes eligible for trial funding.

**limits** `object` *required*

Admission tier catalog.

**Properties**

**window** `string` *required*

UTC windows used for admission counting.

**currency** `string` *required*

Currency used for tier thresholds.

**units\_per\_dollar** `integer` *required*

Credit units per USD.

**burst\_requires\_opt\_in** `boolean` *required*

Whether burst starts require consent.

**burst\_charged\_once\_per\_extra\_start** `boolean` *required*

Whether a burst fee is charged once for each extra start.

**hard\_batch\_maximum** `object` *required*

Absolute batch bounds before account policy.

**Properties**

**fleet** `integer` *required*

Maximum fleet batch size.

**fork** `integer` *required*

Maximum fork batch size.

**swarm** `integer` *required*

Maximum swarm batch size.

**tiers** `object[]` *required*

Available admission tiers.

**Properties**

**name** `string` *required*

Tier name.

**minimum\_spend\_minor** `integer` *required*

Minimum spend to qualify in minor currency units.

**verified** `boolean` *required*

Whether verification is required.

**policy** `object` *required*

Admission policy applied to your organization.

**Properties**

**max\_vcpus** `integer`

Maximum CPU count per machine, when constrained.

**max\_memory\_mib** `integer`

Maximum memory per machine in MiB, when constrained.

**starts\_minute** `integer` *required*

Allowed starts in a UTC minute.

**starts\_hour** `integer` *required*

Allowed starts in a UTC hour.

**starts\_day** `integer` *required*

Allowed starts in a UTC day.

**concurrent\_per\_shape** `integer` *required*

Maximum concurrent machines per size.

**saved\_templates** `integer` *required*

Maximum saved templates.

**batch\_size** `integer` *required*

Maximum attempts admitted in one batch.

**burst\_multiple** `integer` *required*

Multiplier for consented burst starts.

**burst\_units** `integer` *required*

Credit units charged per extra start.

**shape\_limits** `object` *required*

Lower concurrency caps keyed by vCPUs-memoryMiB. Additional keys accept `integer` values.

**regions** `string[]` *required*

Available region identifiers.

**templates** `object[]` *required*

Published template identifiers and lifetime defaults.

**Properties**

**templateID** `string` *required*

Published template ID.

**default\_kind** `string` *required*

Default machine lifetime for this template. Allowed values: `"temporary"`, `"persistent"`.

**estimator** `object` *required*

Assumptions used by monthly quotes.

**Properties**

**month\_hours** `integer` *required*

Hours assumed in a month.

**memory** `string` *required*

Memory usage assumption.

**storage** `string` *required*

Retained storage assumption.

**trial\_applied** `boolean` *required*

Whether quotes subtract trial credit.

**capabilities** `object` *required*

Billing and durability capabilities.

**Properties**

**discounted\_shared\_fork\_billing** `boolean` *required*

Whether fork children receive shared resource billing discounts.

**off\_host\_durability** `boolean` *required*

Whether remote durability is advertised by this catalog.

## Errors

| Status | Meaning |
| - | - |
| 503 | Service or persistence is temporarily unavailable. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.