{"openapi":"3.1.0","info":{"title":"Diaglo Vehicle Data API","version":"2026-11-08","description":"Vehicle identification and technical data by VIN. One VIN per request; no bulk, search or list endpoints. Units per call: core 1, workshop +2, safety +2, valuation +2. Empty optional modules are refunded. Storing or reselling the data is not allowed by the terms of service.","termsOfService":"https://diaglo.ai/terms","contact":{"email":"contact@diaglo.ai"}},"servers":[{"url":"https://api.diaglo.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key from your Diaglo account (dgk_live_… or dgk_test_…)."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message"]}}}}},"paths":{"/v1/vin/{vin}":{"get":{"summary":"Vehicle report for a VIN","parameters":[{"name":"vin","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-HJ-NPR-Z0-9]{17}$"},"description":"17-character VIN (ISO 3779). North-American VINs must have a valid check digit."},{"name":"modules","in":"query","required":false,"schema":{"type":"string","example":"workshop,safety"},"description":"Comma-separated extra modules: workshop, safety, valuation, or all."}],"responses":{"200":{"description":"Vehicle report"},"400":{"description":"Invalid VIN or parameters (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Subscription inactive or monthly quota used up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Account suspended, IP not allowed, or sandbox key used on a non-demo VIN","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"VIN could not be decoded (1 unit charged) or no data for the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate, concurrency or daily distinct-VIN limit; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/usage":{"get":{"summary":"Plan, quota and usage (free)","responses":{"200":{"description":"Usage"},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mcp":{"post":{"summary":"Model Context Protocol endpoint (Streamable HTTP, stateless)","description":"Tools: decode_vin, get_usage. Same key, limits and units as REST.","responses":{"200":{"description":"JSON-RPC response"},"202":{"description":"Notification accepted"},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}