GET/milestones.json

List All Milestones

Lists all milestones on projects that the authenticated user is associated with. You can set the "find" option to return only those milestones that are incomplete, completed, upcoming or late. All milestones are returning in this call. This call uses pagination. 100 milestones are returned per page.


Query Params

  • Name
    pageSize
    Type
    integer
    Description

    The amount of Milestones returned can be limited using this parameter. Normally used in conjunction with the page parameter

    Maximum: 400

    Default
    100
  • Name
    page
    Type
    integer
    Description

    Optionally, you can set the page from which to start retrieving results. This is usually used in conjunction with the parameter pageSize.

    See How does paging work for more detailed documentation on pagination.

    See How does paging work for more detailed documentation on pagination. For example: ?page=2&pageSize=10 will retrieve results 10-20.

  • Name
    find
    Type
    string
    Description

    Find certain milestones. Options: al|,complete,incomplete,late,upcoming

  • Name
    getProgress
    Type
    boolean
    Description

    Use this parameter to return a field percentageComplete

    Default
    false
  • Name
    projectType
    Type
    string
    Description

    use ALL to bring back milestones related to archived projects.

    Default
    ACTIVE

Responses

  • Code
    200
    Type
    object
    Schema
    Description
    200 Response

Examples

200 Response

application/json
{
  "milestones": [
    {
      "project-id": "999",
      "canComplete": true,
      "responsible-party-id": "999",
      "completer-id": "999",
      "comments-count": "0",
      "private": false,
      "status": "completed",
      "completed-on": "2014-02-27T18:24:59Z",
      "created-on": "2014-02-25T14:56:54Z",
      "canEdit": true,
      "responsible-party-type": "Person",
      "isprivate": "no",
      "company-name": "Demo 1 Company",
      "id": "999",
      "last-changed-on": "2014-02-27T18:25:20Z",
      "completed": true,
      "reminder": "no",
      "tasklists": [],
      "description": "",
      "responsible-party-firstname": "'Demo",
      "completer-firstname": "'Demo",
      "responsible-party-ids": "999",
      "responsible-party-names": "'Demo ",
      "responsible-party-lastname": "User'",
      "company-id": "999",
      "creator-id": "999",
      "completer-lastname": "User'",
      "project-name": "Demo Project",
      "deadline": "20140212",
      "_isprivate": {
        "deprecated": true
      },
      "title": "Demo Milestone"
    }
  ]
}