changedInput schema / properties / buyer_area / description
Previous value: -"Optional region or city to narrow to, see the country notes below. AR: not used; all national public bodies are summarised together. AU: part of a federal agency's name ('Defence', 'Health', 'Parliamentary Services'); contracts have no delivery place. BR: two-letter state code of the buying body ('SP', 'RJ', 'DF'). BR: optional two-letter state code of the buyer (SP, RJ, MG, DF...); left out = all of Brazil. A state with fewer than 5 contracts for the purchase gets no figure. Alberta: write Alberta to get Alberta government departments; these are contracts awarded without competition. Toronto: write Toronto to get contracts awarded by the City of Toronto; all divisions are summarised together. CA: federal = the Treasury Board proactive disclosure of federal contracts over CA$10,000 (this source). Quebec = SEAO, Alberta = sole-source list; leave it out for CanadaBuys award notices. CA: not used; all federal buyers are summarised together. Quebec: write Quebec to get Quebec public buyers (ministries, school service centres, cities, municipalities); all of Quebec is summarised together. CO: not used; all public buyers are summarised together. CZ: not used; all Czech public bodies are summarised together. DE: not used; all German public buyers are summarised together. ES: not used; all Spanish public buyers are summarised together. EU and EEA: the buyer's city, as written on the notice (e.g. 'Lyon', 'München'). FR: not used; all French public buyers are summarised together. GB: not used; all UK public buyers are summarised together. IE: not used; all Irish public buyers are summarised together. NG: not used; all federal public bodies are summarised together. NZ: part of the posting agency's name ('Auckland Council', 'Waka Kotahi', 'Health'); needs at least 5 awards. PL: not used; all Polish public buyers are summarised together. PT: not used; all Portuguese public buyers are summarised together. SG: part of an agency name ('National Library Board', 'Health Sciences Authority'). TH: not used; all Bangkok Metropolitan Administration buyers are summarised together. UA: not used; all Ukrainian public buyers are summarised together. Chicago: write Chicago to get City of Chicago awards (original awards of US$1,000 or more). US: a state name or code ('Virginia', 'VA'); filters by where the work is done. ZA: not used; all public buyers are summarised together."New value: +"Optional region or city to narrow to, see the country notes below. AR: not used; all national public bodies are summarised together. AU: part of a federal agency's name ('Defence', 'Health', 'Parliamentary Services'); contracts have no…"
changedInput schema / properties / country / description
Previous value: -"AR = Argentina (national public bodies, COMPR.AR); AU = Australia (AusTender federal contract notices); BR = Brazil (unit prices of furniture in public purchases, Compras.gov.br); BR = Brazil (initial public contracts published on the PNCP national procurement portal); CA = Canada (buyer_area=Alberta here: Alberta government sole-source service contracts; federal contracts come from CanadaBuys, Quebec from SEAO); CA = Canada (buyer_area=Toronto here: contracts awarded by the City of Toronto; federal contracts come from CanadaBuys); CA = Canada (buyer_area=federal here: federal contract values over CA$10,000 from the Treasury Board proactive disclosure; without buyer_area, federal award notices from CanadaBuys); CA = Canada (federal award notices on CanadaBuys); CA = Canada (buyer_area=Quebec here: SEAO award notices of Quebec public buyers; federal contracts come from CanadaBuys); CO = Colombia (signed public contracts in SECOP II); CZ = Czech Republic (public contracts, Registr smluv); DE = Germany (public contract award notices, Bekanntmachungsservice); ES = Spain (awarded public contracts, PLACSP); EU and EEA states, by the country of the public buyer, as ISO codes: AT = Austria, BE = Belgium, BG = Bulgaria, HR = Croatia, CY = Cyprus, CZ = Czechia, DK = Denmark, EE = Estonia, FI = Finland, FR = France, DE = Germany, GR = Greece, HU = Hungary, IE = Ireland, IT = Italy, LV = Latvia, LT = Lithuania, LU = Luxembourg, MT = Malta, NL = the Netherlands, PL = Poland, PT = Portugal, RO = Romania, SK = Slovakia, SI = Slovenia, ES = Spain, SE = Sweden, IS = Iceland, LI = Liechtenstein, NO = Norway. Award notices above the EU procurement thresholds from TED.; FR = France (awarded public contracts, DECP); GB = United Kingdom (Contracts Finder awarded contracts); IE = Ireland (public contract awards, eTenders); NG = Nigeria (federal public bodies, NOCOPO); NZ = New Zealand (GETS contract award notices); PL = Poland (public contracts, e-Zamowienia BZP); PT = Portugal (public contracts, Portal BASE); SG = Singapore (GeBIZ tenders); TH = Thailand, Bangkok city administration only (Bangkok Metropolitan Administration contracts); UA = Ukraine (signed public contracts, Prozorro); US = United States (buyer_area=Chicago here: City of Chicago contract awards; federal contracts come from USAspending); US = United States, federal schedule contracts' hourly labour ceiling rates (GSA CALC+); US = United States, federal agencies' contracts only (not state or local governments); ZA = South Africa (signed public contracts on the National Treasury eTenders portal)"New value: +"AR = Argentina (national public bodies, COMPR.AR); AU = Australia (AusTender federal contract notices); BR = Brazil (unit prices of furniture in public purchases, Compras.gov.br); BR = Brazil (initial public contracts published on the PNCP national…"
changedInput schema / properties / cpv / description
Previous value: -"Optional official product code, to be exact, where the source uses one (the country notes say which code system), e.g. the CPV code 30213100 for portable computers; a prefix such as 3021 covers the whole group. AR: not used; COMPR.AR has its own product groups, put the group in what. AU: a UNSPSC code or prefix of 2 to 8 digits (43211503 = notebook computers, 4321 = computers), not a CPV code. BR: optional Compras.gov.br product-family code as 'pdm:310' instead of a word. BR: not used. Alberta: not used. Toronto: not used. CA federal: not used. CA: not used. Quebec: not used. CO: not used. CZ: not used; the register has no product codes. DE: a CPV code of 2 digits (a division) or 4 to 8 digits (read as the 4-digit group, e.g. 3021); used instead of the words in what. ES: a CPV code of 2 digits (a division, e.g. 45 construction) or 4 to 8 digits (read as the 4-digit group, e.g. 3021); used instead of the words in what (what is still required, say anything such as 'works'). EU and EEA: an 8-digit CPV code (30213100) or a shorter prefix (3021) for a whole group; a lot counts when its own main product code is in that group. FR: a CPV code of 2 digits (a division) or 4 to 8 digits (read as the 4-digit group, e.g. 3021); used instead of the words in what. GB: a CPV code of 2 digits (a division) or 4 to 8 digits (read as the 4-digit group, e.g. 3021); used instead of the words in what. IE: a CPV code of 2 digits (a division) or 4 to 8 digits (read as the 4-digit group, e.g. 4523); used instead of the words in what. NG: not used; put the purchase theme in what. NZ: not used (New Zealand notices carry no CPV codes). PL: a CPV code of 2 digits (a division) or 4 to 8 digits (read as the 4-digit group, e.g. 3021); used instead of the words in what. PT: a CPV code of 2 digits (a division) or 4 to 8 digits (read as the 4-digit group, e.g. 3021); used instead of the words in what. SG: not used (Singapore tenders carry no CPV codes). TH: not used. UA: a product code of 2 digits (a division) or 4 to 8 digits (read as the 4-digit group, e.g. 3021); used instead of the words in what. Chicago: not used. US hourly labour rates: optional GSA schedule SIN as 'sin:541330ENG'. US: a product or service code (PSC, e.g. 7010 or psc:7010) or a NAICS code (e.g. 334111 or naics:334111) instead of the keyword; there are no CPV codes in the US. ZA: not used."New value: +"Optional official product code, to be exact, where the source uses one (the country notes say which code system), e.g. the CPV code 30213100 for portable computers; a prefix such as 3021 covers the whole group. AR: not used; COMPR.AR has…"
changedInput schema / properties / months / description
Previous value: -"How many recent months of awards to include. Default 24. AR: not used; each figure covers awards dated in the newest 12 months. AU: not used; the newest 21 days of notices are read. BR: 1 to 60 months of purchases, by purchase date (default 24). BR: not used; each figure covers the contracts published in the last 7 days. Alberta: not used; each figure covers contracts starting in the newest 24 months. Toronto: not used; each figure covers awards dated in the newest 24 months. CA federal: not used; the figure covers the newest 24 months of contract dates in the file. CA: not used; each figure covers the newest 24 months of awards. Quebec: not used; each figure covers awards dated in the newest 12 months. CO: not used; each figure covers the newest 12 months of signed contracts. CZ: not used; each figure covers contracts published in the newest weeks (the answer gives the dates). DE: not used; each figure covers contracts concluded in the newest 6 months. ES: not used; each figure covers awards dated in the newest one to two days. EU and EEA: up to 60; only the newest 1,000 matching notices are read, so a very common purchase covers a shorter period than asked (the answer says so). FR: not used; each figure covers contracts notified in the newest 12 months. GB: not used; each figure covers the notices published in the newest two weeks (the answer gives the dates). IE: not used; each figure covers the newest 24 months of awards. NG: not used; each figure covers the 24 months up to the newest month with at least 20 signed contracts (late 2024). NZ: not used; the newest 24 months of awards are always shown. PL: not used; each figure covers the notices published in the newest weeks (the answer gives the dates). PT: not used; each figure covers contracts signed in the newest 12 months. SG: 1 to 60 months by award date; the dataset covers FY2021 onwards and is updated about yearly. TH: not used; each figure covers the newest 24 months of contracts. UA: not used; each figure covers contracts signed in the newest 90 days, from a daily sample of the newest contracts. Chicago: not used; each figure covers awards approved in the newest 24 months. US: 1 to 60 months of new awards, read in up to 12 slices. ZA: not used; each figure covers the newest 24 months of signed contracts."New value: +"How many recent months of awards to include. Default 24. AR: not used; each figure covers awards dated in the newest 12 months. AU: not used; the newest 21 days of notices are read. BR: 1 to 60 months of purchases, by purchase date…"
changedInput schema / properties / what / description
Previous value: -"What was bought, in plain words: 'laptops', 'school meals', 'road resurfacing', 'office cleaning', 'electricity', 'ambulances', 'waste collection'. Common purchases are matched to official product codes; anything else is searched as free text in the award notices. AR: 'all' or a COMPR.AR product group (rubro), in Spanish or English for the common ones ('informatica' or 'computers', 'alimentos' or 'food', 'limpieza' or 'cleaning'). An unknown word lists the groups. AU: a word or phrase searched in the contract title and description (common purchases such as 'laptops' or 'catering' also use their UNSPSC code). Federal agencies only. BR: office or school furniture in plain words ('filing cabinet', 'office chair', 'desk', 'school desk', 'whiteboard', 'safe', 'armchair'; Portuguese words such as 'cadeira' also work). Other goods are not covered. The figure is a UNIT price. BR: a common purchase in plain words, English or Portuguese ('school meals', 'merenda escolar', 'security guard services', 'cleaning services', 'laptops', 'ambulances', 'printers', 'diesel'). Recognised from Portuguese words in the contract description; other wording is not searched. Alberta: optional (left out = all); what=all for every sole-source service contract, or a common service in plain words ('consultancy', 'legal services', 'IT services', 'software', 'translation services'). Toronto: 'all', or one of 'construction services', 'goods and services', 'professional services' (the City's own three categories), or a common purchase such as 'laptops' (usually too few awards for a figure). CA with buyer_area=federal: the government's own kind of purchase ('translation services', 'management consulting', 'security services'), or all, goods, services, construction. Words are matched against the description of the spending; a kind with fewer than 5 contracts has no figure. CA: a common purchase in plain words ('translation services', 'legal services', 'catering', 'consultancy', 'IT services', 'laptops', 'security guards'). Recognised from the words in the notice title; other wording is not searched. Quebec: a common purchase in plain words, in French or English ('laptops', 'ordinateurs portables', 'catering', 'road resurfacing', 'building cleaning'). CO: a common purchase in plain words ('catering', 'security guard services', 'office cleaning', 'laptops', 'ambulances', 'printers', 'photocopiers'). Recognised from the Spanish words in the contract description; other wording is not searched. CZ: a common purchase in plain words ('laptops', 'waste collection', 'office cleaning', 'electricity', 'legal services', 'security guards'). Recognised from Czech words in the contract subject, so a match is approximate. DE: a common purchase in plain words, in German or English ('laptops', 'schulessen', 'road resurfacing', 'office cleaning', 'ambulances'). Recognised from the lot's CPV product code. ES: optional (left out or 'all' = every award in the window); a common purchase in plain words, in Spanish or English ('portatiles', 'laptops', 'road resurfacing', 'limpieza de oficinas', 'ambulances'). Recognised from the award's CPV product code. Only the newest one to two days of awards are summarised, so use a broad CPV division (45 = construction) for a figure. EU and EEA: common purchases are matched to CPV product codes (laptops, desktop computers, school meals, road resurfacing, office cleaning, electricity, natural gas, ambulances, waste collection and about 30 more, in English and the main EU languages); anything else is a free-text search of the award notices, best in the buyer country's language. FR: a common purchase in plain words, in French or English ('ordinateurs portables', 'laptops', 'restauration scolaire', 'road resurfacing', 'office cleaning', 'ambulances'). Recognised from the contract's CPV product code. GB: a common purchase in plain words ('software', 'IT services', 'consultancy', 'legal services', 'insurance'; very thin purchases such as laptops may have fewer than 5 awards in two weeks and return no figure). Recognised from the notice's main CPV product code. IE: optional (left out or 'all' = every award in the window); a common purchase in plain words ('catering', 'school meals', 'software', 'consultancy', 'legal services', 'cars'; a purchase with fewer than 5 Irish awards in the window has no figure). Recognised from the award's main CPV product code. NG: 'all' or a purchase theme matched from the contract title: vehicles, fuel, ict, medical, roads, buildings, rehabilitation, water, power, furniture, security, schools, agriculture, consultancy (common words such as 'vehicles', 'roads', 'laptops' or 'diesel' work). An unknown word lists the themes. NZ: optional (left out = all awards); a common purchase in plain words ('buses', 'laptops', 'cleaning', 'road resurfacing'; a purchase with fewer than 5 awards in 24 months gets no figure) or 'all'; read from the price library, not searched live. PL: a common purchase in plain words ('laptops', 'road resurfacing', 'office cleaning', 'school meals', 'ambulances'). Recognised from the notice's CPV product code. PT: a common purchase in plain words, in Portuguese or English ('computadores portateis', 'laptops', 'road resurfacing', 'office cleaning', 'ambulances'). Recognised from the contract's CPV product code. SG: a word or phrase searched in the tender description ('cleaning', 'laptops', 'security services'); common purchases use a tuned keyword. TH: a common purchase in plain words ('school meals', 'building cleaning', 'school cleaning', 'security guard services', 'laptops'). Recognised from Thai words in the contract title; other purchases are not searched. UA: a common purchase in plain words ('electricity', 'pharmaceuticals', 'legal services', 'IT services', 'insurance' (common purchases with too few contracts in the daily sample return no_matches)). Recognised from the contract's product code (DK 021, based on the CPV). Chicago: what=all for every city award, or a common purchase in plain words ('consultancy', 'legal services', 'IT services', 'software', 'office cleaning'). US hourly labour rates: say the job and 'hourly rate', e.g. 'software engineer hourly rate'. The figure is a federal contract CEILING rate per hour, not a price paid. US: a phrase searched in the federal award descriptions (common purchases such as 'laptops' use a tuned keyword; 'road resurfacing' uses the road-repair product code Z2LB). Several words must appear together, so shorter is better. ZA: a common purchase in plain words ('security guard services', 'building cleaning', 'catering', 'laptops', 'office furniture', 'photocopiers'). Recognised from the words in the contract description; other wording is not searched."New value: +"What was bought, in plain words: 'laptops', 'school meals', 'road resurfacing', 'office cleaning', 'electricity', 'ambulances', 'waste collection'. Common purchases are matched to official product codes; anything else is searched as free…"
changedOutput schema / description
Previous value: -"A price answer: a range or an official statistic with sample size, period, confidence, source and licence."New value: +"Price range from real records: price, sample_size, period, confidence, source and licence."
removedOutput schema / properties / answer_id
Removed value: -{
- "description": "Audit trail: a stable id (hash of source id, normalised query, data period and method_version). The same question on the same data gives the same id; keep it with the reasoning that used the figure.",
- "type": "string"
-}
removedOutput schema / properties / as_of
Removed value: -{
- "description": "When the answer was produced (ISO 8601); the snapshot date when the official source was down and the answer comes from our copy.",
- "type": "string"
-}
changedOutput schema / properties / confidence / description
Previous value: -"high = 50+ records, medium = 15–49, low = 5–14."New value: +"high, medium, low or insufficient."
removedOutput schema / properties / confidence / enum
Removed value: -[
- "high",
- "medium",
- "low",
- "insufficient"
-]
removedOutput schema / properties / data_age_days
Removed value: -{
- "description": "Whole days between data_as_of and retrieved_at; null when data_as_of is null.",
- "type": [
- "number",
- "null"
- ]
-}
removedOutput schema / properties / data_as_of
Removed value: -{
- "description": "ISO date (YYYY-MM-DD) of the newest data point behind the figure; null when unknown.",
- "type": [
- "string",
- "null"
- ]
-}
removedOutput schema / properties / evidence
Removed value: -{
- "additionalProperties": {},
- "description": "Audit trail: what kind of evidence the figure is.",
- "properties": {
- "label": {
- "description": "Short name of the kind of evidence, e.g. 'Recorded sale prices', 'Official published average', 'Official published index', 'Posted shelf or pump price', 'Posted or listed price', 'Contract award value', 'Regulated reimbursement price'.",
- "type": "string"
- },
- "meaning": {
- "description": "One sentence on what this kind of evidence does and does not establish.",
- "type": "string"
- },
- "type": {
- "description": "Same as price_type.",
- "type": "string"
- }
- },
- "required": [
- "type",
- "label",
- "meaning"
- ],
- "type": "object"
-}
removedOutput schema / properties / extra
Removed value: -{
- "additionalProperties": {},
- "description": "Source-specific details (for example cheapest stations). extra.stale is true when the answer comes from our copy of the source.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
-}
removedOutput schema / properties / method
Removed value: -{
- "type": "string"
-}
removedOutput schema / properties / method_url
Removed value: -{
- "type": "string"
-}
removedOutput schema / properties / method_version
Removed value: -{
- "description": "Audit trail: version of the way this source turns raw data into an answer (per source, default '1').",
- "type": "string"
-}
removedOutput schema / properties / notice
Removed value: -{
- "description": "Information, not a valuation or offer. Also says when the answer is our copy because the official source did not respond.",
- "type": "string"
-}
removedOutput schema / properties / period / description
Removed value: -"The period the records cover (ISO dates), or the date of the snapshot when the answer comes from our copy."
changedOutput schema / properties / price / anyOf
Previous value: -[
- {
- "additionalProperties": {},
- "description": "The price. Null when there is not enough data to publish a figure (fewer than 5 records) or nothing matched.",
- "properties": {
- "currency": {
- "description": "ISO 4217 currency code, e.g. EUR.",
- "type": "string"
- },
- "max": {
- "type": [
- "number",
- "null"
- ]
- },
- "measure": {
- "description": "What value is: median for ranges built from records; average or median for official statistics.",
- "enum": [
- "median",
- "average"
- ],
- "type": "string"
- },
- "median": {
- "type": [
- "number",
- "null"
- ]
- },
- "min": {
- "type": [
- "number",
- "null"
- ]
- },
- "typical_high": {
- "description": "90th percentile; null for official statistics that give no range.",
- "type": [
- "number",
- "null"
- ]
- },
- "typical_low": {
- "description": "10th percentile; null for official statistics that give no range.",
- "type": [
- "number",
- "null"
- ]
- },
- "unit": {
- "description": "What the price is per, e.g. 'per litre', 'per home', 'per kWh'.",
- "type": "string"
- },
- "value": {
- "description": "The headline figure. For ranges built from records it equals median.",
- "type": "number"
- }
- },
- "required": [
- "currency",
- "unit",
- "value"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "additionalProperties": {},
+ "properties": {
+ "currency": {
+ "type": "string"
+ },
+ "typical_high": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "typical_low": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "unit": {
+ "type": "string"
+ },
+ "value": {
+ "type": "number"
+ }
+ },
+ "required": [
+ "currency",
+ "unit",
+ "value"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+]
removedOutput schema / properties / price_type
Removed value: -{
- "description": "transaction, posted_pump_price, posted_price, contract_price, reimbursement_price or official_statistic.",
- "type": "string"
-}
removedOutput schema / properties / query
Removed value: -{
- "additionalProperties": {},
- "description": "The request as understood, echoed back.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
-}
removedOutput schema / properties / reliability
Removed value: -{
- "description": "How far to trust the figure as a distribution of real prices. official_with_count = a published official figure with a record count; official_median_no_count = a published average or median with no record count (confidence 'high' there means the publisher is official, not that a count was checked); record_level = 15+ records we hold; thin = 5–14 records; stale = our copy because the official source did not respond; insufficient_data = no figure published.",
- "enum": [
- "official_with_count",
- "official_median_no_count",
- "record_level",
- "thin",
- "stale",
- "insufficient_data"
- ],
- "type": "string"
-}
removedOutput schema / properties / retrieved_at
Removed value: -{
- "description": "Audit trail: when ProofPrice produced this answer (ISO 8601). For an answer from our own copy this is now, while as_of is the snapshot date.",
- "type": "string"
-}
removedOutput schema / properties / sample_size / description
Removed value: -"Number of records behind the figure; null when the publisher does not say."
removedOutput schema / properties / source / description
Removed value: -"Where the figure comes from, under which licence, and the attribution line to show."
removedOutput schema / properties / source / properties / attribution / description
Removed value: -"The attribution line to show with the figure."
removedOutput schema / properties / source / properties / id
Removed value: -{
- "description": "Source id, e.g. es-fuel.",
- "type": "string"
-}
removedOutput schema / properties / source / properties / licence_url
Removed value: -{
- "type": "string"
-}
removedOutput schema / properties / source / properties / publisher
Removed value: -{
- "description": "Who publishes the data.",
- "type": "string"
-}
removedOutput schema / properties / source / properties / url
Removed value: -{
- "description": "The publisher's page for this data.",
- "type": "string"
-}
changedOutput schema / properties / source / required
Previous value: -[
- "id",
- "name",
- "publisher",
- "licence",
- "licence_url",
- "attribution",
- "url"
-]New value: +[
+ "name",
+ "licence",
+ "attribution"
+]
removedOutput schema / properties / statistic
Removed value: -{
- "additionalProperties": {},
- "description": "Official statistics only: what kind of figure it is and the period the publisher states it for.",
- "properties": {
- "measure": {
- "enum": [
- "median",
- "average"
- ],
- "type": "string"
- },
- "note": {
- "type": "string"
- },
- "reference_period": {
- "type": "string"
- }
- },
- "required": [
- "measure",
- "reference_period"
- ],
- "type": "object"
-}
removedOutput schema / properties / status / description
Removed value: -"ok = a figure is returned; insufficient_data = fewer than 5 matching records; no_matches = nothing matched."
removedOutput schema / properties / suggestions
Removed value: -{
- "description": "Short plain things to try next: widen the period or area, ask for an itemised quote. May be empty.",
- "items": {
- "type": "string"
- },
- "type": "array"
-}
changedOutput schema / properties / summary / description
Previous value: -"One plain sentence an AI can quote."New value: +"One sentence an AI can quote."
changedOutput schema / required
Previous value: -[
- "query",
- "status",
- "source",
- "summary",
- "notice"
-]New value: +[
+ "status",
+ "summary"
+]