Skip to main content
GET
List receptionist tasks
Safety
  • Writes data: No
  • Safe to retry: Yes
  • Contacts an outside system: None
  • Dry run: Not needed (read-only).
Rolling out: this endpoint is on staging first and not yet on api.healos.ai.
Inbox tasks are the call backs, refills and messages the AI Receptionist (or staff) leave for the front desk. They are returned newest first by created_at. Without status, every status is listed, archived tasks included; pass status=todo for the open ones. caller_phone is the number of the call the task came from, so you can call back. It is null for a task with no linked phone call. Task notes can contain protected health information. Store them as you would any patient record. Guide: Calls and inbox. Errors: Error catalog.

Authorizations

X-API-Key
string
header
required

API key obtained from /api/v1/ext-api-keys

Query Parameters

page
string
default:1

Page number, from 1.

Pattern: ^\d+$
Example:

"1"

limit
string
default:20

Results per page, 1-100 (default 20). Larger values are treated as 100.

Pattern: ^\d+$
Example:

"20"

status
enum<string>

Only tasks with this status. all (the default) includes archived tasks.

Available options:
todo,
done,
archived,
all
Example:

"todo"

category
enum<string>
Available options:
action,
communicate,
coordinate,
document,
order,
call_followup,
billing,
insurance,
refill,
records,
referral,
appointment
Example:

"call_followup"

Text to look for in the task title.

Maximum string length: 100
Example:

"refill"

from_date
string

Only tasks created at or after this instant (ISO 8601).

Example:

"2026-10-27"

to_date
string

Only tasks created at or before this instant (ISO 8601).

Example:

"2026-10-28T23:59:59Z"

Response

List of tasks

data
object[]
required
meta
object
required