List receptionist tasks
curl --request GET \
--url https://api.healos.ai/ext-api/v1/receptionist/tasks \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.healos.ai/ext-api/v1/receptionist/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.healos.ai/ext-api/v1/receptionist/tasks"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "7a5c0000-0000-4000-8000-000000000001",
"title": "<string>",
"category": "<string>",
"status": "todo",
"source": "call",
"notes": "<string>",
"due_date": "2026-10-30",
"patient_id": "<string>",
"patient_label": "<string>",
"assigned_provider_calendar_id": "<string>",
"linked_call_id": "<string>",
"caller_phone": "+15555550100",
"ehr_source": "<string>",
"created_at": "2026-10-27T14:07:50.000Z",
"updated_at": "2026-10-27T14:08:02.000Z"
}
],
"meta": {
"page": 123,
"limit": 123,
"total_pages": 123,
"total": 12
}
}{
"error": "<string>",
"details": {}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "Rate limit exceeded. Please retry after the window resets.",
"code": "daily_cap_reached",
"reset_at": "2026-10-28T00:00:00.000Z"
}Receptionist
List receptionist tasks
Paginated AI Receptionist inbox tasks for your organization, newest first: the call backs, refills and messages the receptionist (or staff) created for the front desk. Filter by status, category, title text or creation date. Requires the receptionist:read scope.
GET
/
receptionist
/
tasks
List receptionist tasks
curl --request GET \
--url https://api.healos.ai/ext-api/v1/receptionist/tasks \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.healos.ai/ext-api/v1/receptionist/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.healos.ai/ext-api/v1/receptionist/tasks"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "7a5c0000-0000-4000-8000-000000000001",
"title": "<string>",
"category": "<string>",
"status": "todo",
"source": "call",
"notes": "<string>",
"due_date": "2026-10-30",
"patient_id": "<string>",
"patient_label": "<string>",
"assigned_provider_calendar_id": "<string>",
"linked_call_id": "<string>",
"caller_phone": "+15555550100",
"ehr_source": "<string>",
"created_at": "2026-10-27T14:07:50.000Z",
"updated_at": "2026-10-27T14:08:02.000Z"
}
],
"meta": {
"page": 123,
"limit": 123,
"total_pages": 123,
"total": 12
}
}{
"error": "<string>",
"details": {}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "Rate limit exceeded. Please retry after the window resets.",
"code": "daily_cap_reached",
"reset_at": "2026-10-28T00:00:00.000Z"
}| Requirement | Detail |
|---|---|
| Scope | receptionist:read |
| Rate limit | About 60 requests per minute per API key (shared by all endpoints; approximate) |
| Cost | Free |
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.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
API key obtained from /api/v1/ext-api-keys
Query Parameters
Page number, from 1.
Pattern:
^\d+$Example:
"1"
Results per page, 1-100 (default 20). Larger values are treated as 100.
Pattern:
^\d+$Example:
"20"
Only tasks with this status. all (the default) includes archived tasks.
Available options:
todo, done, archived, all Example:
"todo"
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:
100Example:
"refill"
Only tasks created at or after this instant (ISO 8601).
Example:
"2026-10-27"
Only tasks created at or before this instant (ISO 8601).
Example:
"2026-10-28T23:59:59Z"
Was this page helpful?

