Previous value: -"Only clinics showing 'Accepting patients' (an active published eligibility policy)."New value: +"Only clinics showing 'Accepting patients' (an active published policy)."

Added value: +{
+  "description": "Only clinics whose published policy lists this condition. One of: Anxiety / Depression; PTSD; Insomnia / Sleep disorders; Chronic pain; Neuropathic pain; Multiple Sclerosis / Spasticity; Cancer symptoms; IBD (Crohn's / Ulcerative Colitis); Migraine; Arthritis / inflammatory pain; ADHD / Autism spectrum symptoms; Endometriosis / women's health symptoms. A listed condition is the clinic's referral scope, never a statement that anyone qualifies.",
+  "maxLength": 120,
+  "type": "string"
+}

Added value: +{
+  "description": "Only clinics offering ONLINE (video), IN_PERSON or PHONE.",
+  "enum": [
+    "ONLINE",
+    "IN_PERSON",
+    "PHONE"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "CQC rating filter; GOOD_OR_BETTER keeps Good and Outstanding.",
+  "enum": [
+    "GOOD_OR_BETTER",
+    "OUTSTANDING",
+    "GOOD",
+    "REQUIRES_IMPROVEMENT",
+    "NOT_RATED"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Only clinics whose first consultation costs at most this, in GBP.",
+  "exclusiveMinimum": 0,
+  "type": "number"
+}

Added value: +{
+  "description": "A UK postcode, outcode or town, e.g. \"M1 1AE\", \"LS6\" or \"Bristol\". Sorts nearest first and adds miles.",
+  "maxLength": 64,
+  "minLength": 2,
+  "type": "string"
+}

Previous value: -"NEW_PATIENT (never prescribed), TRANSFER (moving from another clinic) or ACTIVE_PATIENT (already under treatment). Leaves out clinics whose published policy does not take that type, and price sorts cost that route."New value: +"NEW_PATIENT, TRANSFER or ACTIVE_PATIENT. Drops clinics whose policy does not take it, and prices year one for that route."

Previous value: -"Clinic name, town or postcode, matched as text (not by distance). Omit to list all."New value: +"Clinic name, matched as text. For a place use `near`."

Added value: +{
+  "description": "Only within this many miles of `near`. Ignored without `near`.",
+  "exclusiveMinimum": 0,
+  "maximum": 500,
+  "type": "number"
+}

Previous value: -"az (default), za, or by published first-year cost: priceLowHigh / priceHighLow."New value: +"distance (default with `near`), az (default otherwise), za, cheapest / dearest by year-one clinic fees, rating."

Previous value: -[
-  "az",
-  "za",
-  "priceLowHigh",
-  "priceHighLow"
-]New value: +[
+  "distance",
+  "az",
+  "za",
+  "cheapest",
+  "dearest",
+  "rating"
+]

Added value: +{
+  "description": "Miles from `near`; null when no place was given",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Estimated year-one clinic fees (consultations, membership, the clinic's prescription fee) for the asked patient type with 4 follow-ups and 12 prescriptions; never includes medicine; null when no price list is published",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Previous value: -[
-  "name",
-  "slug",
-  "url",
-  "city",
-  "postcode",
-  "currency",
-  "initialConsultationFee",
-  "followUpConsultationFee",
-  "consultationTypes",
-  "cqcRating",
-  "rating",
-  "acceptingPatients",
-  "patientTypes"
-]New value: +[
+  "name",
+  "slug",
+  "url",
+  "city",
+  "postcode",
+  "distanceMiles",
+  "currency",
+  "initialConsultationFee",
+  "followUpConsultationFee",
+  "firstYearClinicFees",
+  "consultationTypes",
+  "cqcRating",
+  "rating",
+  "acceptingPatients",
+  "patientTypes"
+]

Removed value: -{
-  "description": "Only clinics currently taking new patients.",
-  "type": "boolean"
-}

Added value: +{
+  "description": "Only clinics showing 'Accepting patients' (an active published eligibility policy).",
+  "type": "boolean"
+}

Previous value: -"Default 10."New value: +"How many to return, 1-25. Default 10."

Added value: +{
+  "description": "NEW_PATIENT (never prescribed), TRANSFER (moving from another clinic) or ACTIVE_PATIENT (already under treatment). Leaves out clinics whose published policy does not take that type, and price sorts cost that route.",
+  "enum": [
+    "NEW_PATIENT",
+    "TRANSFER",
+    "ACTIVE_PATIENT"
+  ],
+  "type": "string"
+}

Previous value: -"Name, city or postcode. Postcode is matched as text, not by distance."New value: +"Clinic name, town or postcode, matched as text (not by distance). Omit to list all."

Added value: +120

Previous value: -"Default az."New value: +"az (default), za, or by published first-year cost: priceLowHigh / priceHighLow."

Previous value: -[
-  "az",
-  "priceLowHigh",
-  "priceHighLow"
-]New value: +[
+  "az",
+  "za",
+  "priceLowHigh",
+  "priceHighLow"
+]

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "note": {
+      "type": "string"
+    },
+    "results": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "acceptingPatients": {
+            "description": "Shows 'Accepting patients' (an active published eligibility policy)",
+            "type": "boolean"
+          },
+          "city": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "consultationTypes": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "cqcRating": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "currency": {
+            "type": "string"
+          },
+          "followUpConsultationFee": {
+            "$ref": "#/properties/results/items/properties/initialConsultationFee"
+          },
+          "initialConsultationFee": {
+            "description": "In `currency`; null when not published",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "name": {
+            "type": "string"
+          },
+          "patientTypes": {
+            "anyOf": [
+              {
+                "items": {
+                  "enum": [
+                    "NEW_PATIENT",
+                    "TRANSFER",
+                    "ACTIVE_PATIENT"
+                  ],
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Patient types the published policy takes; null when the clinic publishes no policy"
+          },
+          "postcode": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "rating": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "average": {
+                    "type": "number"
+                  },
+                  "count": {
+                    "type": "integer"
+                  }
+                },
+                "required": [
+                  "average",
+                  "count"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Published patient reviews; null when there are none"
+          },
+          "slug": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "url": {
+            "anyOf": [
+              {
+                "format": "uri",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Canonical Findabis page, absolute; null when the listing has no page"
+          }
+        },
+        "required": [
+          "name",
+          "slug",
+          "url",
+          "city",
+          "postcode",
+          "currency",
+          "initialConsultationFee",
+          "followUpConsultationFee",
+          "consultationTypes",
+          "cqcRating",
+          "rating",
+          "acceptingPatients",
+          "patientTypes"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "total": {
+      "description": "How many matched in all; narrow the query when this exceeds the results",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "results",
+    "total"
+  ],
+  "type": "object"
+}