1ACME Mutual (Simulated) — Rating API v1
A fake carrier rating API for testing Quote Desk. North Carolina homeowners (HO-3) and personal auto. All prices are fictional.
Authentication
An agency user creates a key under Rater credentials. Keys belong to the agency and can be revoked there at any time.
Authorization: ACME-Key ak_xxxxxxxxxxxxxxxx:sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /api/v1/health | No auth. Returns carrier info and maintenance flag. |
| POST | /api/v1/quotes | Rate a risk. 201 quote, 422 validation errors, 401 bad/revoked key, 429 rate limited, 503 maintenance or simulated outage. |
| GET | /api/v1/quotes/{quoteNumber} | Retrieve a quote created by your agency. |
Request (POST /api/v1/quotes)
{
"clientReference": "your-id-123",
"lines": ["home", "auto"],
"effectiveDate": "2026-12-01",
"applicant": { "firstName": "Jane", "lastName": "Sample", "dateOfBirth": "1985-04-12", "email": "", "phone": "", "maritalStatus": "Married" },
"address": { "street": "100 Oak St", "city": "Raleigh", "state": "NC", "zip": "27601", "county": "Wake" },
"home": {
"yearBuilt": 2005, "squareFeet": 2400, "construction": "frame | masonry_veneer | masonry",
"roofYear": 2019, "occupancy": "primary | secondary | rental_12mo | short_term_rental | vacant",
"protectionClass": 3, "claimsLast5Years": 0, "alarm": "none | local | central",
"pool": "none | fenced | unfenced", "trampoline": false, "woodstove": false, "dogs": ["Labrador"],
"coverageA": 450000, "deductible": 1000, "liabilityLimit": 300000
},
"auto": {
"liabilityLimits": "30/60/25 | 50/100/50 | 100/300/100 | 250/500/100",
"drivers": [ { "firstName": "Jane", "lastName": "Sample", "dateOfBirth": "1985-04-12", "licenseNumber": "NC1234560",
"licenseState": "NC", "yearsLicensed": 20, "violations": 0, "atFaultAccidents": 0, "goodStudent": false } ],
"vehicles": [ { "year": 2022, "make": "Honda", "model": "CR-V", "vin": "1HGCM82633A004352",
"use": "commute | pleasure | business", "compCollDeductible": "none | 250/500 | 500/500 | 1000/1000" } ]
}
}
Response
status is QUOTED, PARTIAL (one line declined), REFERRED or DECLINED. Each line has its premium and an itemized rating worksheet, or a reason.
consentToRate.required is true when the 1ACME premium exceeds the approved-rate premium, with the NC-style disclosure text.
priceChangedAfterReports is true when the simulated MVR/CLUE found more than the application declared.
Test triggers
| Input | Effect |
|---|---|
| County Brunswick, Carteret, Currituck, Dare, Hyde, New Hanover, Onslow, Pamlico or Pender | Home REFERRED to NCIUA (beach territory) |
| Roof more than 20 years old · trampoline · unfenced pool · vacant or short-term rental · 3+ claims | Home DECLINED |
| Dog breed Pit Bull, Rottweiler, Wolf Hybrid or Presa Canario | Home REFERRED |
| Street name containing "Creek" | Simulated CLUE finds a water claim (price goes up) |
Driver license number ending in 9 | Simulated MVR finds a minor speeding ticket |
Driver license number ending in 77 | Simulated MVR finds an at-fault accident |
Driver license number starting with 000 | Suspended license — auto DECLINED |
| More than 6 driving-record points | Auto DECLINED |
| Older home, old roof, protection class 9–10, prior claims | Usually triggers consent to rate |
Simulator admins can add latency, random 503s, maintenance mode, a lower rate limit, turn MFA off, or switch the portal to layout v2 (renamed fields, new step order) under /sim-admin.