Get the result of an estimate you already requested
get_estimate_resultReads one estimate you already requested, by its estimate_id. Use this when a tier-3 (deep research) estimate came back with status "pending" and you want to know whether it is finished, or to show an earlier estimate again. Tier-3 results are only delivered this way (or to a callback_url, which chat clients usually cannot receive).
Returns status: "pending" (with retry_after_seconds: how long to wait before asking again), "completed" (with the same fields a finished estimate returns), or "failed" (with error_detail; any credits taken are refunded).
You can only read estimates made with the same credentials. Without an account you are recognised by IP address and browser or client, so a different network or client may not find the estimate. To find an id you lost, use list_my_estimates. Not for: making a new estimate.
Cost: free. Reading a result never spends anything.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"estimate_id": "<estimate_id>"
},
"name": "get_estimate_result"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | No | The same api_key used when the estimate was requested (omit it if none was used, or if your connector is signed in). Estimates are visible only to the credentials that made them. | |
| estimate_id | Yes | The estimate_id returned by estimate_quantity_or_probability or listed by list_my_estimates. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Model that produced it. | |
| status | No | Only on results that are not finished yet or that come from get_estimate_result: "pending" (tier 3 still running), "completed" or "failed". | |
| billing | No | Who this call was billed to and what is left. Present on every Fermi result. | |
| tier_id | No | The tier that produced it (1, 2 or 3). | |
| provider | No | AI provider that produced it. | |
| range_low | No | Same as estimation_interval.low. | |
| created_at | No | When it was made (ISO 8601). | |
| disclaimer | No | Not financial advice notice. | |
| next_steps | No | Ready-made input for neumann, Kromatic's Monte Carlo simulation server. simulate.root_node (distribution_type and distribution_params) can be added to a neumann model as one uncertain input; when the family has no direct neumann match, simulate.solve_args are the arguments for neumann's convert_range_to_distribution instead. simulate.note says which, and simulate.mcp_url is the neumann server to call. | |
| range_high | No | Same as estimation_interval.high. | |
| request_id | No | Id of this request, for support. | |
| assumptions | No | The assumptions the estimate rests on. | |
| estimate_id | No | Id of this estimate, for get_estimate_result and list_my_estimates. | |
| error_detail | No | When failed: what went wrong. | |
| point_estimate | No | The single best value. For a yes/no question asked with unit "probability (0-1)", this is the probability that the event happens (0.15 = 15%). | |
| credits_charged | No | Credits this estimate cost (0 without an account). | |
| confidence_level | No | Set only from coverage_probability: "high" for 0.95 or more, "medium" for 0.9 up to 0.95, "low" below 0.9. It is not a judgement of the estimate's quality. | |
| credits_refunded | No | When failed: credits given back. | |
| research_sources | No | Tiers 2 and 3: web sources used (url, title, snippet, relevance_note). | |
| reasoning_summary | No | How the estimate was reached, in a few sentences. | |
| verification_flags | No | Tier 3: issues the second check raised. | |
| distribution_family | No | Shape of the fitted probability distribution: normal, log_normal (positive and right-skewed), uniform, constant, beta (values between 0 and 1, used for probabilities and rates), triangle, gamma, exponential or poisson (counts). | |
| estimation_interval | No | The range that should contain the true value with probability coverage_probability. For a probability question, both ends are probabilities between 0 and 1. | |
| retry_after_seconds | No | When pending: seconds to wait before reading it again. | |
| coverage_probability | No | Chance the interval contains the true value (0.9 = 90%). | |
| verification_summary | No | Tier 3: what a second check found. | |
| distribution_parameters | No | Parameters of that distribution by name, e.g. alpha and beta for beta, mu and sigma for log_normal. | |
| decomposition_suggestions | No | Sub-questions (sub_question, reasoning) worth estimating separately to sharpen this one. Each would be a new estimate call at the usual cost. |