fysio.care clinic discovery

Search the public directory of Swedish MSK clinics (fysioterapi, naprapati, kiropraktik m.fl.) on fysio.care. Returns published clinics with FHIR Organization resources. Use list_clinic_services next to see what a clinic offers.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Case-insensitive clinic-name substring.",
      "type": "string",
      "minLength": 2,
      "maxLength": 50
    },
    "city": {
      "description": "Exact city name, e.g. \"Lund\".",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "modality": {
      "description": "Only clinics offering this treatment modality.",
      "type": "string",
      "enum": [
        "fysioterapeut",
        "naprapat",
        "kiropraktor",
        "osteopat",
        "manuell_terapeut",
        "idrottsterapeut"
      ]
    },
    "friskvard": {
      "description": "Only clinics where friskvårdsbidrag can actually be spent.",
      "type": "boolean"
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the bookable services of one clinic, with duration, price (SEK) and a FHIR HealthcareService per bookable variant. The variant id is what get_available_slots takes.

{
  "type": "object",
  "properties": {
    "clinic_slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "The clinic slug from search_clinics (the URL segment, e.g. \"mickes-klinik-lund\")."
    }
  },
  "required": [
    "clinic_slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free appointment slots for one bookable service variant at one clinic, up to 14 days ahead. Each slot carries a FHIR Slot resource and a bookingUrl where the PATIENT completes the booking themselves on the web (this server never books).

{
  "type": "object",
  "properties": {
    "clinic_slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "The clinic slug from search_clinics (the URL segment, e.g. \"mickes-klinik-lund\")."
    },
    "service_variant_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "A bookable service variant id from list_clinic_services."
    },
    "from_date": {
      "description": "Window start (YYYY-MM-DD, clinic runs Europe/Stockholm). Defaults to today.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "days": {
      "default": 14,
      "description": "Window length in days.",
      "type": "integer",
      "minimum": 1,
      "maximum": 14
    }
  },
  "required": [
    "clinic_slug",
    "service_variant_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Earliest free slot for a service variant, scanning up to 90 days ahead. Use when get_available_slots comes back empty.

{
  "type": "object",
  "properties": {
    "clinic_slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "The clinic slug from search_clinics (the URL segment, e.g. \"mickes-klinik-lund\")."
    },
    "service_variant_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "A bookable service variant id from list_clinic_services."
    }
  },
  "required": [
    "clinic_slug",
    "service_variant_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}