Project milestones

List project milestones

Filtered request example — Milestones of one project in one status, oldest first:

curl -g -H "Authorization: Bearer pcrm_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  "https://api.pipelinecrm.com/api/v3/project_milestones.json?conditions[project_milestone_project]=88&conditions[project_milestone_status]=2&sort=project_milestone_created_at"
get/project_milestones

Request

  • Base URL: https://api.pipelinecrm.com/api/v3
  • URL: https://api.pipelinecrm.com/api/v3/project_milestones
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer and API key in header app-key
    • API key in query parameter api_key and API key in query parameter app_key

Query parameters

project_milestone_idstring

Comma-separated list of milestone IDs to return

project_milestone_namestring

Returns records that match a LIKE query on the name field

project_milestone_projectinteger

Returns records belonging to the project with this ID

project_milestone_statusinteger

Returns records with the project milestone status with this ID

Filters as bracketed query parameters, for example ?conditions[project_milestone_project]=88&conditions[project_milestone_status]=2. Each key below is one filter; see the Filtering guide for the value formats (ids, lists, date ranges, number ranges, custom fields) and the example above for a complete request.

{
  "project_milestone_id": "111,112,113",
  "project_milestone_name": "Phase 1",
  "project_milestone_project": 1,
  "project_milestone_status": 1,
  "project_milestone_start_date": "last_30",
  "project_milestone_end_date": "last_30",
  "project_milestone_created_at": "last_30",
  "project_milestone_updated_at": "last_30"
}

Response

Successful Response

Example response

{
  "entries": [
    {
      "id": 1,
      "project_id": 1,
      "created_by_user_id": 13473,
      "project_name": "Website Redesign",
      "created_by_user": {
        "id": 13473,
        "first_name": "John",
        "last_name": "Smith"
      },
      "status": {
        "id": 1,
        "name": "Not Started",
        "hex_color": "#9CA3AF",
        "status_type": "not_started"
      },
      "project": {
        "id": 1,
        "name": "Website Redesign",
        "description": "Complete redesign of the company website",
        "status": "open",
        "start_date": "2025-01-15",
        "end_date": "2025-06-30",
        "owner_id": 13473,
        "owner": {
          "id": 13473,
          "first_name": "John",
          "last_name": "Smith",
          "full_name": "John Smith"
        }
      },
      "milestone_tasks": [
        {
          "id": 1,
          "type": "CalendarTask",
          "name": "Research competitors",
          "due_date": "2025-01-20",
          "owner_id": 13473,
          "owner": {
            "id": 13473,
            "full_name": "John Smith"
          }
        }
      ],
      "milestone_events": [
        {
          "id": 2,
          "type": "CalendarEvent",
          "name": "Kickoff meeting",
          "start_time": "2025-01-16 09:00:00",
          "end_time": "2025-01-16 10:00:00",
          "start_time_date": "2025-01-16",
          "start_time_time": "09:00",
          "end_time_date": "2025-01-16",
          "end_time_time": "10:00",
          "owner_id": 13473,
          "owner": {
            "id": 13473,
            "full_name": "John Smith"
          }
        }
      ],
      "created_at": "2026-09-01 14:22:07",
      "updated_at": "2026-09-01 14:22:07",
      "name": "Phase 1 - Discovery",
      "project_milestone_status_id": 1,
      "start_date": "2025-01-15",
      "end_date": "2025-02-28",
      "milestone_tasks_attributes": [
        {
          "name": "Research competitors",
          "due_date": "2025-01-20",
          "owner_id": 13473
        }
      ],
      "milestone_events_attributes": [
        {
          "name": "Kickoff meeting",
          "start_time_date": "2025-01-16",
          "start_time_time": "09:00",
          "end_time_date": "2025-01-16",
          "end_time_time": "10:00",
          "owner_id": 13473
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 200,
    "total": 670,
    "pages": 4,
    "total_in_account": 1204,
    "page_var": "page",
    "url": "/api/v3/deals.json"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.