---
title: "Overview"
description: "This API returns a cost indication - based on comparable deployments in the portfolio, the platform's usage index and the agent's own characteristics."
url: "https://real-estate-agency.apim.eu/apis/cost-estimation/docs/overview"
image: "https://real-estate-agency.apim.eu/_og/d/c_Ocean.takumi,title_Overview,description_~VGhpcyBBUEkgcmV0dXJucyBhIGNvc3QgaW5kaWNhdGlvbiAtIGJhc2VkIG9uIGNvbXBhcmFibGUgZGVwbG95bWVudHMgaW4gdGhlIHBvcnRmb2xpbywgdGhlIHBsYXRmb3JtJ3MgdXNhZ2UgaW5kZXggYW5kIHRoZSBhZ2VudCdzIG93biBjaGFyYWN0ZXJpc3RpY3Mu,props_eyJ0aGVtZSI6eyJtb2RlIjoiZGFyayIsImNvbG9ycyI6eyJwcmltYXJ5IjoiI0Q0QTI0QyJ9fX0,p_Ii9hcGlzL2Nvc3QtZXN0aW1hdGlvbi9kb2NzL292ZXJ2aWV3Ig,s__Uuczjxvu25fL0hm.png"
---

# Overview

This API returns a cost indication - based on comparable deployments in the portfolio, the platform's usage index and the agent's own characteristics.

## [An indication, not an appraisal](#an-indication-not-an-appraisal)

The result is explicitly not a formal cost audit prepared under a certified FinOps standard. Every response therefore carries three pieces of information meant to be read together:

-   `monthly_cost_usd` - the point estimate
-   `range_usd` - the plausible corridor
-   `confidence` and `basis` - how reliable the figure is

A `confidence: "low"` based on 6 comparable deployments means: quote the range in the stakeholder conversation, not the point estimate.

## [Two ways to start](#two-ways-to-start)

For an already-deployed agent, `agent_id` is enough. During an initial planning conversation, when no record exists yet, pass `characteristics` instead - agent type, model/provider, expected request volume and, if known, integration count and deployment tier. Setting both at once is not allowed.

## [When the data isn't enough](#when-the-data-isnt-enough)

For rarely-used agent types, you'll get a `422` with `code: "insufficient_data"`. That's an honest answer, not a malfunction. In that case, widen the time window via `period_months` up to 36 months, or fall back to the usage index.

## [Privacy for comparable deployments](#privacy-for-comparable-deployments)

Comparable deployments are only ever delivered anonymized: owning teams are rounded to the business-unit level, the rollout date to the month. That makes it impossible to trace back to an individual deployment.