Skip to main content

Home Health Care

Schedule therapists for patient visits with skill matching and continuity of care.

Request

{
  "resources": [
    {
      "name": "PT-Sarah",
      "shifts": [
        {"from": "2024-03-18T08:00:00", "to": "2024-03-18T17:00:00"},
        {"from": "2024-03-19T08:00:00", "to": "2024-03-19T17:00:00"},
        {"from": "2024-03-20T08:00:00", "to": "2024-03-20T17:00:00"}
      ],
      "start": {"latitude": 40.7614, "longitude": -73.9776},
      "tags": ["physical-therapy", "geriatric"]
    },
    {
      "name": "OT-Michael",
      "shifts": [
        {"from": "2024-03-18T09:00:00", "to": "2024-03-18T18:00:00"},
        {"from": "2024-03-19T09:00:00", "to": "2024-03-19T18:00:00"}
      ],
      "start": {"latitude": 40.7614, "longitude": -73.9776},
      "tags": ["occupational-therapy", "geriatric"]
    }
  ],
  "jobs": [
    {
      "name": "patient-001-PT-visit1",
      "location": {"latitude": 40.7580, "longitude": -73.9855},
      "duration": 3600,
      "windows": [{"from": "2024-03-18T09:00:00", "to": "2024-03-18T11:00:00", "hard": true}],
      "tags": [{"name": "physical-therapy", "hard": true}]
    },
    {
      "name": "patient-001-PT-visit2",
      "location": {"latitude": 40.7580, "longitude": -73.9855},
      "duration": 3600,
      "windows": [{"from": "2024-03-20T09:00:00", "to": "2024-03-20T11:00:00", "hard": true}],
      "tags": [{"name": "physical-therapy", "hard": true}]
    },
    {
      "name": "patient-001-OT-visit1",
      "location": {"latitude": 40.7580, "longitude": -73.9855},
      "duration": 2700,
      "windows": [{"from": "2024-03-19T14:00:00", "to": "2024-03-19T16:00:00", "hard": true}],
      "tags": [{"name": "occupational-therapy", "hard": true}]
    }
  ],
  "relations": [
    {
      "type": "SAME_RESOURCE",
      "jobs": ["patient-001-PT-visit1", "patient-001-PT-visit2"]
    }
  ]
}

Response

{
  "trips": [
    {
      "resource": "PT-Sarah",
      "date": "2024-03-18",
      "visits": [{"arrival": "2024-03-18T09:00:00", "job": "patient-001-PT-visit1"}]
    },
    {
      "resource": "PT-Sarah",
      "date": "2024-03-20",
      "visits": [{"arrival": "2024-03-20T09:00:00", "job": "patient-001-PT-visit2"}]
    },
    {
      "resource": "OT-Michael",
      "date": "2024-03-19",
      "visits": [{"arrival": "2024-03-19T14:00:00", "job": "patient-001-OT-visit1"}]
    }
  ]
}

Key Features

FeatureUsage
Multiple shiftsMulti-day scheduling per resource
SAME_RESOURCE relationSame therapist for all visits
tags.hard: trueRequired certification
paddingAdd documentation time after visits