> ## Documentation Index
> Fetch the complete documentation index at: https://developers.voxys.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List follow-up tasks

> Returns a paginated list of follow-up tasks, with optional filtering.



## OpenAPI

````yaml /api-reference/voxys_crm_swagger.json get /api/v1/accounts/{account_id}/follow_up_tasks
openapi: 3.1.0
info:
  title: Voxys Connect - CRM APIs
  description: >-
    CRM API documentation for Voxys Connect, covering Leads, Companies,
    Pipelines, Follow-up Tasks, and Conversation CRM.
  version: 1.0.0
  contact:
    email: support@voxys.ai
  license:
    name: MIT License
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://connect.voxys.ai
security:
  - userApiKey: []
tags:
  - name: Leads
    description: >-
      Manage CRM leads including creation, status changes, notes, and
      conversion.
  - name: Companies
    description: Manage companies, their contacts, timelines, and duplicate merging.
  - name: Pipelines
    description: Manage sales funnels (pipelines), their stages, and kanban cards.
  - name: Follow-up Tasks
    description: >-
      Create and manage follow-up tasks attached to leads, deals, or
      conversations.
  - name: Conversation CRM
    description: >-
      CRM panel within a conversation: link pipelines, leads, and convert to
      deal.
paths:
  /api/v1/accounts/{account_id}/follow_up_tasks:
    parameters:
      - $ref: '#/components/parameters/account_id'
    get:
      tags:
        - Follow-up Tasks
      summary: List follow-up tasks
      description: Returns a paginated list of follow-up tasks, with optional filtering.
      operationId: list-follow-up-tasks
      parameters:
        - name: taskable_type
          in: query
          schema:
            type: string
            enum:
              - Lead
              - FunnelCard
              - Conversation
              - Contact
          description: Filter tasks by the type of attached entity.
        - name: taskable_id
          in: query
          schema:
            type: integer
          description: >-
            Filter tasks by the ID of the attached entity. Requires
            taskable_type.
        - name: status
          in: query
          schema:
            type: string
            enum:
              - pending
              - completed
              - snoozed
          description: Filter by task status.
        - name: due_before
          in: query
          schema:
            type: string
            format: date-time
          description: Return tasks due before this timestamp.
        - name: due_after
          in: query
          schema:
            type: string
            format: date-time
          description: Return tasks due after this timestamp.
        - $ref: '#/components/parameters/page'
        - $ref: '#/components/parameters/per_page'
      responses:
        '200':
          description: Paginated list of tasks.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/follow_up_task'
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                      total_pages:
                        type: integer
                      total_count:
                        type: integer
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_response'
components:
  parameters:
    account_id:
      name: account_id
      in: path
      required: true
      schema:
        type: integer
      description: The numeric ID of the account.
    page:
      name: page
      in: query
      schema:
        type: integer
        default: 1
      description: Page number for pagination.
    per_page:
      name: per_page
      in: query
      schema:
        type: integer
        default: 25
        maximum: 100
      description: Number of records per page.
  schemas:
    follow_up_task:
      type: object
      properties:
        id:
          type: integer
          example: 20
        title:
          type: string
          example: Follow up with prospect
        description:
          type: string
          nullable: true
          example: Call back after proposal review.
        status:
          type: string
          enum:
            - pending
            - completed
            - snoozed
          example: pending
        priority:
          type: string
          enum:
            - low
            - medium
            - high
          example: medium
        due_at:
          type: string
          format: date-time
          nullable: true
        completed_at:
          type: string
          format: date-time
          nullable: true
        taskable_type:
          type: string
          example: Lead
        taskable_id:
          type: integer
          example: 42
        assigned_to:
          $ref: '#/components/schemas/agent_summary'
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    error_response:
      type: object
      properties:
        error:
          type: string
          example: Unauthorized
    agent_summary:
      type: object
      properties:
        id:
          type: integer
          example: 1
        name:
          type: string
          example: Jane Smith
        email:
          type: string
          format: email
          example: jane@example.com
        avatar_url:
          type: string
          format: uri
          nullable: true
  securitySchemes:
    userApiKey:
      type: apiKey
      in: header
      name: api_access_token
      description: >-
        API access token for authentication. Obtain from your Voxys Connect
        profile settings.

````