> ## 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. # List tasks > Returns a paginated list of tasks. Filter by status, note, or date range. ## OpenAPI ````yaml /openapi-v2.json get /tasks openapi: 3.0.0 info: title: Max AI Public API description: API for third-party marketplace apps version: '2.0' contact: {} servers: - url: https://api.maxcare.ai/v2 security: [] tags: [] paths: /tasks: get: tags: - Tasks summary: List tasks description: >- Returns a paginated list of tasks. Filter by status, note, or date range. operationId: TasksPublicController_listTasks parameters: - name: page required: false in: query description: Page number (1-indexed) schema: default: 1 example: 1 - name: pageSize required: false in: query description: Number of items per page (max 100) schema: default: 100 example: 100 - name: status required: false in: query description: Filter by task status (comma-separated) schema: example: not_started,in_progress type: string - name: noteId required: false in: query description: Filter by note ID (UUID) schema: example: 3cc73cb6-9c59-403c-a910-8af6c5693b25 type: string - name: providerId required: false in: query description: Filter by assigned provider ID (UUID) schema: example: d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a type: string - name: patientId required: false in: query description: Filter by patient ID (UUID) schema: example: 8de03039-3a9e-417a-b2b3-a8b8df183631 type: string - name: dateFrom required: false in: query description: Filter tasks created on or after this date (ISO 8601) schema: example: '2025-01-01' type: string - name: dateTo required: false in: query description: Filter tasks created on or before this date (ISO 8601) schema: example: '2025-12-31' type: string - name: sortBy required: false in: query description: Sort field schema: example: createdAt enum: - createdAt - updatedAt - status type: string - name: sortOrder required: false in: query description: Sort direction schema: example: desc enum: - asc - desc type: string - name: X-Organization-Id in: header required: true schema: type: string description: Target clinic organization ID responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ListTasksSuccessResponse' '401': description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/PublicApiUnauthorizedResponse' '403': description: Insufficient scope content: application/json: schema: $ref: '#/components/schemas/PublicApiForbiddenResponse' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/PublicApiRateLimitResponse' security: - api-key: [] components: schemas: ListTasksSuccessResponse: type: object properties: code: type: string description: Response code example: success data: $ref: '#/components/schemas/ListTasksResponseData' required: - code - data PublicApiUnauthorizedResponse: type: object properties: code: type: string description: Error code example: unauthorized message: type: string description: Human-readable error message example: Invalid or missing API key trace_id: type: string description: Trace ID for debugging example: 550e8400-e29b-41d4-a716-446655440000 required: - code - message - trace_id PublicApiForbiddenResponse: type: object properties: code: type: string description: Error code example: forbidden message: type: string description: Human-readable error message example: Insufficient scope trace_id: type: string description: Trace ID for debugging example: 550e8400-e29b-41d4-a716-446655440000 required: - code - message - trace_id PublicApiRateLimitResponse: type: object properties: code: type: string description: Error code example: rate_limit_exceeded message: type: string description: Human-readable error message example: Rate limit exceeded. Maximum 1000 requests per 60 seconds. trace_id: type: string description: Trace ID for debugging example: 550e8400-e29b-41d4-a716-446655440000 required: - code - message - trace_id ListTasksResponseData: type: object properties: tasks: type: array items: $ref: '#/components/schemas/ExternalTaskResponse' pagination: $ref: '#/components/schemas/PaginationInfoResponse' required: - tasks - pagination ExternalTaskResponse: type: object properties: id: type: string description: Task unique identifier example: a1b2c3d4-5678-4abc-9def-0123456789ab status: type: string description: Task status example: not_started enum: - new - not_started - in_progress - completed - cancelled - deleted syncStatus: type: string description: EHR sync status example: synced enum: - pending - syncing - synced - failed notes: type: string description: Task description / notes example: 'Review missing plan for Impression #3' noteId: type: string description: >- Note (visit) ID the task is anchored to. Absent for tasks anchored to a non-visit entity. example: 3cc73cb6-9c59-403c-a910-8af6c5693b25 ehrType: type: string description: EHR type example: modmed enum: - modmed - ezderm assignedProviders: description: Assigned providers type: array items: $ref: '#/components/schemas/ExternalTaskAssignedProvider' createdAt: type: string description: Created timestamp example: '2026-03-20 18:35:10.209452+00' updatedAt: type: string description: Last updated timestamp example: '2026-03-23 03:15:47.285+00' required: - id - status - syncStatus - notes - ehrType - assignedProviders - createdAt - updatedAt PaginationInfoResponse: type: object properties: page: type: number description: Current page number example: 1 pageSize: type: number description: Items per page example: 100 totalCount: type: number description: Total number of items example: 250 totalPages: type: number description: Total number of pages example: 3 required: - page - pageSize - totalCount - totalPages ExternalTaskAssignedProvider: type: object properties: id: type: string description: Provider unique identifier example: d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a firstName: type: string description: First name nullable: true example: James lastName: type: string description: Last name nullable: true example: Wilson displayFirstName: type: string description: Display first name nullable: true example: Dr. James displayLastName: type: string description: Display last name nullable: true example: Wilson, MD username: type: string description: EHR username nullable: true example: jwilson roles: description: Provider roles example: - Physician type: array items: type: string individualNpi: type: string description: Individual NPI number nullable: true example: '1234567890' canFinalize: type: boolean description: Whether the provider can finalize (bill-under) notes example: true canCosign: type: boolean description: Whether the provider can cosign other providers' notes example: false required: - id - firstName - lastName - displayFirstName - displayLastName - username - roles - individualNpi - canFinalize - canCosign securitySchemes: api-key: scheme: bearer bearerFormat: JWT type: http description: Marketplace API key ````