In this guide

List Pull Requests

Open pull requests in a repository.

Action referenceRead

What this action does #

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

More about this action

The review queue. Base narrows it to one target branch — `main` — and Head to one source, written `owner:branch` rather than as a bare branch name.

Sorting by long-running with State open is the "what is stuck" list; it only considers pull requests older than a month.

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

Head

OptionalText

Source branch, as owner:branch.

Example value (replace with your own):

octocat:feature-login

Base

OptionalText

Target branch name.

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

Example value (replace with your own):

main

Sort By

OptionalChoice

popularity is comment count; long-running is age.

Choices: created, updated, popularity, long-running

Default: created

Direction

OptionalChoice

Supply a choice value for this input.

Choices: desc, asc

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 number shown in the UI.
`id`	integer	Whole-number value.
`title`	string	Text value.
`state`	string	open or closed. A merged pull request is closed.
`draft`	boolean	True or false.
`merged_at`	string	Null unless it was merged — the way to tell merged from simply closed.
`body`	string	The description, as Markdown.
`html_url`	string	The pull request page.
`created_at`	string	ISO 8601.
`updated_at`	string	Text value.
`closed_at`	string	Text value.
`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	A list of values.
`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.
`requested_reviewers`	array	Review requests still outstanding.
`requested_reviewers[].login`	string	Username.
`requested_reviewers[].id`	integer	Whole-number value.
`requested_reviewers[].html_url`	string	Their profile page.
`requested_reviewers[].avatar_url`	string	Text value.
`requested_reviewers[].type`	string	User, Organization or Bot.
`labels`	array	A list of values.
`labels[].name`	string	Text value.
`labels[].color`	string	Text value.
`head`	object	Where the changes come from.
`head.ref`	string	Branch name.
`head.sha`	string	Latest commit on that branch.
`head.label`	string	owner:branch.
`base`	object	Where they are going.
`base.ref`	string	Branch name.
`base.sha`	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}/pulls

Action identifier: github.pulls.list.v1

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

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

GitHub API reference