{"openapi":"3.1.0","info":{"title":"MontanaPlate Public API","version":"1.0.0","description":"Public MontanaPlate guidance, service charges, itemized estimates, and consultation handoffs. No private customer or order data is exposed."},"servers":[{"url":"https://montanaplate.com"}],"paths":{"/api/v1/catalog":{"get":{"operationId":"listServices","summary":"List vehicle registration services and current base charges","responses":{"200":{"description":"MontanaPlate service catalog","content":{"application/json":{"schema":{"type":"object","required":["version","updated","currency","services","llcFormationCharge","registeredAgentCharge","plateOptions","priceNote","consultationUrl"],"properties":{"version":{"type":"string"},"updated":{"type":"string","format":"date"},"currency":{"type":"string","enum":["USD"]},"services":{"type":"array","items":{"type":"object","required":["vehicleType","baseRegistrationCharge","description","url"],"properties":{"vehicleType":{"type":"string","enum":["Auto Registration","Cargo Trailer Registration","Travel Trailer Registration","RV Registration","Powersport Registration","Watercraft Registration"]},"baseRegistrationCharge":{"type":"number"},"description":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"llcFormationCharge":{"type":"number"},"registeredAgentCharge":{"type":"number"},"plateOptions":{"type":"array","items":{"type":"object","required":["id","name","description","fee"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"fee":{"type":"number"}}}},"priceNote":{"type":"string"},"consultationUrl":{"type":"string","format":"uri"}}}}}}}}},"/api/v1/guides":{"get":{"operationId":"searchGuides","summary":"Search public MontanaPlate guides","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":120}},{"name":"kind","in":"query","schema":{"type":"string","enum":["montana_llc","situation","state","brand","vehicle"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":8}}],"responses":{"200":{"description":"Ranked matching guides","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","required":["id","kind","title","summary","content","url","category","sourceUrls","updated"],"properties":{"id":{"type":"string","description":"Stable guide id; pass to /api/v1/guide."},"kind":{"type":"string","enum":["montana_llc","situation","state","brand","vehicle"]},"title":{"type":"string"},"summary":{"type":"string"},"content":{"type":"string","description":"Plain-text guide content for retrieval."},"url":{"type":"string","format":"uri"},"category":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}},"updated":{"type":"string","format":"date"}}}}}}}}}}}},"/api/v1/guide":{"get":{"operationId":"getGuide","summary":"Read a public guide by its id","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Guide","content":{"application/json":{"schema":{"type":"object","required":["id","kind","title","summary","content","url","category","sourceUrls","updated"],"properties":{"id":{"type":"string","description":"Stable guide id; pass to /api/v1/guide."},"kind":{"type":"string","enum":["montana_llc","situation","state","brand","vehicle"]},"title":{"type":"string"},"summary":{"type":"string"},"content":{"type":"string","description":"Plain-text guide content for retrieval."},"url":{"type":"string","format":"uri"},"category":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}},"updated":{"type":"string","format":"date"}}}}}},"404":{"description":"Guide not found"}}}},"/api/v1/estimate":{"post":{"operationId":"estimatePrice","summary":"Calculate itemized MontanaPlate service charges without creating an order","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["vehicleType"],"properties":{"vehicleType":{"type":"string","enum":["Auto Registration","Cargo Trailer Registration","Travel Trailer Registration","RV Registration","Powersport Registration","Watercraft Registration"]},"luxuryMsrp":{"type":"string","enum":["yes","no"],"default":"no"},"foreignPurchase":{"type":"string","enum":["yes","no"],"default":"no"},"electrification":{"type":"string","enum":["none","ev1","ev2","hybrid1"],"default":"none"},"plateStyle":{"type":"string","enum":["Standard Plate","Custom Plate"],"default":"Standard Plate"},"expedited":{"type":"boolean","default":false},"financed":{"type":"string","enum":["yes","no"],"default":"no"},"hasMontanaLlc":{"type":"string","enum":["yes","no"]},"extraVehicles":{"type":"array","maxItems":4,"items":{"type":"object","required":["vehicleType"],"properties":{"vehicleType":{"type":"string","enum":["Auto Registration","Cargo Trailer Registration","Travel Trailer Registration","RV Registration","Powersport Registration","Watercraft Registration"]},"luxuryMsrp":{"type":"string","enum":["yes","no"],"default":"no"},"foreignPurchase":{"type":"string","enum":["yes","no"],"default":"no"},"electrification":{"type":"string","enum":["none","ev1","ev2","hybrid1"],"default":"none"},"plateStyle":{"type":"string","enum":["Standard Plate","Custom Plate"],"default":"Standard Plate"},"expedited":{"type":"boolean","default":false},"financed":{"type":"string","enum":["yes","no"],"default":"no"}}}}}}}}},"responses":{"200":{"description":"Itemized service estimate","content":{"application/json":{"schema":{"type":"object","required":["currency","total","lineItems","updated","note","consultationUrl"],"properties":{"currency":{"type":"string","enum":["USD"]},"total":{"type":"number"},"lineItems":{"type":"array","items":{"type":"object","required":["label","amount"],"properties":{"label":{"type":"string"},"amount":{"type":"number"}}}},"updated":{"type":"string","format":"date"},"note":{"type":"string"},"consultationUrl":{"type":"string","format":"uri"}}}}}},"400":{"description":"Invalid input"}}}},"/api/v1/consultation":{"get":{"operationId":"startConsultation","summary":"Get order and text links for a guided consultation; no lead is created","parameters":[{"name":"topic","in":"query","schema":{"type":"string","maxLength":120}},{"name":"guide_id","in":"query","schema":{"type":"string","maxLength":250}}],"responses":{"200":{"description":"MontanaPlate handoff links","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}