Skip to content
forgit api docs

Get all of a repository's opened milestones

GET
/repos/{owner}/{repo}/milestones

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
owner
required
string

Owner of the repo

repo
required
string

Name of the repo

Query Parameters

Section titled “ Query Parameters ”
state
string

Milestone state, Recognized values are open, closed and all. Defaults to “open”

name
string

Filter by milestone name

page
integer

Page number of results to return (1-based)

limit
integer

Page size of results

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

MilestoneList

Media type application/json
Array<object>

Milestone milestone is a collection of issues on one repository

object
closed_at
string format: date-time
closed_issues
integer format: int64
created_at
string format: date-time
description
string
due_on
string format: date-time
id
integer format: int64
open_issues
integer format: int64
state

StateType issue state type

string
title
string
updated_at
string format: date-time
Example generated 
[
  {
    "closed_at": "2026-04-15T12:00:00Z",
    "closed_issues": 1,
    "created_at": "2026-04-15T12:00:00Z",
    "description": "example",
    "due_on": "2026-04-15T12:00:00Z",
    "id": 1,
    "open_issues": 1,
    "state": "example",
    "title": "example",
    "updated_at": "2026-04-15T12:00:00Z"
  }
]

Headers

Section titled “ Headers ”
X-Total-Count
integer format: int64

The total number of milestones

404

Section titled “ 404 ”

APINotFound is a not found error response

Media type application/json
object
errors
Array<string>
message
string
url
string
Example generated 
{
  "errors": [
    "example"
  ],
  "message": "example",
  "url": "example"
}