In this guide

List Milestones

A repository's milestones, soonest due first.

Action referenceRead

What this action does #

First, connect GitHub in Services. Then open Actions → + → GitHub and choose List Milestones.

More about this action

The number is what Milestone takes everywhere else, not the title.

Inputs to fill in #

Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.

Owner

RequiredText

User or organisation.

This input offers a picker for repository from your connected account. You can also supply its value directly.

Example value (replace with your own):

octocat

Repository

RequiredText

Name only, without the owner and without .git.

This input offers a picker for repository from your connected account. You can also supply its value directly.

Example value (replace with your own):

Hello-World

State

OptionalChoice

Supply a choice value for this input.

Choices: open, closed, all

Default: open

Sort By

OptionalChoice

Supply a choice value for this input.

Choices: due_on, completeness

Direction

OptionalChoice

Supply a choice value for this input.

Choices: asc, desc

Page Size

OptionalWhole number

1–100. GitHub silently clamps anything larger.

Example value (replace with your own):

Page

OptionalWhole number

Starts at 1. Bind this to a Shortcuts slot if you want to page from a Repeat loop rather than fetching several pages in one go.

Example value (replace with your own):

What comes back #

In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.

Returned field	Type	Meaning
`number`	integer	What Milestone takes.
`title`	string	Text value.
`description`	string	Text value.
`state`	string	open or closed.
`due_on`	string	ISO 8601, or null.
`open_issues`	integer	Whole-number value.
`closed_issues`	integer	Whole-number value.
`html_url`	string	Text value.

Run it from Shortcuts #

Give the action a recognizable name and tap Save.
In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
Supply any Param or File slots you bound in the inputs, then run the shortcut.

If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.

This action supports multiple pages of results. Open its Fetch setting to retrieve more pages when one page is not enough. Each page adds a service request.

Advanced reference #

Request, permissions, and identifiers

Request: GET https://api.github.com/repos/{owner}/{repo}/milestones

Action identifier: github.milestones.list.v1

Permissions declared for this action: issues:read. The account’s own access rules also apply.

Input	Request key	Location
Owner	`owner`	path
Repository	`repo`	path
State	`state`	query
Sort By	`sort`	query
Direction	`direction`	query
Page Size	`per_page`	query
Page	`page`	query

GitHub API reference