Skip to content

Quote API Reference

This page contains technical details for interacting with Riskwolf's Quote API endpoints.

Creating Quotes via API

The Riskwolf API allows you to programmatically generate quotes for parametric insurance products:

curl --location 'https://api.riskwolf.com/internal/fast-quotes' \
-XPOST \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <tenant_id>' \
--header 'Authorization: Bearer <access_token>' \
--data-raw '{
    "@type": "NewFastQuote",
    "name": "Client Quote",
    "customerId": "<customer_id>",
    "coverageIds": ["<coverage_id>"],
    "sumInsured": {
        "amount": 10000.0,
        "currency": "USD"
    }
}'

Required Parameters

Parameter Type Description
name String A descriptive name for the quote
customerId UUID ID of the customer receiving the quote
coverageIds Array List of coverage IDs to include in quote
sumInsured Object Contains amount (number) and currency (string)

Checking Quote Status

Once a quote is created, you can check its status using:

curl --location 'https://api.riskwolf.com/internal/quotes/<quote_id>' \
--header 'x-tenant-id: <tenant_id>' \
--header 'Authorization: Bearer <access_token>'

Quote States

State Description
created Quote initiated, documentation not yet generated
queued Documentation generation in queue
running Processing in progress
completed Quote ready for conversion to policy
accepted Quote converted to policy draft
error Processing error occurred

Accepting a Quote

To accept a quote and convert it to a policy:

curl --location 'https://api.riskwolf.com/internal/quotes/<quote_id>/accept' \
-XPOST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <access_token>' \
--data-raw '{
    "externalPolicyId": "<your_reference_id>"
}'

Required Parameters

Parameter Type Description
externalPolicyId String Your reference ID for the policy

Rejecting a Quote

To reject a quote:

curl --location 'https://api.riskwolf.com/internal/quotes/<quote_id>/reject' \
-XPOST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <access_token>'

Error Handling

The API uses standard HTTP status codes to indicate success or failure:

  • 200 OK: Request succeeded
  • 400 Bad Request: Invalid input parameters
  • 401 Unauthorized: Authentication required
  • 403 Forbidden: Insufficient permissions
  • 404 Not Found: Resource doesn't exist
  • 500 Internal Server Error: Server-side error

Error responses include a JSON body with error details. For comprehensive information on error codes, response formats, and handling strategies, please refer to the API Error Reference.

For a full list of endpoints and their details, please refer to the Quote Details Examples.