In this guide

Get a Pull Request

One pull request, including whether it can be merged.

Action referenceRead

What this action does #

First, connect GitHub in Services. Then open Actions → + → GitHub and choose Get a Pull Request.

More about this action

The only place that reports mergeability and the diff totals, because GitHub computes them per request rather than per list.

Mergeable comes back null while GitHub is still working it out, and a null is not a no. An action that must know should ask again a few seconds later rather than treat null as unmergeable.

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

Pull Request Number

RequiredWhole number

The number shown in the interface.

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

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.
`mergeable`	boolean	Null while GitHub is still computing it.
`mergeable_state`	string	clean, dirty, blocked, behind, unstable, unknown.
`rebaseable`	boolean	True or false.
`commits`	integer	Whole-number value.
`additions`	integer	Lines added.
`deletions`	integer	Lines removed.
`changed_files`	integer	Whole-number value.
`comments`	integer	Conversation comments.
`review_comments`	integer	Comments on the diff.
`maintainer_can_modify`	boolean	True or false.

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.

Advanced reference #

Request, permissions, and identifiers

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

Action identifier: github.pulls.get.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
Pull Request Number	`pull_number`	path

GitHub API reference