> For the complete documentation index, see [llms.txt](https://docs.kasko.io/kasko-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kasko.io/kasko-api-documentation/rest-api/resources/quote.md).

# Quote

## Quote object

| Name                   | Type    | Description                                       |
| ---------------------- | ------- | ------------------------------------------------- |
| token                  | String  | Generated quote token.                            |
| gross\_payment\_amount | Integer | Gross payment amount calculated from the pricing. |
| extra\_data            | Object  | Object with extra data provided from the pricing. |

<details>

<summary>Quote object example</summary>

```json
{
    "token": "<QUOTE-TOKEN>",
    "gross_payment_amount": 275000,
    "extra_data": {
        "gross_premium": 275000,
        "premium_tax": 25000,
        "net_premium": 250000,
        "tax_rate": 0.1
    }
}
```

</details>

## Create a quote

## Create a quote

<mark style="color:green;">`POST`</mark> `https://api.qa-u.eu1.kaskoqa.com/quotes`

#### Query Parameters

| Name                                  | Type   | Description |
| ------------------------------------- | ------ | ----------- |
| key<mark style="color:red;">\*</mark> | String | Public key  |

#### Headers

| Name                                     | Type   | Description                   |
| ---------------------------------------- | ------ | ----------------------------- |
| Accept<mark style="color:red;">\*</mark> | String | application/vnd.kasko.v3+json |

#### Request Body

| Name                                                     | Type   | Description                                                                                                     |
| -------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------- |
| item\_id<mark style="color:red;">\*</mark>               | String | Item ID                                                                                                         |
| subscription\_plan\_id<mark style="color:red;">\*</mark> | String | Subscription plan ID                                                                                            |
| integration\_id<mark style="color:red;">\*</mark>        | String | Integration ID                                                                                                  |
| integration\_version\_id                                 | String | Integration version ID. Can be used instead of `live_integration` parameter to indicate specific version to use |
| product\_version\_id                                     | String | Product version ID. Can be used instead of `live_product` parameter to indicate specific version to use         |
| data<mark style="color:red;">\*</mark>                   | JSON   | Product-specific quote data fields                                                                              |
| live\_integration                                        | String | Indicates whether to load most recent published or unpublished integration                                      |
| live\_integration                                        | String | Indicates whether to load most recent published or unpublished product                                          |

{% tabs %}
{% tab title="200: OK Successful quote request" %}

```json
{
    "token": "<QUOTE-TOKEN>",
    "gross_payment_amount": 0,
    "extra_data": {
        "gross_premium": 0,
        "premium_tax": 0,
        "net_premium": 0,
        "tax_rate": 0.1
    }
}
```

{% endtab %}

{% tab title="400: Bad Request Data validation failed" %}

```json
{
    "status": "Bad Request",
    "message": "Data validation failed.",
    "errors": [
    ...
        {
            "code": "invalid_value",
            "field": "invalid_field_name"
        }
    ...
    ]

```

{% endtab %}

{% tab title="400: Bad Request Bad Request" %}

<pre class="language-json"><code class="lang-json"><strong>{
</strong>    "status": "Bad Request",
    "message": "Brief description"
}
</code></pre>

{% endtab %}

{% tab title="404: Not Found Resource not found" %}
This response is returned in case any of the provided resources such as the integration, subscription plan or pricing logic cannot be located within the platform.

Some examples of such cases are:

```json
{
    "status": "Not Found",
    "message": "Subscription plan with id - pp_a6c37bc94f56cafaa7fcc02d77111 not found."
}
```

```json
{
    "status": "Not Found",
    "message": "Integration - in_e2b0a5a90e0595939c2b1978e5ccf product - ins_97980026870abce8b812668b2d11 not found."
}
```

{% endtab %}

{% tab title="409: Conflict Conflict" %}
This response indicates that a conflict condition is met. In such cases, during the execution of the quote request, pricing calculation logic creation is in process.

```json
{
    "status": "Conflict",
    "message": "Pricing calculation creation is in progress."
}
```

{% endtab %}

{% tab title="422: Unprocessable Entity Knockout condition met" %}
This response indicates that the quote calculation resulted in knockout condition.

```json
{
    "status": "Unprocessable Entity",
    "message": "knockout"
}
```

{% endtab %}

{% tab title="503: Service Unavailable Service unavailable" %}
This response indicates that quote calculation failed and server cannot handle the request. In such cases either the third party quote integration execution or the calculator client failed execution.

{% endtab %}
{% endtabs %}

<details>

<summary>Example request</summary>

```
curl --location 'https://api.eu1.kaskocloud.com/quotes?key=pk_test_2jngq6d7GRmxQ58w0yVKW3PBrJXbEvoM' \
--header 'Accept: application/vnd.kasko.v3+json' \
--header 'Content-Type: application/json' \
--data '{
  "data": {
    "insured_sum": 10000
  },
  "item_id": "ins_97980026870abce8b812668b2d09",
  "subscription_plan_id": "pp_a6c37bc94f56cafaa7fcc02d771a0",
  "integration_id": "in_e2b0a5a90e0595939c2b1978e5ccf",
    "live_product": "false",
    "live_integration": "false",
  "key": "pk_test_2jngq6d7GRmxQ58w0yVKW3PBrJXbEvoM"
}'
```

</details>