---
title: "The result envelope"
description: "The envelope every Fincanva Open API and MCP operation answers in: result, summary, assumed values, dataVersion, and recipeId and permalink when recorded."
canonical_url: "https://fincanva.com/developers/concepts/the-result-envelope"
last_updated: "2026-10-03"
md_url: "https://fincanva.com/developers/concepts/the-result-envelope.md"
---

# The result envelope

Every Fincanva operation answers in the same envelope, over REST and over MCP: its own result, a short summary, the values it assumed and the data build its figures come from.

## What does every Fincanva operation return?

A successful REST call returns `status: true` and a `data` object holding `result` (the operation's own output), `summary` (a few lines of text), `assumed` (every value the operation filled in because the request left it out, with the reason), `dataVersion` (the nightly data build the figures come from, or null when nothing was computed from market data) and, when the result is a series, `chart`. A recorded result also carries `recipeId` (what reproduces it: the same operation, input and data version) and `permalink` (the result's permanent address on Fincanva). Over MCP the same object is the tool's structured content and the summary is its text.

Fincanva is for education and illustration only. It is not personalised financial advice, and past or simulated results do not predict future ones. [Read the Terms Addendum](https://fincanva.com/terms/addendum#section-3)