GET/projects/{id}/tasklists.json

Get all Task Lists for a Project

Retrieves all project task lists.

Additional notes:

Pagination:

By default we'll send back 250 task list/todo list records per page. Inspect the Response Headers for the following values:

  • X-Page (The current page being returned)
  • X-Pages (The total number of pages available)
  • X-Records (The total number of items available) You can request a specific page by calling the same API call and adding the parameter &page=n where n is the page you want. e.g: &page=2 for page 2, &page=5 for page 5.

Path Params

  • Name
    id
    Type
    string
    required
    Description

Query Params

  • Name
    responsible-party-id
    Type
    string
    Description
  • Name
    getOverdueCount
    Type
    boolean
    Description
    Passing getOverdueCount will return the number of overdue tasks overdue-count for each task list.
  • Name
    status
    Type
    string
    Description

    string
    Status: You can use the status option to restrict the Task Lists returned - valid values are all, active, and completed. The default is "active"
  • Name
    showMilestones
    Type
    boolean
    Description
    Passing showMilestones=1 will add Milestone information in to the response, if a Milestone is attached to the Task List
  • Name
    getCompletedCount
    Type
    boolean
    Description
  • Name
    filter
    Type
    string
    Description
    anytime, today, tomorrow, overdue, yesterday
  • Name
    updatedAfterDate
    Type
    string
    Description
    Get all tasklists updated after a certain date.
  • Name
    sortby
    Type
    string
    Description
    string - orders the results by one of the following: displayOrder, name, status, dateCreatedASC, dateCreatedDESC, dateUpdatedASC, dateUpdatedDESC, projectNameASC, projectNameDESC (Default is displayOrder)
  • Name
    searchTerm
    Type
    string
    Description
  • Name
    projectStatus
    Type
    string
    Description
  • Name
    showCompleted
    Type
    boolean
    Description
    Return completed tasklists.
  • Name
    showDeleted
    Type
    boolean
    Description
    Return deleted tasklists.

Responses

  • Code
    200
    Type
    object
    Schema
    Description
    200 Response

Examples

200 Response

application/json
{
  "STATUS": "OK",
  "tasklists": [
    {
      "name": "Offering Checklist",
      "pinned": false,
      "milestone-id": "",
      "description": "",
      "uncompleted-count": 0,
      "id": "671263",
      "complete": false,
      "private": false,
      "isTemplate": false,
      "position": 4048,
      "status": "new",
      "projectId": "223699",
      "projectName": "New hires",
      "DLM": null
    }
  ]
}