--- title: "Get project milestones" method: GET path: "/api/v2/project_milestones" tags: ["Project Milestones"] --- # Get project milestones `GET /api/v2/project_milestones` ## Request - Base URL: `https://developer.productive.io` (the document declares no server; this is the origin it was published from) - URL: `https://developer.productive.io/api/v2/project_milestones` - Auth: none declared Returns a paginated list of project milestones on projects you can view. Supports filtering by project, assignee, date or a date window (`after`/`before`), title search (`query`), and by related people, projects, tasks, deals or budgets. ## Query parameters - `filter` union: Filter schema for `project_milestone` list endpoints — pass a single condition or a logical group. - object: A logical filter group — combine multiple conditions with the `$op` operator. - `$op` 'or' | 'and', required: Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match. - FilterProjectMilestone: Filter parameters for listing project milestones. Supports filtering by ID, project, assignee, date, a date window (`after`/`before`), title search, and by related people, projects, tasks, deals or budgets. - `after` union: Return milestones on or after this date. The operator is ignored — the value is always an inclusive lower bound. - object: Filter using explicit operator syntax. - `eq` After (unresolved $ref) - `not_eq` After (unresolved $ref) - `contains` After (unresolved $ref) - `not_contain` After (unresolved $ref) - After (unresolved $ref) - `assignee_id` union: Filter by the person assigned to the milestone. - object: Filter using explicit operator syntax. - `eq` AssigneeId (unresolved $ref) - `not_eq` AssigneeId (unresolved $ref) - `contains` AssigneeId (unresolved $ref) - `not_contain` AssigneeId (unresolved $ref) - AssigneeId (unresolved $ref) - `before` union: Return milestones on or before this date. The operator is ignored — the value is always an inclusive upper bound. - object: Filter using explicit operator syntax. - `eq` Before (unresolved $ref) - `not_eq` Before (unresolved $ref) - `contains` Before (unresolved $ref) - `not_contain` Before (unresolved $ref) - Before (unresolved $ref) - `date` union: Filter by milestone date. Besides the listed operators, `gt`, `gt_eq`, `lt` and `lt_eq` are supported. - object: Filter using explicit operator syntax. - `eq` Date (unresolved $ref) - `not_eq` Date (unresolved $ref) - `contains` Date (unresolved $ref) - `not_contain` Date (unresolved $ref) - Date (unresolved $ref) - `id` union: Filter by project milestone ID. - object: Filter using explicit operator syntax. - `eq` Id (unresolved $ref) - `not_eq` Id (unresolved $ref) - `contains` Id (unresolved $ref) - `not_contain` Id (unresolved $ref) - Id (unresolved $ref) - `project_id` union: Filter by the project the milestone belongs to. Supports `eq` and `not_eq`; other operators have no effect. - object: Filter using explicit operator syntax. - `eq` ProjectId (unresolved $ref) - `not_eq` ProjectId (unresolved $ref) - `contains` ProjectId (unresolved $ref) - `not_contain` ProjectId (unresolved $ref) - ProjectId (unresolved $ref) - `query` union: Search milestones by title. `contains` matches titles containing all search terms (`not_contain` the opposite); `eq`/`not_eq` compare the exact title. - object: Filter using explicit operator syntax. - `eq` Query (unresolved $ref) - `not_eq` Query (unresolved $ref) - `contains` Query (unresolved $ref) - `not_contain` Query (unresolved $ref) - Query (unresolved $ref) - `sort` string[] ## Response `200` Paginated list of project milestones. - object: Paginated list of project milestone records in JSON:API format. - `data` object[]: Array of project milestone resource objects. - `attributes` object: Project milestone attributes. - `color_id` ColorId (unresolved $ref) - `created_at` CreatedAt (unresolved $ref) - `date` Date (unresolved $ref) - `icon_id` IconId (unresolved $ref) - `note` Note (unresolved $ref) - `title` Title (unresolved $ref) - `updated_at` UpdatedAt (unresolved $ref) - `relationships` object: Project milestone relationships. - `assignee` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `creator` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `organization` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `project` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `included` unknown[]: Sideloaded related resources. - unknown - `meta` Meta: Pagination and response metadata returned with every collection endpoint. - `current_page` integer: The current page number in this paginated response (1-based). - `max_page_size` integer: Maximum number of records allowed per page for this endpoint. - `organization_features` object: Feature flags and capabilities enabled for the current organization, used for UI rendering. - `page_size` integer: Number of records returned per page in this response. - `settings` object: Organization or user settings relevant to this resource's display. - `total_count` integer: Total number of records matching the current query across all pages. - `total_pages` integer: Total number of pages available for the current query and page size. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `408`: Request Timeout - `423`: Locked - `429`: Too Many Requests - `500`: Internal Server Error ## Changes - **2026-11-02** `fa3060fd0144`: 7 info - added the non-success response with the status `400` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `408` - …3 more - **2026-10-27** `f11a8740641a`: 1 info - endpoint added - …this revision’s changelog is incomplete [Operation history](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/project_milestones/get.md) --- [API](https://skmtc.dev/productive/apis/api-documentation.md) - [All operations](https://skmtc.dev/productive/apis/api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/productive/apis/api-documentation/revisions/e7bdfdf6cba3?raw)