> For the complete documentation index, see [llms.txt](https://help.mimeeq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.mimeeq.com/api/quotations/get-quotation-version.md).

# Get Quotation Version

Get a quotation version with formatted content, gallery media, document references, customer-facing pricing totals and additional charges, group totals, and unit and line product amounts.

Use this when an integration must reproduce a specific quotation revision rather than whichever version is current.

Requires the `quotations:read` scope.

```json
{"openapi":"3.1.0","info":{"title":"Mimeeq External API","version":"1.1.0"},"tags":[{"name":"Quotations","description":"Read quotations and their versions, and update a quotation’s status or stage. A quotation holds commercial metadata; its versions hold the selected content, products and pricing for that version.\n\nUse this section to synchronize a sales pipeline or retrieve a specific quotation version for another system. Read quotation settings for configured stages and lost reasons, and Owners for IDs that can filter the list.\n\n## What you can do\n\n| Task | Reference |\n| --- | --- |\n| Find available quotations | [List Quotations](https://help.mimeeq.com/developers/quotations/list-quotations) |\n| Find available quotation owners | [List Quotation Owners](https://help.mimeeq.com/developers/quotations/list-quotation-owners) |\n| Find available quotation settings | [List Quotation Settings](https://help.mimeeq.com/developers/quotations/list-quotation-settings) |\n| Read one quotation | [Get Quotation](https://help.mimeeq.com/developers/quotations/get-quotation) |\n| Change quotation status | [Set Quotation Status](https://help.mimeeq.com/developers/quotations/set-quotation-status) |\n| Change quotation stage | [Set Quotation Stage](https://help.mimeeq.com/developers/quotations/set-quotation-stage) |\n| Find available quotation versions | [List Quotation Versions](https://help.mimeeq.com/developers/quotations/list-quotation-versions) |\n| Read one quotation version | [Get Quotation Version](https://help.mimeeq.com/developers/quotations/get-quotation-version) |\n| Find available quotation notes | [List Quotation Notes](https://help.mimeeq.com/developers/quotations/list-quotation-notes) |\n\n## Before you start\n\nYour API key needs `quotations:read` to read these resources. Use `quotations:write` for write operations.\n\n## Important behaviour\n\nList excludes archived quotations. Expected-close-date filters do not filter creation dates. Get returns the current version unless `versionId` is provided. The quotation-level price and selected-version total represent different values. Setting WON requires an accepted version and acceptor name; setting LOST requires a configured lost reason. These endpoints do not create quotations or edit version content."}],"servers":[{"url":"https://admin.mimeeqapi.com","description":"Production API"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"API key sent as a bearer token (mk_live_… / mk_test_…)."}},"schemas":{"QuotationsVersions2":{"type":"object","properties":{"data":{"type":"object","properties":{"versionId":{"type":"string"},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601 timestamp."},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601 timestamp."},"summary":{"type":"object","properties":{"description":{"type":"object","properties":{"html":{"type":"string","description":"Draft.js content rendered as HTML."},"text":{"type":"string","description":"Plain text extracted from Draft.js blocks."}},"required":["html","text"],"additionalProperties":false,"description":"Complete formatted summary, including any payment, bank, and delivery text entered on the quote."}},"required":["description"],"additionalProperties":false},"introduction":{"type":"object","properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"type":"object","properties":{"html":{"type":"string","description":"Draft.js content rendered as HTML."},"text":{"type":"string","description":"Plain text extracted from Draft.js blocks."}},"required":["html","text"],"additionalProperties":false,"description":"Complete formatted introduction."}},"required":["title","description"],"additionalProperties":false},"pricing":{"type":"object","properties":{"products":{"type":"object","properties":{"salePrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Sale total for included products."},"regPrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Regular total for included products."},"totalQuantity":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Sum of included product row quantities across the version."},"discountPercentage":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Discount against the products regular total, in percentage points."}},"required":["salePrice","regPrice","totalQuantity","discountPercentage"],"additionalProperties":false},"additional":{"type":"array","items":{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"fixedAmount":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Signed fixed charge; null for percentage charges."},"percentageOfProductsTotal":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Percentage points applied to the products sale total; null for fixed charges."},"adjustmentAmount":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Signed amount added to the subtotal; percentages use the products sale total as their base."}},"required":["name","fixedAmount","percentageOfProductsTotal","adjustmentAmount"],"additionalProperties":false}},"subtotal":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Products plus additional selling charges, before final discount."},"finalDiscount":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Amount subtracted from the subtotal."},"total":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Authoritative selling total for this quotation version."}},"required":["products","additional","subtotal","finalDiscount","total"],"additionalProperties":false},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"type":"object","properties":{"html":{"type":"string","description":"Draft.js content rendered as HTML."},"text":{"type":"string","description":"Plain text extracted from Draft.js blocks."}},"required":["html","text"],"additionalProperties":false,"description":"Formatted group description."},"pricing":{"type":"object","properties":{"salePrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Selling total for included rows in this group."},"regPrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Regular total for included rows in this group."},"totalQuantity":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Sum of included product row quantities in this group."},"discountPercentage":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Discount against the group regular total, in percentage points."}},"required":["salePrice","regPrice","totalQuantity","discountPercentage"],"additionalProperties":false},"settings":{"type":"object","properties":{"hideTitle":{"type":"boolean"},"newPage":{"type":"boolean","description":"Start this group on a new PDF page."}},"required":["hideTitle","newPage"],"additionalProperties":false},"blocks":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"blockType":{"anyOf":[{"type":"string"},{"type":"null"}]},"selectedLineId":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Selected quotation row id in a PRODUCT_MULTI block."},"newPage":{"type":"boolean","description":"Page-break preference stored on the block."},"content":{"type":"object","properties":{"html":{"type":"string","description":"Draft.js content rendered as HTML."},"text":{"type":"string","description":"Plain text extracted from Draft.js blocks."}},"required":["html","text"],"additionalProperties":false,"description":"Formatted text-block content in quotation order; empty strings when the block has no text."},"products":{"type":"array","items":{"type":"object","properties":{"lineId":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Unique quotation row id, distinct from catalogue productId."},"parentLineId":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Parent quotation row id for a child row."},"optional":{"type":"boolean","description":"Whether this quotation row is optional."},"selectedOptional":{"type":"boolean","description":"Whether an optional row is selected."},"previewImage":{"anyOf":[{"type":"string"},{"type":"null"}]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"type":"object","properties":{"html":{"type":"string","description":"Draft.js content rendered as HTML."},"text":{"type":"string","description":"Plain text extracted from Draft.js blocks."}},"required":["html","text"],"additionalProperties":false,"description":"Formatted product description, separate from notes."},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"configurationCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"variantCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"options":{"type":"array","items":{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"hideOnSpecification":{"type":"boolean","description":"Omit this option from the customer-facing specification when true."},"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"previewImage":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","hideOnSpecification","value","previewImage"],"additionalProperties":false}},"sku":{"anyOf":[{"type":"string"},{"type":"null"}]},"unitSalePrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Selling price per unit, before any one-time line charge."},"unitRegPrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Regular price per unit."},"oneTimeCharge":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Charge applied once to the line and included in both salePrice and regPrice."},"salePrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Selling total for the entire quotation row."},"regPrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Regular total for the entire quotation row."}},"required":["lineId","parentLineId","optional","selectedOptional","previewImage","notes","description","productId","configurationCode","type","variantCode","quantity","name","options","sku","unitSalePrice","unitRegPrice","oneTimeCharge","salePrice","regPrice"],"additionalProperties":false}},"gallery":{"anyOf":[{"type":"object","properties":{"numOfColumns":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"mediaType":{"anyOf":[{"type":"string","enum":["IMAGE","VIDEO"]},{"type":"null"}]},"mediaSource":{"anyOf":[{"type":"string","enum":["CUSTOM","MEDIA_LIBRARY"]},{"type":"null"}]},"fileId":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Absolute media URL; null if the item has no file path or URL."},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"autoplay":{"type":"boolean"},"loop":{"type":"boolean"}},"required":["mediaType","mediaSource","fileId","url","caption","autoplay","loop"],"additionalProperties":false},"description":"Gallery media in display order."}},"required":["numOfColumns","items"],"additionalProperties":false},{"type":"null"}]},"documents":{"type":"array","items":{"type":"object","properties":{"fileId":{"anyOf":[{"type":"string"},{"type":"null"}]},"directoryPath":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source directory for resolving file details."}},"required":["fileId","directoryPath"],"additionalProperties":false}}},"required":["id","blockType","selectedLineId","newPage","content","products","gallery","documents"],"additionalProperties":false}}},"required":["id","title","description","pricing","settings","blocks"],"additionalProperties":false}}},"required":["versionId","status","createdAt","modifiedAt","summary","introduction","pricing","groups"],"additionalProperties":false}},"required":["data"],"additionalProperties":false,"description":"Data schema used by Get Quotation Version (GET /v1/quotations/{quotationId}/versions/{versionId}). Read that operation for usage, permissions and update rules. Required fields and allowed values are defined below; request and response shapes can differ."},"PublicError":{"description":"An API error response. Use code and the HTTP status to classify the failure, message and optional details for context, and requestId when reporting it. Edge firewall responses may omit requestId.","type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","description":"Present on every error the API itself returns; absent when the edge firewall rejected the request."},"details":{"description":"Optional error-specific details (e.g. per-field validation reasons)."}}}}},"paths":{"/v1/quotations/{quotationId}/versions/{versionId}":{"get":{"summary":"Get Quotation Version","tags":["Quotations"],"description":"Get a quotation version with formatted content, gallery media, document references, customer-facing pricing totals and additional charges, group totals, and unit and line product amounts.\n\nUse this when an integration must reproduce a specific quotation revision rather than whichever version is current.\n\nRequires the `quotations:read` scope.","responses":{"200":{"description":"Successful response.","headers":{"RateLimit-Limit":{"description":"Requests that can be admitted at once (the tier burst).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Tokens left after this request.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the bucket is full again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotationsVersions2"}}}},"400":{"description":"Invalid request data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicError"}}},"headers":{"RateLimit-Limit":{"description":"Requests that can be admitted at once (the tier burst).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Tokens left after this request.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the bucket is full again.","schema":{"type":"integer"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicError"}}}},"403":{"description":"The API key lacks the required scope (`scope_denied`), or the operation is not permitted for this account (`operation_not_permitted`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicError"}}},"headers":{"RateLimit-Limit":{"description":"Requests that can be admitted at once (the tier burst).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Tokens left after this request.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the bucket is full again.","schema":{"type":"integer"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicError"}}},"headers":{"RateLimit-Limit":{"description":"Requests that can be admitted at once (the tier burst).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Tokens left after this request.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the bucket is full again.","schema":{"type":"integer"}}}},"429":{"description":"The API key exceeded its request rate (`rate_limit_exceeded`) or its monthly quota (`quota_exceeded`). Both carry `Retry-After`; the `RateLimit-*` headers accompany `rate_limit_exceeded` only, since a spent quota says nothing about the bucket.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicError"}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"RateLimit-Limit":{"description":"Requests that can be admitted at once (the tier burst).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Tokens left after this request.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the bucket is full again.","schema":{"type":"integer"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicError"}}},"headers":{"RateLimit-Limit":{"description":"Requests that can be admitted at once (the tier burst).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Tokens left after this request.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the bucket is full again.","schema":{"type":"integer"}}}}},"parameters":[{"name":"quotationId","in":"path","required":true,"schema":{"type":"string","pattern":"^QUOT-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"}},{"name":"versionId","in":"path","required":true,"schema":{"type":"string","pattern":"^VERSION_\\d+$"}}]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.mimeeq.com/api/quotations/get-quotation-version.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.