---
title: "Get recommendations for compute instances"
method: POST
path: "/recommendations/compute"
---

# Get recommendations for compute instances

`POST /recommendations/compute`

Get the cheapest compute candidate per provider with savings versus the requested instance

## Request body

- TypesComputeRequest
  - `include_metadata` boolean
  - `instance` GithubComBaselinehqGolangSharedTypesInstance
    - `availability_zone` string
    - `fallback_to_base_pricing` boolean
    - `id` string
    - `instance_type` string
    - `operating_system` string
    - `provider` 'GCP' | 'AWS' | 'DigitalOcean' | 'Azure' | 'Hetzner' | 'OVHCloud' | 'Base'
    - `region` string
    - `service` 'ComputeEngine' | 'AmazonEC2' | 'Droplet' | 'AzureCompute' | 'AzureManagedDisks' | 'HetznerCompute' | 'OVHPublicCloud' | 'BaseCompute' | 'BaseDisks' | 'AmazonEBS' | 'ComputeEnginePersistentDisk'
    - `usage_type` 'SPOT_PREEMPTIBLE' | 'ONDEMAND' | 'RESERVED' | 'ONDEMAND_CUSTOM' | 'SPOT_PREEMPTIBLE_CUSTOM' | 'RESERVED_CUSTOM' | 'SOLE_TENANCY' | 'CUSTOM' | 'EXTENDED'
    - `vm` GithubComBaselinehqGolangSharedTypesVM
      - `cpu_cores` number
      - `ram_gb` number
  - `predicates` TypesPredicates
    - `availability_zones` string[]
    - `disk_types` string[]
    - `instance_types` string[]
    - `operating_systems` string[]
    - `providers` string[]
    - `regions` string[]
    - `services` string[]
    - `usage_types` string[]
  - `usage` GithubComBaselinehqGolangSharedTypesVM
    - `cpu_cores` number
    - `ram_gb` number

## Response `200`

OK

- RecommendationsComputeRecommendationResult[]
  - `pricing` SchemaComputePricingsRow
    - `architecture` string
    - `availability_zone` string
    - `cost_per_hour` number
    - `cpu_cores` number
    - `cpu_cores_cost_per_hour` number
    - `created_at` string
    - `id` string
    - `instance_type` string
    - `operating_system` string
    - `period_billing_hours` number
    - `provider` string
    - `ram_gb` number
    - `ram_gb_cost_per_hour` number
    - `raw_pricing_data` object
    - `region` string
    - `service` string
    - `tags` object
    - `updated_at` string
    - `usage_type` string
  - `savings` TypesSavings
    - `amount_per_hour` number
    - `amount_per_month` number
    - `amount_per_year` number
    - `percentage` number

## Other responses

- `400` — Invalid request body
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/baselinehq/apis/costgraph-pricing-api.md) · [All operations](https://skmtc.net/baselinehq/apis/costgraph-pricing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselinehq/costgraph-pricing-api/versions/3fda572e9a25/schema)