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 typeapplication/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
Examplegenerated
[
  {
    "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 typeapplication/json
object
errors
Array<string>
message
string
url
string
Examplegenerated
{
  "errors": [
    "example"
  ],
  "message": "example",
  "url": "example"
}