> ## Documentation Index > Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get tasks > Retrieve a paginated list of tasks. Responses include direct Enginy app URLs when available. Task responses include an `appUrl`, and nested contact, company, and campaign objects include direct Enginy app URLs when available. MCP agents should return those URLs to users whenever they are present in the response. Use comma-separated values for `taskIds`, `campaignIds`, and `companyIds` when passing multiple IDs. > **Required scope:** `TASKS_READ` > > **Rate limit:** 100 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json get /v1/tasks openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/tasks: get: tags: - Tasks summary: Get tasks description: >- Retrieve a paginated list of tasks. Responses include direct Enginy app URLs when available. Task responses include an `appUrl`, and nested contact, company, and campaign objects include direct Enginy app URLs when available. MCP agents should return those URLs to users whenever they are present in the response. Use comma-separated values for `taskIds`, `campaignIds`, and `companyIds` when passing multiple IDs. > **Required scope:** `TASKS_READ` > > **Rate limit:** 100 requests per minute parameters: - schema: type: integer minimum: 1 default: 1 required: false name: page in: query - schema: type: integer minimum: 1 maximum: 100 default: 25 required: false name: pageSize in: query - schema: type: string enum: - due - skipped - pending - upcoming - completed required: false name: status in: query - schema: type: string required: false name: ownerId in: query - schema: type: integer exclusiveMinimum: 0 required: false name: assignedId in: query - schema: type: string required: false name: crmId in: query - schema: type: - array - 'null' items: type: integer exclusiveMinimum: 0 required: false name: campaignIds in: query - schema: type: - array - 'null' items: type: integer exclusiveMinimum: 0 required: false name: companyIds in: query - schema: type: - array - 'null' items: type: integer exclusiveMinimum: 0 required: false name: taskIds in: query - schema: type: string enum: - email - linkedin - call - other required: false name: taskType in: query - schema: type: string required: false name: search in: query - schema: type: string required: false name: dateFrom in: query - schema: type: string required: false name: dateTo in: query - schema: type: string required: false name: statusEndOfDay in: query - schema: type: string enum: - createdAt - completedAt - dueDate required: false name: sortBy in: query - schema: type: string enum: - asc - desc required: false name: sortOrder in: query responses: '200': description: Tasks retrieved successfully content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: number appUrl: type: string format: uri createdAt: type: string format: date-time updatedAt: type: string format: date-time type: type: string subject: type: string description: type: - string - 'null' CRMId: type: - string - 'null' completedAt: type: - string - 'null' format: date-time dueDate: type: - string - 'null' format: date-time notes: type: - string - 'null' priority: type: - string - 'null' enum: - LOW - MEDIUM - HIGH - null contact: type: - object - 'null' properties: id: type: number appUrl: type: string format: uri firstName: type: - string - 'null' lastName: type: - string - 'null' imageUrl: type: - string - 'null' mobilePhone: type: - string - 'null' jobTitle: type: - string - 'null' enrichments: type: array items: type: object properties: type: type: - string - 'null' phones: type: array items: type: string required: - type - phones required: - id - appUrl - firstName - lastName - imageUrl - mobilePhone - jobTitle - enrichments company: type: - object - 'null' properties: id: type: number appUrl: type: string format: uri name: type: - string - 'null' domain: type: - string - 'null' required: - id - appUrl - name - domain campaign: type: - object - 'null' properties: id: type: number appUrl: type: string format: uri name: type: string required: - id - appUrl - name leadId: type: - number - 'null' companyId: type: - number - 'null' ownerId: type: - string - 'null' assignedId: type: - number - 'null' assignedTo: type: - object - 'null' properties: id: type: number name: type: string required: - id - name skippedAt: type: - string - 'null' format: date-time parentTaskId: type: - number - 'null' required: - id - appUrl - createdAt - updatedAt - type - subject - description - CRMId - completedAt - dueDate - notes - priority - contact - company - campaign - leadId - companyId - ownerId - assignedId - assignedTo - skippedAt - parentTaskId meta: type: object properties: page: type: number pageSize: type: number total: type: number required: - page - pageSize - total required: - data - meta security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ````