{"openapi":"3.1.0","info":{"title":"Theodeals Independent Logos Price Tracker API","version":"1.0.0","summary":"Read-only Logos Bible Software deal, coupon, price-history, and product lookup API.","description":"Theodeals is the source of truth for tracked Logos pricing, deal quality, coupons, sales, product details, and bundle comparisons. Prices and offers can change; users should verify important details at checkout.","termsOfService":"https://gptapp.theodeals.com/terms","contact":{"url":"https://gptapp.theodeals.com/impressum"}},"servers":[{"url":"https://gptapp.theodeals.com"}],"security":[],"paths":{"/api/v1/health":{"get":{"operationId":"getHealth","summary":"Check API health.","responses":{"200":{"$ref":"#/components/responses/JsonSuccess"}}}},"/api/v1/capabilities":{"get":{"operationId":"getTheodealsCapabilities","summary":"Return supported filters, routing policy, and feature availability.","parameters":[{"name":"dataSourcePolicy","in":"query","required":false,"schema":{"type":"string","enum":["pre_db_only","allow_database"]},"description":"Use pre_db_only for a static-catalog response with no SQL; allow_database performs the legacy capability lookup."}],"responses":{"200":{"description":"Typed JSON response from the matching read-only Theodeals tool.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"supportedLocales":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"supportedCurrencies":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"priceModes":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"productTypes":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"conceptLinks":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"productTypeAliases":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"metricExplanations":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"localePricingNote":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"languages":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"academicLevels":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"traditions":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"approaches":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"useCases":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"searchableProfileFields":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"sortableFields":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"routingPolicy":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"naturalLanguageRoutingExamples":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"dataSource":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"supportedFeatures":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"freshnessRules":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"asOf":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"warnings":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}}},"required":["supportedFeatures"],"additionalProperties":false},"asOf":{"type":"string"}},"required":["ok","data","asOf"],"additionalProperties":false}}}}}}},"/api/v1/deals":{"get":{"operationId":"searchLogosDeals","summary":"Search current and historically strong Logos deals.","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"Natural-language search query, e.g. best Logos deals or Greek grammar."},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string"},"description":"best_deal, lowest_price, highest_dps, biggest_discount, recently_changed, or title."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Maximum number of results."},{"name":"locale","in":"query","required":false,"schema":{"type":"string"},"description":"Requested locale such as en or de."},{"name":"priceMode","in":"query","required":false,"schema":{"type":"string"},"description":"standard, subscription, or both."},{"name":"fallbackPolicy","in":"query","required":false,"schema":{"type":"string","enum":["none","conservative","balanced","broad"]},"description":"Set none to limit search to one pass."},{"name":"dataSourcePolicy","in":"query","required":false,"schema":{"type":"string","enum":["pre_db_only","allow_database"]},"description":"Use pre_db_only for a static-catalog search with no SQL and no database fallback; use allow_database for legacy DB fallback."},{"name":"maxPrice","in":"query","required":false,"schema":{"type":"number"},"description":"Strict maximum price filter."},{"name":"currentSaleOnly","in":"query","required":false,"schema":{"type":"boolean"},"description":"Restrict to explicit current sale campaigns."}],"responses":{"200":{"description":"Typed JSON response from the matching read-only Theodeals tool.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"exactMatches":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{"deal":{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},"proofLinks":{"type":"object","properties":{},"required":[],"additionalProperties":true},"matchType":{"type":"string"},"matchScore":{"type":"integer"},"matchReasons":{"type":"array","items":{"type":"string"}},"constraintViolations":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relaxedConstraints":{"type":"array","items":{"type":"string"}},"dataConfidence":{"type":"string"},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentAvailability":{"type":"string"},"bundleOpportunitySignal":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":["deal","proofLinks","matchType","matchScore","matchReasons","constraintViolations","relaxedConstraints","dataConfidence","lastCheckedAt","currentAvailability","bundleOpportunitySignal"],"additionalProperties":false}},"nearMatches":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{"deal":{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},"proofLinks":{"type":"object","properties":{},"required":[],"additionalProperties":true},"matchType":{"type":"string"},"matchScore":{"type":"integer"},"matchReasons":{"type":"array","items":{"type":"string"}},"constraintViolations":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relaxedConstraints":{"type":"array","items":{"type":"string"}},"dataConfidence":{"type":"string"},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentAvailability":{"type":"string"},"bundleOpportunitySignal":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":["deal","proofLinks","matchType","matchScore","matchReasons","constraintViolations","relaxedConstraints","dataConfidence","lastCheckedAt","currentAvailability","bundleOpportunitySignal"],"additionalProperties":false}},"exploratoryAlternatives":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{"deal":{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},"proofLinks":{"type":"object","properties":{},"required":[],"additionalProperties":true},"matchType":{"type":"string"},"matchScore":{"type":"integer"},"matchReasons":{"type":"array","items":{"type":"string"}},"constraintViolations":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relaxedConstraints":{"type":"array","items":{"type":"string"}},"dataConfidence":{"type":"string"},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentAvailability":{"type":"string"},"bundleOpportunitySignal":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":["deal","proofLinks","matchType","matchScore","matchReasons","constraintViolations","relaxedConstraints","dataConfidence","lastCheckedAt","currentAvailability","bundleOpportunitySignal"],"additionalProperties":false}},"aboveBudgetAlternatives":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{"deal":{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},"proofLinks":{"type":"object","properties":{},"required":[],"additionalProperties":true},"matchType":{"type":"string"},"matchScore":{"type":"integer"},"matchReasons":{"type":"array","items":{"type":"string"}},"constraintViolations":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relaxedConstraints":{"type":"array","items":{"type":"string"}},"dataConfidence":{"type":"string"},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentAvailability":{"type":"string"},"bundleOpportunitySignal":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":["deal","proofLinks","matchType","matchScore","matchReasons","constraintViolations","relaxedConstraints","dataConfidence","lastCheckedAt","currentAvailability","bundleOpportunitySignal"],"additionalProperties":false}},"appliedConstraints":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"queryInterpretation":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"relaxedConstraints":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"searchStagesExecuted":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"resultCount":{"description":"Typed JSON field returned by this Theodeals tool.","type":"integer"},"searchSummary":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"intentRouting":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"intentSections":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"suggestedToolCalls":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"sectionedAlternatives":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relatedDealAlternatives":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"displayHints":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"metricExplanations":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"answerGuidance":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"asOf":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"dataFreshness":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"dataSource":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"warnings":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}}},"required":["exactMatches","nearMatches","exploratoryAlternatives"],"additionalProperties":false},"asOf":{"type":"string"}},"required":["ok","data","asOf"],"additionalProperties":false}}}}}}},"/api/v1/resources":{"get":{"operationId":"findLogosResources","summary":"Find Logos resources by content fit and optional deal constraints.","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"Natural-language search query, e.g. best Logos deals or Greek grammar."},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string"},"description":"best_deal, lowest_price, highest_dps, biggest_discount, recently_changed, or title."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Maximum number of results."},{"name":"locale","in":"query","required":false,"schema":{"type":"string"},"description":"Requested locale such as en or de."},{"name":"priceMode","in":"query","required":false,"schema":{"type":"string"},"description":"standard, subscription, or both."},{"name":"fallbackPolicy","in":"query","required":false,"schema":{"type":"string","enum":["none","conservative","balanced","broad"]},"description":"Set none to limit search to one pass."},{"name":"dataSourcePolicy","in":"query","required":false,"schema":{"type":"string","enum":["pre_db_only","allow_database"]},"description":"Use pre_db_only for a static-catalog search with no SQL and no database fallback; use allow_database for legacy DB fallback."},{"name":"maxPrice","in":"query","required":false,"schema":{"type":"number"},"description":"Strict maximum price filter."},{"name":"currentSaleOnly","in":"query","required":false,"schema":{"type":"boolean"},"description":"Restrict to explicit current sale campaigns."}],"responses":{"200":{"description":"Typed JSON response from the matching read-only Theodeals tool.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"exactMatches":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{"deal":{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},"proofLinks":{"type":"object","properties":{},"required":[],"additionalProperties":true},"matchType":{"type":"string"},"matchScore":{"type":"integer"},"matchReasons":{"type":"array","items":{"type":"string"}},"constraintViolations":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relaxedConstraints":{"type":"array","items":{"type":"string"}},"dataConfidence":{"type":"string"},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentAvailability":{"type":"string"},"bundleOpportunitySignal":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":["deal","proofLinks","matchType","matchScore","matchReasons","constraintViolations","relaxedConstraints","dataConfidence","lastCheckedAt","currentAvailability","bundleOpportunitySignal"],"additionalProperties":false}},"nearMatches":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{"deal":{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},"proofLinks":{"type":"object","properties":{},"required":[],"additionalProperties":true},"matchType":{"type":"string"},"matchScore":{"type":"integer"},"matchReasons":{"type":"array","items":{"type":"string"}},"constraintViolations":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relaxedConstraints":{"type":"array","items":{"type":"string"}},"dataConfidence":{"type":"string"},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentAvailability":{"type":"string"},"bundleOpportunitySignal":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":["deal","proofLinks","matchType","matchScore","matchReasons","constraintViolations","relaxedConstraints","dataConfidence","lastCheckedAt","currentAvailability","bundleOpportunitySignal"],"additionalProperties":false}},"exploratoryAlternatives":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{"deal":{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},"proofLinks":{"type":"object","properties":{},"required":[],"additionalProperties":true},"matchType":{"type":"string"},"matchScore":{"type":"integer"},"matchReasons":{"type":"array","items":{"type":"string"}},"constraintViolations":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relaxedConstraints":{"type":"array","items":{"type":"string"}},"dataConfidence":{"type":"string"},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentAvailability":{"type":"string"},"bundleOpportunitySignal":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":["deal","proofLinks","matchType","matchScore","matchReasons","constraintViolations","relaxedConstraints","dataConfidence","lastCheckedAt","currentAvailability","bundleOpportunitySignal"],"additionalProperties":false}},"aboveBudgetAlternatives":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{"deal":{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},"proofLinks":{"type":"object","properties":{},"required":[],"additionalProperties":true},"matchType":{"type":"string"},"matchScore":{"type":"integer"},"matchReasons":{"type":"array","items":{"type":"string"}},"constraintViolations":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relaxedConstraints":{"type":"array","items":{"type":"string"}},"dataConfidence":{"type":"string"},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentAvailability":{"type":"string"},"bundleOpportunitySignal":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":["deal","proofLinks","matchType","matchScore","matchReasons","constraintViolations","relaxedConstraints","dataConfidence","lastCheckedAt","currentAvailability","bundleOpportunitySignal"],"additionalProperties":false}},"appliedConstraints":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"queryInterpretation":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"relaxedConstraints":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"searchStagesExecuted":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"resultCount":{"description":"Typed JSON field returned by this Theodeals tool.","type":"integer"},"searchSummary":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"intentRouting":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"intentSections":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"suggestedToolCalls":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"sectionedAlternatives":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"relatedDealAlternatives":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"displayHints":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"metricExplanations":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"answerGuidance":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"asOf":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"dataFreshness":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"dataSource":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"warnings":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}}},"required":["exactMatches","nearMatches","exploratoryAlternatives"],"additionalProperties":false},"asOf":{"type":"string"}},"required":["ok","data","asOf"],"additionalProperties":false}}}}}}},"/api/v1/coupons":{"get":{"operationId":"listVerifiedLogosDiscountOffers","summary":"List current Logos coupon codes, voucher offers, and free-resource promotions.","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string"},"description":"Requested locale such as en or de."},{"name":"includeFreeProducts","in":"query","required":false,"schema":{"type":"boolean"},"description":"Include free-resource promotions. Defaults to true."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Maximum number of offers to return."}],"responses":{"200":{"description":"Typed JSON response from the matching read-only Theodeals tool.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"recommendedCoupons":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"currentCoupons":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"requestedLocaleCoupons":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"englishFallbackCoupons":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"birthdayCoupons":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"specialCoupons":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"otherCoupons":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"couponPageUrl":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"requestedLocale":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"localeSummary":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"summary":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"checkoutReadyCouponCount":{"description":"Typed JSON field returned by this Theodeals tool.","type":"integer"},"requestedLocaleCouponCount":{"description":"Typed JSON field returned by this Theodeals tool.","type":"integer"},"englishFallbackCouponCount":{"description":"Typed JSON field returned by this Theodeals tool.","type":"integer"},"birthdayCouponCount":{"description":"Typed JSON field returned by this Theodeals tool.","type":"integer"},"specialCouponCount":{"description":"Typed JSON field returned by this Theodeals tool.","type":"integer"},"checkoutStrategy":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"answerGuidance":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"asOf":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"warnings":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}}},"required":["recommendedCoupons"],"additionalProperties":false},"asOf":{"type":"string"}},"required":["ok","data","asOf"],"additionalProperties":false}}}}}}},"/api/v1/sales":{"get":{"operationId":"listCurrentLogosSales","summary":"List current Logos, Verbum, publisher, monthly, and free-book sales.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Maximum number of sales to return."}],"responses":{"200":{"description":"Typed JSON response from the matching read-only Theodeals tool.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"currentSales":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"markdownSaleLinks":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"linkingRequirement":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"answerGuidance":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"asOf":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"warnings":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}}},"required":["currentSales"],"additionalProperties":false},"asOf":{"type":"string"}},"required":["ok","data","asOf"],"additionalProperties":false}}}}}}},"/api/v1/product/{reference}":{"get":{"operationId":"getLogosProductDetails","summary":"Resolve one Logos/Theodeals product and return details, price context, coupons, and bundle alternatives.","parameters":[{"name":"reference","in":"path","required":true,"schema":{"type":"string"},"description":"Product ID, Logos ID, URL slug, title, or author/title reference."},{"name":"priceMode","in":"query","required":false,"schema":{"type":"string"},"description":"standard, subscription, or both."},{"name":"includePreDbJson","in":"query","required":false,"schema":{"type":"boolean"},"description":"Include PRE-WP/PRE-DB pricing JSON when available."},{"name":"dataSourcePolicy","in":"query","required":false,"schema":{"type":"string","enum":["pre_db_only","allow_database"]},"description":"Use pre_db_only for static-catalog core product details without database fallback; database-only history/coupon/relationship fields remain empty."}],"responses":{"200":{"description":"Typed JSON response from the matching read-only Theodeals tool.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"resolution":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"product":{"description":"Typed JSON field returned by this Theodeals tool.","anyOf":[{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},{"type":"null"}]},"priceHistorySummary":{"description":"Typed JSON field returned by this Theodeals tool.","anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"activeCoupons":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"bundleAlternatives":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"sourceJsonProfiles":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"preDbPricingJson":{"description":"Typed JSON field returned by this Theodeals tool.","anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"dataSource":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"asOf":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"warnings":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}}},"required":["product"],"additionalProperties":false},"asOf":{"type":"string"}},"required":["ok","data","asOf"],"additionalProperties":false}}}}}}},"/api/v1/price-history/{reference}":{"get":{"operationId":"getLogosPriceHistory","summary":"Return tracked price-history summary and points for one product.","parameters":[{"name":"reference","in":"path","required":true,"schema":{"type":"string"},"description":"Product ID, Logos ID, URL slug, title, or author/title reference."},{"name":"dateRange","in":"query","required":false,"schema":{"type":"string"},"description":"30d, 90d, 180d, 1y, 2y, or all."},{"name":"priceMode","in":"query","required":false,"schema":{"type":"string"},"description":"standard, subscription, or both."}],"responses":{"200":{"description":"Typed JSON response from the matching read-only Theodeals tool.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"productId":{"description":"Typed JSON field returned by this Theodeals tool.","type":"integer"},"product":{"description":"Typed JSON field returned by this Theodeals tool.","anyOf":[{"type":"object","properties":{"identity":{"type":"object","properties":{},"required":[],"additionalProperties":true},"profile":{"type":"object","properties":{},"required":[],"additionalProperties":true},"currentPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"subscriptionPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"listPrice":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"discountPercent":{"type":"number"},"DPS":{"type":"number"},"dealScore":{"type":"number"},"dealStrengthScore":{"type":"number"},"dealStrengthLabel":{"type":"string"},"dealType":{"type":"string"},"isAllTimeLow":{"type":"boolean"},"isCurrentSale":{"type":"boolean"},"isCurrentlyDiscounted":{"type":"boolean"},"bestPriceSinceDays":{"anyOf":[{"type":"integer"},{"type":"null"}]},"currentSale":{"anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"applicableCouponCount":{"type":"integer"},"resourceCount":{"type":"integer"},"volumeCount":{"type":"integer"},"isMultiVolume":{"type":"boolean"},"semanticProductKind":{"type":"string"},"goodResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topResourceShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"pricingScope":{"type":"string"},"dataConfidence":{"type":"string"},"verificationStatus":{"type":"string"},"priceClaimConfidence":{"type":"string"},"missingFields":{"type":"array","items":{"type":"string"}},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["identity","profile","currentPrice","subscriptionPrice","regularPrice","listPrice","discountPercent","DPS","dealScore","dealStrengthScore","dealStrengthLabel","dealType","isAllTimeLow","isCurrentSale","isCurrentlyDiscounted","bestPriceSinceDays","currentSale","applicableCouponCount","resourceCount","volumeCount","isMultiVolume","semanticProductKind","goodResourceShare","topResourceShare","reasons","warnings","pricingScope","dataConfidence","verificationStatus","priceClaimConfidence","missingFields","updatedAt"],"additionalProperties":false},{"type":"null"}]},"summary":{"description":"Typed JSON field returned by this Theodeals tool.","anyOf":[{"type":"object","properties":{},"required":[],"additionalProperties":true},{"type":"null"}]},"points":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"priceHistoryProofLink":{"description":"Typed JSON field returned by this Theodeals tool.","anyOf":[{"type":"string"},{"type":"null"}]},"claimLinks":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"_meta":{"description":"Typed JSON field returned by this Theodeals tool.","type":"object","properties":{},"required":[],"additionalProperties":true},"answerGuidance":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}},"asOf":{"description":"Typed JSON field returned by this Theodeals tool.","type":"string"},"warnings":{"description":"Typed JSON field returned by this Theodeals tool.","type":"array","items":{"type":"string"}}},"required":["summary","points"],"additionalProperties":false},"asOf":{"type":"string"}},"required":["ok","data","asOf"],"additionalProperties":false}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"responses":{"JsonSuccess":{"description":"JSON response containing ok, data, and asOf fields.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"},"asOf":{"type":"string"}},"required":["ok","asOf"]}}}}}},"externalDocs":{"description":"Theodeals website","url":"https://theodeals.com/"}}