Skip to main content
POST
Calculate Risk Score

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
policy_holder_id
string
required

Unique identifier for the policyholder.

Example:

"policy-holder-123"

vehicles
VehicleGaragingData · object[]
required

List of vehicles with their garaging locations. Max 50 vehicles per request.

Required array length: 1 - 50 elements
version
enum<string>
default:v2

Version of the risk scoring model used.

Available options:
v1,
v2
Examples:

"v1"

"v2"

naics_code
string | null

Optional NAICS code for the policyholder.

Required string length: 2 - 6
Example:

"492110"

effective_date
string<date-time> | null

Start date of the policy. Defaults to the current date and time unless overridden, typically for backtesting. Will not pull in data after this date.

Response

Successful Response

policy_holder_id
string
required

Unique identifier for the policyholder.

Example:

"policy-holder-123"

vehicle_risk_scores
CA_VehicleGaragingRiskScore · object[]
required

Risk scores for each vehicle based on their garaging locations.

job_type
string
default:ca-garaging-risk-score

Type of job that was run.

Allowed value: "ca-garaging-risk-score"
Example:

"ca-garaging-risk-score"

version
enum<string>
default:v2

Version of the risk scoring model used.

Available options:
v1,
v2
Examples:

"v1"

"v2"

errors
CA_VehicleGaragingRiskScoreError · object[] | null

Any vehicles that could not be scored.

Example:

null