Get Quotation

Get a quotation and its selected version, including formatted content, gallery media, document references, version pricing, additional selling charges, and line selection details.

Use this to read the commercial record and the selected version together. Use the versions endpoints when browsing or selecting version history.

Behaviour

Optionally request a specific versionId; otherwise the current version is returned.

The top-level price is current quotation metadata; version.pricing.total is the selected version total.

Requires the quotations:read scope.

get

Authorizations

AuthorizationstringRequired

API key sent as a bearer token (mk_live_… / mk_test_…).

Path parameters

quotationIdstringRequiredPattern: ^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}$

Query parameters

versionIdstringOptionalPattern: ^VERSION_\d+$

Responses

200

Successful response.

application/json

400

Invalid request data.

application/json

401

Missing or invalid API key.

application/json

403

The API key lacks the required scope (scope_denied), or the operation is not permitted for this account (operation_not_permitted).

application/json

404

Resource not found.

application/json

429

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.

application/json

500

Internal server error.

application/json

get/v1/quotations/{quotationId}

GET /v1/quotations/{quotationId} HTTP/1.1
Host: admin.mimeeqapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": {
    "quotationId": "QUOT-123e4567-e89b-12d3-a456-426614174000",
    "quotationName": "text",
    "quotationNumber": "text",
    "status": "OPEN",
    "stageId": "text",
    "stageName": "text",
    "ownerId": "text",
    "currency": "text",
    "price": 1,
    "currentVersionId": "text",
    "numOfVersions": 1,
    "validUntil": "text",
    "expectedClose": "text",
    "paymentTerms": "text",
    "language": "text",
    "lostReasonId": "text",
    "lostReasonName": "text",
    "lostComment": {
      "html": "text",
      "text": "text"
    },
    "isPrivate": true,
    "createdAt": "text",
    "modifiedAt": "text",
    "owner": {
      "ownerId": "text",
      "firstName": "text",
      "lastName": "text",
      "email": "text",
      "phoneNumber": "text"
    },
    "shortCode": "text",
    "addresses": [],
    "contactId": "text",
    "companyId": "text",
    "version": {
      "versionId": "text",
      "summary": {
        "description": {
          "html": "text",
          "text": "text"
        }
      },
      "introduction": {
        "title": "text",
        "description": {
          "html": "text",
          "text": "text"
        }
      },
      "pricing": {
        "products": {
          "salePrice": 1,
          "regPrice": 1,
          "totalQuantity": 1,
          "discountPercentage": 1
        },
        "additional": [
          {
            "name": "text",
            "fixedAmount": 1,
            "percentageOfProductsTotal": 1,
            "adjustmentAmount": 1
          }
        ],
        "subtotal": 1,
        "finalDiscount": 1,
        "total": 1
      },
      "groups": [
        {
          "id": "text",
          "title": "text",
          "description": {
            "html": "text",
            "text": "text"
          },
          "pricing": {
            "salePrice": 1,
            "regPrice": 1,
            "totalQuantity": 1,
            "discountPercentage": 1
          },
          "settings": {
            "hideTitle": true,
            "newPage": true
          },
          "blocks": [
            {
              "id": "text",
              "blockType": "text",
              "selectedLineId": "text",
              "newPage": true,
              "content": {
                "html": "text",
                "text": "text"
              },
              "products": [
                {
                  "lineId": "text",
                  "parentLineId": "text",
                  "optional": true,
                  "selectedOptional": true,
                  "previewImage": "text",
                  "notes": "text",
                  "description": {
                    "html": "text",
                    "text": "text"
                  },
                  "productId": "text",
                  "configurationCode": "text",
                  "type": "text",
                  "variantCode": "text",
                  "quantity": 1,
                  "name": "text",
                  "options": [
                    {
                      "name": "text",
                      "hideOnSpecification": true,
                      "value": "text",
                      "previewImage": "text"
                    }
                  ],
                  "sku": "text",
                  "unitSalePrice": 1,
                  "unitRegPrice": 1,
                  "oneTimeCharge": 1,
                  "salePrice": 1,
                  "regPrice": 1
                }
              ],
              "gallery": {
                "numOfColumns": 1,
                "items": [
                  {
                    "mediaType": "IMAGE",
                    "mediaSource": "CUSTOM",
                    "fileId": "text",
                    "url": "text",
                    "caption": "text",
                    "autoplay": true,
                    "loop": true
                  }
                ]
              },
              "documents": [
                {
                  "fileId": "text",
                  "directoryPath": "text"
                }
              ]
            }
          ]
        }
      ]
    }
  }
}