get_deal
ClaudeReturns current details for one deal from search_device_deals or search_sim_only_deals. All costs are in GBP; a stored total cost may span a device payment term longer than the airtime contract. The conditions a deal depends on are in existingCustomerOnly, pricing.adjustments, scheduledIncreases, the pricing payment components, legalText, promotionDetails and chargeableExtras. A null allowance is unknown unless its corresponding unlimited flag is true; null monetary values are unknown, not zero; discount method=unknown means the requirements are unknown. An unknown valueUnit means the recorded value cannot safely be interpreted as GBP or a percentage. detailsTruncated=true means some terms or extras are missing here; the full versions are on the retailer page reached through dealUrl. Stock, marketplace seller, delivery and returns are not recorded; the retailer page reached through dealUrl is the source for them. Read-only catalogue lookup of UK phones, deals, networks and prices. It cannot order, take payment, cancel, transfer a number, change an account or check credit.
get_device
ClaudeReturns a device's recorded specifications, average review score out of 5, review count and recorded variants for a versionId from search_devices. The average review score is null when there are no reviews. Missing specifications are unknown, not proof a feature is absent. allVariants contains every colour/storage pair recorded for this device in our catalogue, including variants without current eligible deals; this is not a complete manufacturer catalogue or proof of availability. availableVariants contains only pairs with current eligible contract, upgrade or SIM-free deals. Both lists are capped at 100 pairs; detailsTruncated=true signals incomplete details. Reviews appear once in device. Specifications use typed nullable values; null means unknown. Deal filter metadata belongs to page one of search_device_deals for the requested dealType. Live prices come from search_device_deals. Read-only catalogue lookup of UK phones, deals, networks and prices. It cannot order, take payment, cancel, transfer a number, change an account or check credit.
get_device_price_history
ClaudeReturns recorded device price history for a versionId from search_devices. Without specifier it returns a paginated scopeCatalog of available scopes, with nextPage for more. Specifiers are the advertised scope specifiers, including historical networks that may have no current deals. get_networks describes current eligibility, not historical coverage. Scoped calls omit the catalog unless includeScopeCatalog=true. Default results are lightweight lifetime summaries; includePoints=true adds up to maxPoints daily values (maximum 366). History requires a 7-day inclusive calendar span, not seven observations. Calendar dates use UK dates; daily prices represent recorded intervals, not a capture every day. plausibleMinValueGbp/plausibleMaxValueGbp exclude values outside 0.25 to 4 times the series median; statisticsPolicy and statisticsPeriod describe that filtering. These are recorded-scope statistics, not an all-time market low or current offer. unlimited-data and no-upfront-cost have separately recorded scopes across networks; overall and network history do not show their lows. Only storage/colour and contracts/term composite scopes are supported. Other scopes cannot be combined; gifts and bad-credit-specific history are unsupported. hasHistory=false does not prove a deal never existed. Read-only catalogue lookup of UK phones, deals, networks and prices. It cannot order, take payment, cancel, transfer a number, change an account or check credit.
get_networks
ClaudeLists network brands with currently eligible deals and their underlying carrier, using the recorded catalogue relationships. underlyingNetwork filters by carrier name or slug (for example EE). dealType is all (default), device_contract, device_upgrade, sim_phone or sim_data. versionId optionally restricts device categories to one device; all with a versionId means all applicable device categories. SIM categories do not accept versionId. Returned name values are the networkBrands values accepted by search_device_deals and search_sim_only_deals. A carrier operating its own brand reports itself as its underlying network. An empty list means no eligible deals match; shared carrier does not imply identical features or service terms. Read-only catalogue lookup of UK phones, deals, networks and prices. It cannot order, take payment, cancel, transfer a number, change an account or check credit.
get_sim_only_price_history
ClaudeReturns recorded monthly GBP history for 30-day rolling phone SIM deals; data-only SIMs and longer commitments are not represented. Without specifier it lists stored networks in a paginated scopeCatalog, including networks without current deals. Scoped calls omit the catalog unless includeScopeCatalog=true. dataBand optionally selects one data band; availableDataBands describes reportable bands for the selected network (or all networks). Finite bands mean at least the allowance and may include unlimited tariffs. Default results are lightweight lifetime summaries; includePoints=true adds up to maxPoints daily values (maximum 366). History requires an inclusive calendar span of at least 7 days, not seven observations. Dates use UK calendar dates; daily values represent recorded intervals. plausibleMinValueGbp/plausibleMaxValueGbp exclude values outside 0.25 to 4 times the series median; statisticsPolicy and statisticsPeriod describe that filtering. These are recorded-scope statistics, not an all-time market low or evidence of current availability. Network plus dataBand is supported. hasHistory=false does not prove a deal never existed. Read-only catalogue lookup of UK phones, deals, networks and prices. It cannot order, take payment, cancel, transfer a number, change an account or check credit.
search_device_deals
ClaudeFinds live contract, SIM-free purchase or upgrade deals for one exact device version, identified by the versionId from search_devices. dealType is contract (default), sim_free or upgrade. SIM-free purchases exclude PAYG bundles and do not accept airtime/network filters; maxUpfrontGbp limits the purchase cost. Upgrades require existing-customer eligibility checks with the retailer. unlimitedData=true requires unlimited data and cannot be combined with minDataGb greater than zero. networkBrands filters the advertised tariff network brand, which may differ from the underlying network that carries the service; get_networks maps brands to underlying carriers. All costs are in GBP. A stored total cost may span a device payment term longer than the recorded airtime commitment. pricing.contractMonths comes from the recorded tariff; airtimeCostedMonths and totalCostHorizonMonths describe the stored calculation. pricing.adjustments lists codes or redemption steps that the quoted price depends on. priceConditionsTruncated=true means the conditions were shortened and get_deal returns them in full. Cashback filters apply to tariff/deal cashback; separate device promotional cashback may remain and is included in returned pricing. Cashback values mean: none excludes tariff/deal cashback, automatic_or_none allows automatic cashback or no cashback, and manual_or_none allows redemption cashback or no cashback. The first page includes availableFilters for the versionId and dealType, even when no deals match the other filters, so a request with only versionId returns deals and the valid filter choices together. colours accepts names, slugs or recorded colour groups (for example Blue or natural-titanium); exact names/slugs take precedence, otherwise a group matches all its available variants. networkBrands takes network names, retailerId takes retailers[].id, and storageGb/contractMonths take the listed values. Multiple values within a list are alternatives; different filters must all match. Omitted limits and empty lists impose no restriction. Results contain 10 deals per page, with nextPage for the next page; paginationLimited=true means more deals match than can be paged. Page-one availableFilters describe the device/dealType regardless of the remaining search filters. Choices do not guarantee every combination has deals; empty choices mean none available and truncated=true means lists were capped at 100 choices each. Later pages return availableFilters=null. Read-only catalogue lookup of UK phones, deals, networks and prices. It cannot order, take payment, cancel, transfer a number, change an account or check credit.
search_devices
ClaudeDiscovers supported devices by name or structured filters. Query is optional: devices can be browsed by device type, manufacturer, operating system, release year, screen size, height, width, depth (thickness), storage, review score and deal budget. Measurement limits are inclusive; screen size is diagonal inches and physical dimensions are recorded height x width x depth in millimetres. Devices with unknown or ambiguous measurements are excluded when those filters are used. Reviews are out of 5 and missing reviews are unknown. Price filters require eligible deals matching the selected variant specifications; without dealType they default to contracts. Each result's versionId identifies that device in the other device tools. Results contain up to 20 devices per page, with nextPage for the next page; at the 100-page cap paginationLimited=true means more matches exist than can be paged. Without dealType or a price filter, devices without current deals may be returned. A text query that matches no device returns an empty list; a corrected spelling or shorter query may match. Read-only catalogue lookup of UK phones, deals, networks and prices. It cannot order, take payment, cancel, transfer a number, change an account or check credit.
search_sim_only_deals
ClaudeFinds live SIM-only deals, which have no device versionId. SIM rows have device=null and an explicit simType: phone for phone SIMs or data for data-only SIMs. Network brands are advertised tariff brands, not underlying carriers. unlimitedData=true requires unlimited data and cannot be combined with minDataGb greater than zero. The first page includes availableFilters with eligible network names, retailer IDs and contractMonths for the selected simType, regardless of the remaining search filters, so a request with only simType returns deals and the valid choices together. Choices do not guarantee every combination has deals; empty choices mean none available and truncated=true means lists were capped at 100 choices each. Later pages return availableFilters=null. get_networks maps brands to underlying carriers; its SIM-only entries have dealTypes sim_phone or sim_data. Multiple values within a list are alternatives; different filters must all match. Omitted limits and empty lists impose no restriction. Costs are GBP. pricing.adjustments lists code or redemption requirements; priceConditionsTruncated=true means get_deal returns the full conditions. Cashback modes: any, none (no tariff/deal cashback), automatic_or_none, manual_or_none. Results contain 10 deals per page, with nextPage for the next page; paginationLimited=true means more deals match than can be paged. Read-only catalogue lookup of UK phones, deals, networks and prices. It cannot order, take payment, cancel, transfer a number, change an account or check credit.
