Skip to main content
POST
Price a machine

Authorizations

X-API-Key
string
header
required

API key with "bl_" prefix (e.g. "bl_<api_key>")

Query Parameters

persist
boolean

Save a price computed for a shape the catalogue does not list, so later lookups return the same row. Defaults to true; false returns the same price without saving it.

Body

application/json

Machine to price

availability_zone
string
fallback_to_base_pricing
boolean
id
string
instance_type
string
operating_system
string
provider
enum<string>
Available options:
GCP,
AWS,
DigitalOcean,
Azure,
Hetzner,
OVHCloud,
PlanetScale,
STACKIT,
Linode,
Apple,
Base,
Agent37,
Akash,
Alibaba,
Archil,
Baseten,
Beam,
Blaxel,
Boat,
BoxCompute,
Boxd,
Bunny,
Cloudflare,
Collimate,
CreateOS,
CodeSandbox,
Daytona,
Docker,
E2B,
ExeDev,
Fly,
GravixLayer,
HuggingFace,
Inis,
Islo,
Isorun,
Krova,
LangSmith,
Leap0,
Lizard,
MIOSA,
Mosaic,
Promigence,
Railway,
RemoteHost,
Runloop,
Runtime,
Shellbox,
StateSet,
Superserve,
Tama,
Upstash,
Vercel,
Cerebrium,
CIRunners,
Civo,
Clore,
CoreWeave,
Crusoe,
CUDO,
DataCrunch,
DeepInfra,
Denvr,
E2ENetworks,
Exoscale,
Fal,
Freestyle,
HotAisle,
Hyperbolic,
Hyperstack,
IBM,
Lambda,
Latitude,
MassedCompute,
Microsandbox,
Modal,
Morph,
Nebius,
Northflank,
Novita,
Oblivus,
OCI,
OpenTelekom,
PrimeIntellect,
Replicate,
RunPod,
Sail,
Salad,
Scaleway,
Sesterce,
Shadeform,
Sprites,
Tenki,
Tensorlake,
ThunderCompute,
TogetherAI,
UpCloud,
Vast,
Vultr,
Zipbox
region
string
service
enum<string>
Available options:
ComputeEngine,
AmazonEC2,
Droplet,
AzureCompute,
AzureManagedDisks,
HetznerCompute,
OVHPublicCloud,
BaseCompute,
BaseDisks,
AmazonEBS,
AmazonRDS,
AmazonEKS,
KubernetesEngine,
AuroraDSQL,
CloudSQL,
AlloyDB,
CloudSpanner,
AzureDatabaseForPostgreSQL,
AzureDatabaseForMySQL,
AzureSQLDatabase,
AzureSQLManagedInstance,
PlanetScale,
ComputeEnginePersistentDisk,
STACKITCompute,
STACKITBlockStorage,
STACKITDatabase,
AkamaiLinode,
AkamaiBlockStorage,
AkamaiDatabase,
AppleMac,
AmazonAgentCoreCodeInterpreter,
AmazonAgentCoreRuntime,
AWSLambdaMicroVMs,
AzureContainerAppsSandboxes,
AgentPlatformSandbox,
AlibabaAgentSandbox,
DigitalOceanMicroVMs,
DigitalOceanHarnessRuntime,
Agent37Compute,
AkashCompute,
AlibabaCompute,
AlibabaBlockStorage,
ArchilCompute,
BasetenCompute,
BeamCompute,
BlaxelCompute,
BoatCompute,
BoxComputeCompute,
BoxdCompute,
BunnyCompute,
CloudflareCompute,
CollimateCompute,
CreateOSCompute,
CodeSandboxCompute,
DaytonaCompute,
DockerCompute,
E2BCompute,
ExeDevCompute,
FlyCompute,
GravixLayerCompute,
HuggingFaceCompute,
InisCompute,
IsloCompute,
IsorunCompute,
KrovaCompute,
LangSmithCompute,
Leap0Compute,
LizardCompute,
MIOSACompute,
MosaicCompute,
PromigenceCompute,
RailwayCompute,
RemoteHostCompute,
RunloopCompute,
RuntimeCompute,
ShellboxCompute,
StateSetCompute,
SuperserveCompute,
TamaCompute,
UpstashCompute,
VercelCompute,
CerebriumCompute,
CivoCompute,
CivoBlockStorage,
CloreCompute,
CoreWeaveCompute,
CrusoeCompute,
CUDOCompute,
DataCrunchCompute,
DeepInfraCompute,
DenvrCompute,
E2ENetworksCompute,
ExoscaleCompute,
ExoscaleBlockStorage,
FalCompute,
FreestyleCompute,
HotAisleCompute,
HyperbolicCompute,
HyperstackCompute,
IBMCompute,
IBMBlockStorage,
LambdaCompute,
LatitudeCompute,
MassedComputeCompute,
MicrosandboxCompute,
ModalCompute,
MorphCompute,
NebiusCompute,
NorthflankCompute,
NorthflankVolume,
NovitaCompute,
OblivusCompute,
OCICompute,
OCIBlockStorage,
OpenTelekomCompute,
PrimeIntellectCompute,
ReplicateCompute,
RunPodCompute,
SailCompute,
SaladCompute,
ScalewayCompute,
ScalewayBlockStorage,
SesterceCompute,
ShadeformCompute,
SpritesCompute,
TenkiCompute,
TensorlakeCompute,
ThunderComputeCompute,
TogetherAICompute,
UpCloudCompute,
UpCloudBlockStorage,
VastCompute,
VultrCompute,
VultrBlockStorage,
ZipboxCompute
usage_type
enum<string>
Available options:
SPOT_PREEMPTIBLE,
ONDEMAND,
RESERVED,
ONDEMAND_CUSTOM,
SPOT_PREEMPTIBLE_CUSTOM,
RESERVED_CUSTOM,
SOLE_TENANCY,
CUSTOM,
EXTENDED
vm
object

Response

The resolved price

architecture
string
availability_zone
string
cost_per_hour
number

On-demand-equivalent hourly USD; multiply by provider_pricing_rules.month_hours for monthly.

cpu_cores
number
cpu_cores_cost_per_hour
number
created_at
string
currency
string

Currency the provider published this price in. Cost columns are always normalized USD.

ephemeral_storage_gb_cost_per_hour
number | null
gpu_cost_per_hour
number
gpu_count
number
gpu_type
string
id
string
instance_type
string
native_cost_per_hour
number

cost_per_hour as published, before FX normalization. Zero when currency is USD.

operating_system
string
period_billing_hours
number

Commitment term the raw price covers: 1=hourly on-demand; 8640/25920/43200=1mo/3mo/1yr buckets. cost_per_hour is already normalized to hourly.

provider
string
ram_gb
number
ram_gb_cost_per_hour
number
raw_pricing_data
object
region
string
resizable
boolean | null

True when the row carries per-vCPU and per-GB rates for a shape sized at launch; resolution stores and returns a row priced at the requested vCPU and memory. NULL or false is a fixed-size shape.

service
string
tags
object
updated_at
string
usage_type
string

Pricing tier token (ONDEMAND, RESERVED, SPOT_*, *_HBP, *_BYOL, Commit1Yr/3Yr). Filter to ONDEMAND for normal pricing.