GET /api/v1.0/tasks

This endpoint fetch the list of tasks for the team member.

Query parameters

  • project_id string

    Filter tasks by project. Returns only tasks belonging to this project.

  • task_group_id string

    Filter tasks by task group. Returns only tasks within this task group.

  • task_id string

    Fetch a single task by its unique identifier.

  • member_id string

    Filter tasks by member. Returns tasks assigned to or involving this member.

  • meeting_id string

    Filter tasks linked to a specific meeting.

  • milestone_id string

    Filter tasks associated with a specific milestone.

  • completed_by string

    Filter tasks completed by this member (user/member ID).

  • archived string

    When true, returns only archived tasks. When false, returns only non-archived tasks. Pass as query string "true" or "false".

    Values are true or false. Default value is false.

  • include_archived string

    When true, response includes archived tasks along with active ones. Use with archived=false to get both active and archived in one call.

    Values are true or false. Default value is true.

  • completed string

    Filter by completion status. "true" = completed tasks only, "false" = incomplete only. Omit for all tasks.

    Values are true or false.

  • limit string

    Maximum number of tasks to return per page. Used for pagination.

    Minimum value is 1, maximum value is 100. Default value is 25.

  • offset string

    Number of records to skip. Used with limit for pagination: page 1 = 0, page 2 = limit, page 3 = 2*limit, etc.

    Minimum value is 0. Default value is 0.

  • order string

    Sort field and direction. Format: fieldName:DIRECTION. Allowed fields: dueDate, archivedOn, completedOn. Direction: ASC or DESC. Example: completedOn:DESC sorts by completion date newest first.

    Values are dueDate:ASC, dueDate:DESC, archivedOn:ASC, archivedOn:DESC, completedOn:ASC, or completedOn:DESC.

  • from string

    Filter tasks with due date on or after this date. ISO 8601 format (YYYY-MM-DD or full datetime).

  • to string

    Filter tasks with due date on or before this date. ISO 8601 format (YYYY-MM-DD or full datetime).

  • archived_from string

    Filter archived tasks archived on or after this date. ISO 8601 format.

  • archived_to string

    Filter archived tasks archived on or before this date. ISO 8601 format.

  • completed_from string

    Filter completed tasks with completion date on or after this date. ISO 8601 format.

  • completed_to string

    Filter completed tasks with completion date on or before this date. ISO 8601 format.

  • include_subtasks string

    When true, response includes subtasks under each task. Pass as "true" or "false".

    Values are true or false.

  • sort string

    Secondary sort order when order field is used. Use with order param for consistent ordering.

    Values are ascending or descending.

  • project_ids string

    Comma-separated list of project IDs. Returns tasks that belong to any of these projects. Example: "id1,id2,id3".

  • assignee_ids array[string]

    Filter tasks by assignee. Returns tasks assigned to any of the given member/user IDs. Send as multiple query params: assignee_ids[]=id1&assignee_ids[]=id2.

Responses

  • 200 application/json

    Success Response

    Hide response attributes Show response attributes object
    • tasks array[object] Required

      List of all tasks

    • hasMore boolean Required

      True if there are more record else false

      Default value is false.

  • 401

    The client request has not been completed because it lacks valid authentication credentials for the requested resource.

  • 403

    The client does not have access rights to the content.

  • 405

    The request method is known by the server but is not supported by the target resource.

GET /api/v1.0/tasks
curl \
 --request GET 'https://openapi.niftypm.com/api/v1.0/tasks' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "tasks": [
    {}
  ],
  "hasMore": false
}