Milestones
Last updated
Was this helpful?
Last updated
Was this helpful?
The milestones
namespace provides API methods to retrieve all or specific milestones for a project. This page covers the following API methods:
/projects/{project_id}/milestones
Returns all milestones for a project.
This method uses pagination so you might need to request additional pages to retrieve all milestones.
This method supports the following expands so you can automatically include additional information for referenced objects:
issues
milestone_stats
milestone_types
milestones
statuses
users
200
400
401
403
422
(details)
/milestones/{milestone_id}
Returns a single milestone.
This method supports the following expands so you can automatically include additional information for referenced objects:
issues
milestone_stats
milestone_types
milestones
statuses
users
200
400
401
403
404
422
(details)
project_id
id
required
ID of the project.
page
integer
Number of page to return (default: first page)
per_page
integer
Maximum number of milestones to return (supported: 15
, 25
, 50
, 100
; default: 100
)
sort
string
Sort field for the list of milestones (supported: milestones:created_at
, milestones:completed_at
; default: milestones:created_at
)
order
string
Sort order (ascending or descending) (supported: asc
, desc
; default: desc
)
automation_tags
string
Comma-separated list of automation tags to filter by.
completed_after
string
Limit result to milestones completed after (in ISO8601 format and UTC time zone).
completed_before
string
Limit result to milestones completed before (in ISO8601 format and UTC time zone).
created_after
string
Limit result to milestones created after (in ISO8601 format and UTC time zone).
created_before
string
Limit result to milestones created before (in ISO8601 format and UTC time zone).
created_by
string
Comma-separated list of users to filter by.
is_completed
boolean
Limit result to active or completed milestones only.
parent_id
string
Comma-separated list of parent milestones to filter by.
root_id
string
Comma-separated list of root milestones to filter by.
type_id
string
Comma-separated list of milestone types to filter by.
expands
string
Comma-separated list of expands to return.
milestone_id
id
required
ID of the milestone to return.
expands
string
Comma-separated list of expands to return.