Get Milestones

GET /api/v1.0/milestones
Bearer

This endpoint fetch the list of milestones.

Query parameters

  • project_id string Required

    Project ID

  • limit string

    No of records per page

  • offset string

    Record Offset

  • sort string

    Sorting order, default is descending

    Values are ascending or descending.

  • is_list string

    List Flag

Responses

  • 200 application/json

    Success Response

    Hide response attributes Show response attributes object
    • hasMore boolean Required

      True if there are more record else false

      Default value is false.

    • items array[object] Required

      List of Label records

      Hide items attributes Show items attributes object
      • id string Required

        Milestone ID

      • name string Required

        Milestone Name

      • created_at string(date-time) Required

        Creation Date

      • created_by string Required

        Operation message

      • description string Required

        Description

      • dependency string Required

        Dependencies

      • start string(date-time) Required

        Start Date

      • end string(date-time) Required

        End Date

      • archived string Required

        achived

      • project string Required

        Project

      • task_group string Required

        Task Group

      • rule string Required

        Rules

      • tasks array[string] Required

        List of Tasks

      • hidden array[string] Required

        hidden

      • fields array[object] Required
        Hide fields attributes Show fields attributes object
        • id string Required

          Id

        • value string Required

          Value

      • statistic object Required
        Hide statistic attributes Show statistic attributes object
        • total number Required

          Total

        • completed number Required

          Completed

        • overdue number Required

          Overdue

        • total_story_points number Required

          Total Story Point

        • completed_story_points number Required

          Completed Story Point

      • order number Required

        Order

      • color string Required

        Color

      • is_list boolean Required

        List Flag

      • assignees array[string] Required

        Assignee to List
  • 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/milestones 
curl \
 --request GET 'https://openapi.niftypm.com/api/v1.0/milestones?project_id=string' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "hasMore": false,
  "items": [
    {
      "id": "string",
      "name": "string",
      "created_at": "2025-05-04T09:42:00Z",
      "created_by": "string",
      "description": "string",
      "dependency": "string",
      "start": "2025-05-04T09:42:00Z",
      "end": "2025-05-04T09:42:00Z",
      "archived": "string",
      "project": "string",
      "task_group": "string",
      "rule": "string",
      "tasks": [
        "string"
      ],
      "hidden": [
        "string"
      ],
      "fields": [
        {
          "id": "string",
          "value": "string"
        }
      ],
      "statistic": {
        "total": 42.0,
        "completed": 42.0,
        "overdue": 42.0,
        "total_story_points": 42.0,
        "completed_story_points": 42.0
      },
      "order": 42.0,
      "color": "string",
      "is_list": true,
      "assignees": [
        "string"
      ]
    }
  ]
}