---
title: "Validate simulation cost accuracy against provider benchmarks"
method: GET
path: "/simulations/{simulationId}/validate-cost-accuracy"
tags: ["Simulations"]
---

# Validate simulation cost accuracy against provider benchmarks

`GET /simulations/{simulationId}/validate-cost-accuracy`

## Request

- Base URL: `https://www.cloudworldmodel.ai/api`
- URL: `https://www.cloudworldmodel.ai/api/simulations/{simulationId}/validate-cost-accuracy`
- Auth: none required

Compares the simulation's cost estimates against known real-world provider
pricing benchmarks. Returns a validation result indicating whether the
simulated cost per hour is within the acceptable tolerance (±10%).

Useful for confirming the simulation is faithfully modelling provider
pricing before using it for cost-optimisation decisions.

**Skip semantics:** Resources without a `serviceFamily` characteristic,
or whose `provider`/`serviceFamily`/`size` combination has no pricing
benchmark entry, are silently skipped. When all resources are skipped,
`validations` is empty, `summary.total` is `0`, and `checked` is `false`.
In that state `valid: true` means "no failures among the zero resources
checked" — it does **not** mean the simulation's cost accuracy was
verified. Always check `checked: true` before acting on `valid`.

Requires `read` scope and ownership.

## Path parameters

- `simulationId` string, required

## Response `200`

Cost accuracy validation result

- object
  - `valid` boolean: Whether all checked resources are within the ±10% cost tolerance. Only meaningful when `checked` is `true`.
  - `checked` boolean: `true` when at least one resource had a matching pricing benchmark and was evaluated. `false` means no comparable data was found — the simulation resources may lack `serviceFamily` or have no pricing benchmark entry. When `checked` is `false`, `valid: true` does **not** mean accuracy was verified.
  - `validations` object[]: Per-resource cost validation results
    - `resource` string: Resource name
    - `provider` string
    - `serviceFamily` string
    - `size` string
    - `simulatedCost` number: Simulated hourly cost (USD)
    - `benchmarkCost` number: Benchmark hourly cost (USD)
    - `deviation` number: Absolute percentage deviation from benchmark
    - `withinThreshold` boolean
    - `source` string: Source citation for the benchmark value
  - `summary` object
    - `total` integer: Number of resources that had a matching benchmark
    - `passed` integer
    - `failed` integer
    - `avgDeviation` number: Average deviation across all checked resources
    - `skippedCount` integer: Number of resources (or resource-metric pairs) that were evaluated but had no matching benchmark entry and were therefore skipped.
    - `skippedReasons` string[]: Human-readable explanation for each skipped resource. Common reasons: no `serviceFamily` set, or no pricing benchmark found for the provider/serviceFamily/size combination.

## Other responses

- `401`: No credentials provided to an API-key-protected endpoint. The response body includes a machine-readable `apiKeyAuth` block pointing to the key creation endpoint so agents can self-serve an API key without consulting the spec.
- `403`: Access denied
- `404`: Resource not found
- `500`: Internal server error

---

[API](https://skmtc.dev/cloudworldmodel/apis/cloud-world-model-agent-api.md) · [All operations](https://skmtc.dev/cloudworldmodel/apis/cloud-world-model-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudworldmodel/apis/cloud-world-model-agent-api/revisions/ecc3ad1ff07f?raw)