changedInput schema / properties / country / description
Previous value: -"AU = Australia (Department of Education: maximum student contribution for Commonwealth supported university places, per full-time year, by field of education); CA = Canada (Statistics Canada: average posted tuition fees of publicly funded universities, by province, Canadian or international students, undergraduate or graduate); European countries as ISO codes (GR for Greece): BE = Belgium, BG = Bulgaria, CZ = Czechia, DK = Denmark, DE = Germany, EE = Estonia, IE = Ireland, GR = Greece, ES = Spain, FR = France, HR = Croatia, IT = Italy, CY = Cyprus, LV = Latvia, LT = Lithuania, LU = Luxembourg, HU = Hungary, MT = Malta, NL = Netherlands, AT = Austria, PL = Poland, PT = Portugal, RO = Romania, SI = Slovenia, SK = Slovakia, FI = Finland, SE = Sweden, AL = Albania, BA = Bosnia and Herzegovina, CH = Switzerland, IS = Iceland, LI = Liechtenstein, ME = Montenegro, MK = North Macedonia, NO = Norway, RS = Serbia, TR = Turkey; TW = Taiwan (Ministry of Education: posted tuition and miscellaneous fee standards per semester, bachelor's day programmes, by faculty group)"New value: +"AU = Australia (Department of Education: maximum student contribution for Commonwealth supported university places, per full-time year, by field of education); CA = Canada (Statistics Canada: average posted tuition fees of publicly funded universities, by…"
changedInput schema / properties / cycle / description
Previous value: -"Degree level: first = bachelor's (first cycle, the default), second = master's (second cycle). Also accepts bachelor, master, undergraduate, postgraduate. Australia: the Commonwealth supported amounts apply to bachelor's and postgraduate places alike; the answer is the same for first and second. Canada, Statistics Canada: first = undergraduate (default), second = graduate (master's and doctorate). Europe, Eurydice: first = bachelor's (default), second = master's. Taiwan: first = bachelor's (the only level in the file)."New value: +"Degree level: first = bachelor's (first cycle, the default), second = master's (second cycle). Also accepts bachelor, master, undergraduate, postgraduate. Australia: the Commonwealth supported amounts apply to bachelor's and postgraduate…"
changedInput schema / properties / student_group / description
Previous value: -"Who pays: home (nationals and EU students who pay home fees, the default), international (students from outside the EU/EEA), non-state-subsidised (self-financed places), specific-discipline (for example medicine), foreign-language (courses taught in another language). Australia: home = domestic Commonwealth supported students (the only group published here; leave out). Canada, Statistics Canada: home = Canadian citizens and permanent residents (default) or international. Other groups are not published. Europe, Eurydice: home (default), international (non-EU/EEA), non-state-subsidised, specific-discipline, foreign-language. Not every group exists in every country: the answer says when a fee is not available. Taiwan: one fee standard per institution; home is the only group."New value: +"Who pays: home (nationals and EU students who pay home fees, the default), international (students from outside the EU/EEA), non-state-subsidised (self-financed places), specific-discipline (for example medicine), foreign-language…"
changedInput schema / properties / study_mode / description
Previous value: -"full-time (the default) or part-time. Australia: amounts are per full-time year (EFTSL); full-time only. Canada: full-time only (the default). Europe, Eurydice: full-time (default) or part-time. Taiwan: full-time day programmes only (the default)."New value: +"full-time (the default) or part-time. Australia: amounts are per full-time year (EFTSL); full-time only. Canada: full-time only (the default). Europe, Eurydice: full-time (default) or part-time. Taiwan: full-time day programmes only (the…"
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"
+]