SIMULATED CARRIER — TEST ENVIRONMENT — NOT A REAL INSURER. Do not enter real customer data.

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

MethodPathPurpose
GET/api/v1/healthNo auth. Returns carrier info and maintenance flag.
POST/api/v1/quotesRate 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

InputEffect
County Brunswick, Carteret, Currituck, Dare, Hyde, New Hanover, Onslow, Pamlico or PenderHome REFERRED to NCIUA (beach territory)
Roof more than 20 years old · trampoline · unfenced pool · vacant or short-term rental · 3+ claimsHome DECLINED
Dog breed Pit Bull, Rottweiler, Wolf Hybrid or Presa CanarioHome REFERRED
Street name containing "Creek"Simulated CLUE finds a water claim (price goes up)
Driver license number ending in 9Simulated MVR finds a minor speeding ticket
Driver license number ending in 77Simulated MVR finds an at-fault accident
Driver license number starting with 000Suspended license — auto DECLINED
More than 6 driving-record pointsAuto DECLINED
Older home, old roof, protection class 9–10, prior claimsUsually 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.