primecarers.co.uk

{
  "type": "object",
  "properties": {
    "postcode": {
      "type": "string",
      "minLength": 5,
      "maxLength": 9,
      "description": "Full UK postcode, e.g. SW1A 1AA. Spaces and lowercase are accepted."
    },
    "care_type": {
      "type": "string",
      "enum": [
        "hourly",
        "live_in",
        "nightly"
      ]
    },
    "visit_length_minutes": {
      "type": "integer",
      "enum": [
        30,
        60,
        120,
        240,
        480
      ],
      "description": "Minimum visit duration. Default 120; determines travel radius for hourly care."
    },
    "filters": {
      "type": "object",
      "properties": {
        "gender": {
          "type": "string",
          "enum": [
            "male",
            "female"
          ]
        },
        "language_ids": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2147483647
          },
          "uniqueItems": true,
          "maxItems": 1,
          "description": "Language from primecarers_get_search_filters. The public UI selects one language."
        },
        "condition_ids": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2147483647
          },
          "uniqueItems": true,
          "maxItems": 20,
          "description": "Experience supporting these conditions; use IDs from primecarers_get_search_filters."
        },
        "skill_ids": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2147483647
          },
          "uniqueItems": true,
          "maxItems": 20,
          "description": "Care skills; use IDs from primecarers_get_search_filters."
        },
        "pet_ids": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2147483647
          },
          "uniqueItems": true,
          "maxItems": 20,
          "description": "Pets at the care location; use IDs from primecarers_get_search_filters."
        },
        "has_driving_license": {
          "type": "boolean",
          "enum": [
            true
          ],
          "description": "Require a driving licence; omit for no preference."
        },
        "has_car": {
          "type": "boolean",
          "enum": [
            true
          ],
          "description": "Require own car; omit for no preference."
        },
        "accepts_pets": {
          "type": "boolean",
          "enum": [
            true
          ],
          "description": "Comfortable with pets; omit for no preference."
        },
        "couple_care": {
          "type": "boolean",
          "enum": [
            true
          ],
          "description": "Care for two people; omit for no preference."
        },
        "min_rate_gbp": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "description": "Pounds per hour, or per day for live_in. Nightly search uses the public hourly budget filter."
        },
        "max_rate_gbp": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "description": "Pounds per hour, or per day for live_in. Preferences rank results; inspect mismatches."
        }
      },
      "required": [],
      "additionalProperties": false
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "relevance",
        "distance",
        "rating",
        "price"
      ]
    },
    "sort_dir": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Page size; default 20."
    },
    "cursor": {
      "type": "string",
      "maxLength": 2048,
      "description": "Opaque next_cursor from the same search; keep all other inputs unchanged."
    }
  },
  "required": [
    "postcode"
  ],
  "additionalProperties": false
}