Skip to main content
POST
/
v1
/
risk-score
/
ca-garaging
Calculate Risk Score
curl --request POST \
  --url https://api.example.com/v1/risk-score/ca-garaging \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "policy_holder_id": "<string>",
  "vehicles": [
    {
      "vehicle_id": "<string>",
      "garaging_location": {
        "latitude": 36.890333,
        "longitude": -95.967285
      },
      "body_type": "passenger-car"
    }
  ],
  "version": "v2",
  "naics_code": "492110",
  "effective_date": "2023-11-07T05:31:56Z"
}
'
{
  "policy_holder_id": "<string>",
  "vehicle_risk_scores": [
    {
      "vehicle_id": "<string>",
      "vehicle_risk_score": 0.5,
      "metadata": {
        "coverage": [
          {
            "usstate": "OH",
            "years": [
              2020,
              2021,
              2022,
              2023
            ]
          }
        ],
        "effective_date": "2020-01-01T00:00:00",
        "garaging_location": {
          "latitude": 39.9526,
          "longitude": -83.0036,
          "urbanicity": "rural",
          "usstate": "OH"
        },
        "naics_code": {
          "code": "492110",
          "description": "Retail Trade"
        }
      }
    }
  ],
  "job_type": "ca-garaging-risk-score",
  "version": "v2",
  "errors": null
}

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