Rate Saved Quote by Id (Stateless)

curl --request POST \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ratingWorkflowName": "standard"
}
'

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate"

payload = { "ratingWorkflowName": "standard" }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ratingWorkflowName: 'standard'})
};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ratingWorkflowName' => 'standard'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate"

	payload := strings.NewReader("{\n  \"ratingWorkflowName\": \"standard\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ratingWorkflowName\": \"standard\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ratingWorkflowName\": \"standard\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "quoteType": "newBusiness",
    "quoteNumber": "Q-000123",
    "quoteStatus": "inProgress",
    "primaryInsured": {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "exposureName": "Acme Co",
      "exposureRatingResponse": {
        "premium": 1000
      }
    },
    "otherExposures": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440002",
        "exposureName": "Beta LLC",
        "exposureRatingResponse": {
          "premium": 1000
        }
      }
    ],
    "fullTermPolicyRatingResult": {
      "policyPremium": 3000,
      "policyGrandTotal": 3500
    }
  }
}

Rating

Rate Saved Quote by Id (Stateless)

Rates an already-saved quote, named by id, and returns the rating results — without persisting anything. The quote is never modified: no field is written, no rating run is recorded, and the quote row is byte-identical before and after. This is the by-id sibling of POST /api/v1/companies/{companyId}/quotes/rate; the only difference is where the field bag comes from — loaded from the saved quote here, supplied in the request body there.

The quote id is a path parameter; the request body carries only ratingWorkflowName. There are deliberately no data overrides — to rate what-if values (“as if field X were Y”), GET the quote, tweak it, and POST the full-body /quotes/rate endpoint, which supports inline overrides.

Semantics. The saved quote’s stored field bag is validated with the identical create-quote pipeline (shape, resolution, tenant invariants, entity invariants), embedded exposure id references are looked up and merged from their stored data exactly as the full-body endpoint does, and then the named rating workflow runs. For a supported quote type there is no quote-status gate — any saved quote rates regardless of quoteStatus (bound and cancelled included), because rating a saved quote is a read-only computation that can corrupt nothing. This status promise does not expand the supported quote types: cancellation and reinstatement return a structured 400 InvalidRequest before any rater or vendor call because those transactions preserve rating and derive or restore pricing.

The 200 response returns the saved quote’s bag under data, enriched with the rating outputs (e.g. exposureRatingResponse on each exposure and the full-term policy rating containers).

Required permission: company.quote:rate

POST

api

companies

{companyId}

quotes

{quoteId}

rate

Rate Saved Quote by Id (Stateless)

curl --request POST \
  --url https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ratingWorkflowName": "standard"
}
'

import requests

url = "https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate"

payload = { "ratingWorkflowName": "standard" }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ratingWorkflowName: 'standard'})
};

fetch('https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ratingWorkflowName' => 'standard'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate"

	payload := strings.NewReader("{\n  \"ratingWorkflowName\": \"standard\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ratingWorkflowName\": \"standard\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/rate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ratingWorkflowName\": \"standard\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "quoteType": "newBusiness",
    "quoteNumber": "Q-000123",
    "quoteStatus": "inProgress",
    "primaryInsured": {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "exposureName": "Acme Co",
      "exposureRatingResponse": {
        "premium": 1000
      }
    },
    "otherExposures": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440002",
        "exposureName": "Beta LLC",
        "exposureRatingResponse": {
          "premium": 1000
        }
      }
    ],
    "fullTermPolicyRatingResult": {
      "policyPremium": 3000,
      "policyGrandTotal": 3500
    }
  }
}

Authorizations

Authorization

string

header

required

API key authentication. Send your raw API key as the Authorization header value with NO scheme prefix — Authorization: YOUR-API-KEY. Do NOT prefix it with Bearer or ApiKey, and do not use an X-API-Key header; those are not accepted.

Path Parameters

companyId

string<uuid>

required

Company identifier

quoteId

string<uuid>

required

Quote identifier

Body

application/json

ratingWorkflowName

string

The configured rating workflow to run. Required in practice — there is no default even when a single workflow is configured — but it is not schema-required: rather than a shape rejection, a missing or unknown name returns a 400 listing the configured workflow names (and a company with no workflows configured returns a 422), so callers get an actionable error naming the valid options. There is no fallback to any per-quote persisted selection.

Example:

"standard"

Response

The saved quote's data enriched with rating outputs. Nothing is persisted.

data

object

required

The saved quote's stored field bag, enriched with rating outputs (per-exposure exposureRatingResponse, and the full-term policy rating containers).

⌘I

Getting Started

User

Entities

Event Lifecycle

Policy Transactions

Financials

Rating

Notes

Tasks

Configuration Management

Company Files

Forms

Document Generation

Submission Parsing

Reference

Rate Saved Quote by Id (Stateless)

Authorizations

Path Parameters

Body

Response