{"openapi":"3.1.0","info":{"title":"Warranty Desk","version":"0.1.0","description":"Agent-payable brand / manufacturer warranty lookup with public TRACE receipts. Coverage lengths are quoted from the brand's public page or reported as confidence unknown."},"servers":[{"url":"https://warranty.bot2botlabs.com"}],"paths":{"/api/v1/warranty":{"post":{"operationId":"check_warranty","summary":"Look up a brand's standard warranty and mint a TRACE receipt","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarrantyLookupRequest"}}}},"responses":{"201":{"description":"Created: { lookup, receipt, meter }"},"400":{"description":"validation_error"},"401":{"description":"missing or invalid API key"},"404":{"description":"unknown_brand (known_brands listed)"},"422":{"description":"unsupported_region"}}}},"/api/v1/warranty/{id}":{"get":{"operationId":"get_warranty","summary":"Get one lookup created by this API key","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Missing"}}}},"/api/v1/receipts/{id}":{"get":{"operationId":"get_warranty_receipt","summary":"Public TRACE receipt JSON","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Missing"}}}},"/api/v1/brands":{"get":{"operationId":"list_brands","summary":"Curated brands with default term confidence","responses":{"200":{"description":"OK"}}}},"/status":{"get":{"operationId":"status","summary":"Health, storage kind, billing gates","responses":{"200":{"description":"OK"}}}},"/api/onboard/free-key":{"post":{"operationId":"issue_free_api_key","summary":"Mint a free wdk_ API key for HTTP and MCP","responses":{"200":{"description":"{ key, display_prefix, plan_id, upgrade_url, meter }"}}}},"/api/checkout/onboard":{"post":{"operationId":"onboard_checkout","summary":"Start Stripe Checkout for the metered warranty price (optional Bearer wdk_ key)","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ url, stripe_customer_id, meter_note }"},"503":{"description":"checkout_unavailable (env not configured)"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"WarrantyLookupRequest":{"type":"object","required":["brand"],"properties":{"brand":{"type":"string","description":"Brand name, e.g. Apple, Samsung, Nike"},"product":{"type":"string","description":"Free text, e.g. iPhone 15 Pro"},"category":{"type":"string","description":"Free text, e.g. phone, tv, laptop"},"purchase_date":{"type":"string","format":"date","description":"YYYY-MM-DD"},"as_of":{"type":"string","format":"date","description":"Evaluate coverage as of this date; default today"},"region":{"type":"string","default":"US"}}}}}}