Skip to main content
GET
/
tasks
List tasks
curl --request GET \
  --url https://api.maxcare.ai/v4/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "code": "success",
  "data": {
    "tasks": [
      {
        "id": "tsk_a1b2c3d456784abc9def0123456789ab",
        "status": "not_started",
        "syncStatus": "synced",
        "notes": "Review missing plan for Impression #3",
        "noteId": "nte_3cc73cb69c59403ca9108af6c5693b25",
        "ehrType": "modmed",
        "assignedProviders": [
          {
            "id": "prv_d4e5f6a7b8c94d0e1f2a3b4c5d6e7f8a",
            "firstName": "James",
            "lastName": "Wilson",
            "displayFirstName": "Dr. James",
            "displayLastName": "Wilson, MD",
            "username": "jwilson",
            "roles": [
              "Physician"
            ],
            "individualNpi": "1234567890",
            "canFinalize": true,
            "canCosign": false
          }
        ],
        "createdAt": "2026-03-20 18:35:10.209452+00",
        "updatedAt": "2026-03-23 03:15:47.285+00"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 100,
      "totalCount": 250,
      "totalPages": 3
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.maxcare.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Marketplace API key

Headers

X-Organization-Id
string
required

Target clinic organization ID

Query Parameters

status
string

Filter by task status (comma-separated)

Example:

"not_started,in_progress"

noteId
string

Filter by note ID (UUID)

Example:

"nte_3cc73cb69c59403ca9108af6c5693b25"

providerId
string

Filter by assigned provider ID (UUID)

Example:

"prv_d4e5f6a7b8c94d0e1f2a3b4c5d6e7f8a"

patientId
string

Filter by patient ID (UUID)

Example:

"pat_8de030393a9e417ab2b3a8b8df183631"

dateFrom
string

Filter tasks created on or after this date (ISO 8601)

Example:

"2025-01-01"

dateTo
string

Filter tasks created on or before this date (ISO 8601)

Example:

"2025-12-31"

sortBy
enum<string>

Sort field

Available options:
createdAt,
updatedAt,
status
Example:

"createdAt"

sortOrder
enum<string>

Sort direction

Available options:
asc,
desc
Example:

"desc"

Response

Success

code
string
required

Response code

Example:

"success"

data
object
required