HealthTasks Institution API
Read-only REST API for institution-scoped HealthTasks data.
Documentation: https://healthtasks.apidocumentation.com
Authenticate with Authorization: Bearer <api_key> or x-healthtasks-api-key. Generate keys in HealthTasks under Settings → API.
Production key safety
Do not paste production institution API keys into hosted documentation pages or other third-party browser tools. Browser Try-it calls are intentionally not CORS-enabled for the production API. Use server-side integrations, secure API clients, or local curl commands where the key stays under your control.
Rate limits
Requests are limited to 300 per 60 seconds per client IP and API key. Exceeding the limit returns HTTP 429 with a Retry-After header. Design integrations to back off and retry; keep concurrent polling modest.
List and get responses for activity resources include nested related objects
(e.g. template, target, student, classroom) so foreign-key UUIDs are
human-resolvable without extra round-trips. Reference resources
(evaluation_templates, evaluation_assignments, skills_checkoff_templates,
skills_checkoff_assignments) are also available for full catalog sync.
Clinical schedules
Use schedule_assignments (classroom membership + optional schedule_track_id),
schedule_tracks, and schedule_segments — the same model as classroom roster reports.
Students inherit segment dates/sites/hours from their assigned track.
Item-level assessment data
evaluation_responses + evaluation_questions expose per-question answers.
skills_checkoff_grades + skills_checkoff_steps expose per-step AI/educator scores.
Skills assignments and submissions include is_practice and derived mode
(practice | graded).
Polymorphic targets
evaluations.target_id and evaluation_assignments.target_id refer to a student, preceptor, or location depending on evaluation_templates.target_type. Prefer the embedded target object (includes type + display_name).