> ## Documentation Index > Fetch the complete documentation index at: https://docs.mobilerun.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Tasks > List tasks with optional filtering, sorting, and pagination. ## OpenAPI ````yaml /api-reference/tasks.yaml get /tasks openapi: 3.1.0 info: title: Tasks version: v1 servers: - url: https://api.mobilerun.ai description: Droidrun Cloud API security: - bearerAuth: [] paths: /tasks: get: tags: - Tasks summary: List Tasks description: List tasks with optional filtering, sorting, and pagination. operationId: list_tasks_tasks_get parameters: - name: status in: query required: false schema: anyOf: - $ref: '#/components/schemas/TaskStatus' - type: 'null' title: Status - name: query in: query required: false schema: anyOf: - type: string maxLength: 128 - type: 'null' description: Search in task description. title: Query description: Search in task description. - name: orderBy in: query required: false schema: anyOf: - enum: - id - createdAt - finishedAt - status type: string - type: 'null' default: createdAt title: Orderby - name: orderByDirection in: query required: false schema: enum: - asc - desc type: string default: desc title: Orderbydirection - name: page in: query required: false schema: type: integer minimum: 1 default: 1 title: Page - name: pageSize in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 20 title: Pagesize responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResult_TaskListItem_' '401': content: application/json: schema: $ref: '#/components/schemas/UnauthorizedResponse' description: Unauthorized '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Content '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error x-codeSamples: - lang: JavaScript source: |- import Mobilerun from '@mobilerun/sdk'; const client = new Mobilerun({ apiKey: process.env['MOBILERUN_CLOUD_API_KEY'], // This is the default and can be omitted }); const tasks = await client.tasks.list(); console.log(tasks.items); - lang: Python source: |- import os from mobilerun_sdk import Mobilerun client = Mobilerun( api_key=os.environ.get("MOBILERUN_CLOUD_API_KEY"), # This is the default and can be omitted ) tasks = client.tasks.list() print(tasks.items) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/stainless-sdks/droidrun-cloud-go\"\n\t\"github.com/stainless-sdks/droidrun-cloud-go/option\"\n)\n\nfunc main() {\n\tclient := mobileruncloud.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\ttasks, err := client.Tasks.List(context.TODO(), mobileruncloud.TaskListParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", tasks.Items)\n}\n" - lang: CLI source: |- mobilerun-cloud tasks list \ --api-key 'My API Key' components: schemas: TaskStatus: type: string enum: - queued - created - running - cancelling - paused - completed - failed - cancelled title: TaskStatus PaginatedResult_TaskListItem_: properties: items: items: $ref: '#/components/schemas/TaskListItem' type: array title: Items description: The paginated items pagination: $ref: '#/components/schemas/PaginationMeta' description: Pagination metadata type: object required: - items - pagination title: PaginatedResult[TaskListItem] UnauthorizedResponse: properties: title: type: string title: Title description: The title of the error default: Unauthorized status: type: integer title: Status description: The status code of the error default: 401 detail: type: string title: Detail description: The detail of the error default: You are not authorized to access this resource errors: items: {} type: array title: Errors description: The errors default: [] type: object title: UnauthorizedResponse ErrorResponse: properties: title: type: string title: Title description: The title of the error status: type: integer title: Status description: The status code of the error detail: type: string title: Detail description: The detail of the error errors: items: {} type: array title: Errors description: The errors type: object required: - title - status - detail - errors title: ErrorResponse TaskListItem: properties: createdAt: type: string format: date-time title: Createdat updatedAt: type: string format: date-time title: Updatedat agentId: type: integer title: Agentid default: 0 llmModel: type: string title: Llmmodel description: >- The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash') task: type: string minLength: 1 title: Task maxSteps: type: integer title: Maxsteps default: 100 temperature: type: number title: Temperature default: 0.5 reasoning: type: boolean title: Reasoning default: true accessibility: type: boolean title: Accessibility default: true vision: type: boolean title: Vision default: false executionTimeout: type: integer title: Executiontimeout default: 1000 credentials: items: $ref: '#/components/schemas/PackageCredentials' type: array title: Credentials apps: items: type: string type: array title: Apps files: items: type: string type: array title: Files outputSchema: anyOf: - additionalProperties: true type: object - type: 'null' title: Outputschema vpnCountry: anyOf: - $ref: '#/components/schemas/VPNCountry' - type: 'null' subagentModel: type: string title: Subagentmodel description: >- LLM model used by sub-agent roles: executor, app_opener, structured_output default: google/gemini-3.1-flash-lite stealth: type: boolean title: Stealth default: false continueOnFailure: type: boolean title: Continueonfailure default: false memoryNamespace: type: string title: Memorynamespace description: Memory namespace for cross-task personalization default: default id: type: string format: uuid title: Id status: $ref: '#/components/schemas/TaskStatus' deviceId: type: string format: uuid title: Deviceid displayId: type: integer title: Displayid tmpDevice: type: boolean title: Tmpdevice dispatchedAt: anyOf: - type: string format: date-time - type: 'null' title: Dispatchedat claimedAt: anyOf: - type: string format: date-time - type: 'null' title: Claimedat cancelRequestedAt: anyOf: - type: string format: date-time - type: 'null' title: Cancelrequestedat streamUrl: anyOf: - type: string - type: 'null' title: Streamurl succeeded: anyOf: - type: boolean - type: 'null' title: Succeeded message: anyOf: - type: string - type: 'null' title: Message output: anyOf: - additionalProperties: true type: object - type: 'null' title: Output steps: anyOf: - type: integer - type: 'null' title: Steps finishedAt: anyOf: - type: string format: date-time - type: 'null' title: Finishedat creditsUsed: anyOf: - type: number - type: 'null' title: Creditsused userId: type: string title: Userid description: 'Deprecated: use ownerId (tenancy) / createdBy (actor).' deprecated: true ownerId: type: string title: Ownerid createdBy: anyOf: - type: string - type: 'null' title: Createdby type: object required: - llmModel - task - id - status - deviceId - displayId - tmpDevice - userId - ownerId title: TaskListItem description: >- Task representation for list endpoints — omits the large trajectory field. PaginationMeta: properties: page: type: integer title: Page description: Current page number (1-based) pageSize: type: integer title: Pagesize description: Number of items per page total: type: integer title: Total description: Total number of items pages: type: integer title: Pages description: Total number of pages hasNext: type: boolean title: Hasnext description: Whether there is a next page hasPrev: type: boolean title: Hasprev description: Whether there is a previous page type: object required: - page - pageSize - total - pages - hasNext - hasPrev title: PaginationMeta description: Pagination metadata. PackageCredentials: properties: packageName: type: string title: Packagename credentialNames: items: type: string type: array title: Credentialnames type: object required: - packageName - credentialNames title: PackageCredentials VPNCountry: type: string enum: - US - BR - FR - DE - IN - JP - KR - ZA title: VPNCountry securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Opaque description: Bearer token via Authorization header ````