Quote history

Retrieving quote history

get

Retrieves changes related to a quote with a given ID.

---

Required scopes

• quote.quote_read - allows employees to retrieve history of any quote

Authorizations

Path parameters

tenantstringRequired

Your Emporix tenant's name.

Note: The tenant name should always be written in lowercase.

Example: saasdev2

quoteIdstringRequired

Quote unique identifier generated when the quote is created.

Example: 084bcaf5-66b8-4ddd-9489-65c5f6449e94

Header parameters

X-Total-CountbooleanOptional

Flag indicating whether the total number of retrieved items should be returned.

Default: falseExample: true

Responses

200

The request was successful. Quote details are returned.

application/json

401

Given request is unauthorized - the authorization token is invalid or has expired. It usually means that tenant from the token does not match tenant from path.

application/json

403

Permission denied due to insufficient rights. This may happen when request does not contain sufficient scopes for given query values.

application/json

get

HTTPcURLJavaScriptPython

GET /quote/{tenant}/quotes/{quoteId}/history HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "id": "6447b45cac0475131f3a6261",
    "op": "ADD",
    "path": "/items",
    "newValue": {
      "itemId": "2298854309b06d4c6d3cf1zfe",
      "quantity": {
        "quantity": 1,
        "unitCode": "H87"
      },
      "price": {
        "priceId": "14551d2309b06sd46d3cf19bq",
        "unitPrice": 13,
        "totalNetValue": 13,
        "tax": {
          "taxClass": "STANDARD",
          "taxRate": 20
        },
        "product": {
          "productId": "74698542309b06dc46d3cf19fe"
        }
      }
    },
    "userId": "7777i52309521897214",
    "userFirstName": "Robin",
    "userLastName": "Fritz",
    "userType": "EMPLOYEE",
    "modifiedAt": "2024-04-02T13:06:15.280Z"
  },
  {
    "id": "6447b45cac0475131f3a6262",
    "op": "REPLACE",
    "path": "/status",
    "newValue": {
      "value": "OPEN"
    },
    "previousValue": {
      "value": "AWAITING"
    },
    "userId": "612ji52309521897214",
    "userFirstName": "Robin",
    "userLastName": "Fritz",
    "userType": "EMPLOYEE",
    "modifiedAt": "2024-04-02T13:06:15.280Z"
  },
  {
    "id": "6447b45cac0475131f3a6263",
    "op": "REPLACE",
    "path": "/validTo",
    "newValue": "2025-04-02T13:06:15.280Z",
    "previousValue": "2023-04-02T13:06:15.280Z",
    "userId": "612ji52309521897214",
    "userFirstName": "Stefan",
    "userLastName": "Muller",
    "userType": "EMPLOYEE",
    "modifiedAt": "2024-04-02T13:06:15.280Z"
  },
  {
    "id": "6447b45cac0475131f3a6264",
    "op": "REPLACE",
    "path": "/items/2298854309b06d46d3cf19fe",
    "previousValue": {
      "itemId": "2298854309b06d4c6d3cf1zfe",
      "quantity": {
        "quantity": 1,
        "unitCode": "H87"
      },
      "price": {
        "priceId": "14551d2309b06sd46d3cf19bq",
        "unitPrice": 13,
        "totalNetValue": 13,
        "tax": {
          "taxClass": "STANDARD",
          "taxRate": 20
        },
        "product": {
          "productId": "74698542309b06dc46d3cf19fe"
        }
      }
    },
    "newValue": {
      "itemId": "2298854309b06d4c6d3cf1zfe",
      "quantity": {
        "quantity": 2,
        "unitCode": "H87"
      },
      "price": {
        "priceId": "14551d2309b06sd46d3cf19bq",
        "unitPrice": 14,
        "totalNetValue": 14,
        "tax": {
          "taxClass": "STANDARD",
          "taxRate": 21
        },
        "product": {
          "productId": "74698542309b06dc46d3cf1fff"
        }
      }
    },
    "userId": "5577i52309521897214",
    "userFirstName": "Mark",
    "userLastName": "Schmidt",
    "userType": "EMPLOYEE",
    "modifiedAt": "2024-04-02T13:06:15.280Z"
  },
  {
    "id": "6447b45cac0475131f3a6261",
    "op": "REMOVE",
    "path": "/items/124dfa82410fas824kfa",
    "previousValue": {
      "itemId": "2298854309b06d4c6d3cf1zfe",
      "quantity": {
        "quantity": 1,
        "unitCode": "H87"
      },
      "price": {
        "priceId": "14551d2309b06sd46d3cf19bq",
        "unitPrice": 13,
        "totalNetValue": 13,
        "tax": {
          "taxClass": "STANDARD",
          "taxRate": 20
        },
        "product": {
          "productId": "74698542309b06dc46d3cf19fe"
        }
      }
    },
    "userId": "612ji52309521897214",
    "userFirstName": "Stefan",
    "userLastName": "Muller",
    "userType": "EMPLOYEE",
    "modifiedAt": "2024-04-02T13:06:15.280Z"
  }
]