In this guide

List Repository Issues

Open issues in a repository.

Action referenceRead

What this action does #

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

More about this action

Every pull request is an issue to this endpoint, so a repository with open pull requests returns them here too. The `pull_request` field is present only on those, which is how an action tells them apart.

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):

apple

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):

api

State

OptionalChoice

Supply a choice value for this input.

Choices: open, closed, all

Default: open

Labels

OptionalList

Only issues carrying all of these labels.

A list of text values. Use a comma-separated list.

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

Assignee

OptionalText

A username, `none` for unassigned, or `*` for any assignee.

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

Example value (replace with your own):

octocat

Created By

OptionalText

Username of the person who opened it.

Mentions

OptionalText

Username mentioned in the issue.

Milestone

OptionalText

A milestone number, `none`, or `*` for any.

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

Updated After

OptionalText

ISO 8601. Only issues updated at or after this time.

Example value (replace with your own):

2026-09-01T00:00:00Z

Sort By

OptionalChoice

Supply a choice value for this input.

Choices: created, updated, comments

Default: created

Direction

OptionalChoice

Supply a choice value for this input.

Choices: desc, asc

Default: 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	The issue number shown in the UI.
`id`	integer	Internal id. Not the number.
`title`	string	Text value.
`state`	string	open or closed.
`state_reason`	string	completed, not_planned, reopened or duplicate.
`body`	string	The issue text, as Markdown.
`html_url`	string	The issue page.
`comments`	integer	How many comments it has.
`locked`	boolean	True or false.
`created_at`	string	ISO 8601.
`updated_at`	string	Text value.
`closed_at`	string	Null while open.
`user`	object	Who opened it.
`user.login`	string	Username.
`user.id`	integer	Whole-number value.
`user.html_url`	string	Their profile page.
`user.avatar_url`	string	Text value.
`user.type`	string	User, Organization or Bot.
`assignees`	array	Everyone assigned.
`assignees[].login`	string	Username.
`assignees[].id`	integer	Whole-number value.
`assignees[].html_url`	string	Their profile page.
`assignees[].avatar_url`	string	Text value.
`assignees[].type`	string	User, Organization or Bot.
`milestone`	object	Null when unset.
`milestone.number`	integer	Whole-number value.
`milestone.title`	string	Text value.
`milestone.due_on`	string	Text value.
`labels`	array	Each entry is either an object or a plain string.
`labels[].name`	string	Text value.
`labels[].color`	string	Six hex digits, no leading #.
`labels[].description`	string	Text value.
`pull_request`	object	Present only when the issue is a pull request.
`pull_request.html_url`	string	Text value.
`pull_request.merged_at`	string	Null unless it was merged.

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}/issues

Action identifier: github.issues.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
Labels	`labels`	query
Assignee	`assignee`	query
Created By	`creator`	query
Mentions	`mentioned`	query
Milestone	`milestone`	query
Updated After	`since`	query
Sort By	`sort`	query
Direction	`direction`	query
Page Size	`per_page`	query
Page	`page`	query

GitHub API reference