Listing Which GitHub Pull Requests are in a Project

Featured image for sharing metadata for article

Let's say that you want to list the pull requests that are in a given GitHub Project board.

Unfortunately, there's no handy way that is provided as part of the API, so we need to get a little creative.

First, you'll need to generate a personal access token with at least the public_repo scope.

For instance, we'll use Wiremock 2.29.0 as an example.

Next, we'll need to discover this project boards' project ID for the API:

curl \
  -H "Authorization: Bearer ..." \
  -H "Accept: application/vnd.github.v3+json" \
    "owner_url": "",
    "url": "",
    "html_url": "",
    "columns_url": "",
    "id": 12649878,
    "node_id": "MDc6UHJvamVjdDEyNjQ5ODc4",
    "name": "WireMock 2.29.0",
    "body": "New features + fixes for the v2.29.0 release.",
    "number": 4,
    "state": "open",
    "creator": {
    "created_at": "2021-06-10T14:56:59Z",
    "updated_at": "2021-06-30T16:18:09Z"

Now we have the id, we can start to list all the cards on the project.

We do this by listing all the columns on the project, then each of the cards on the columns - unfortunately it's a little wasteful, and on larger boards could be quite slow.

We then take advantage of the fact that if an Issue/PR is tagged against a project, the card's contents is just the URL of the Issue/PR, so we can filter for anything with this present.

Next, we will want to make sure that the provided URL is actually a PR, not an Issue, so we query the PR API to validate that it is a PR.

For instance, using the Ruby GitHub Gem, the code would look like the following:

require 'github_api'

board_id = ARGV[0]
github = oauth_token: ENV['TOKEN']

github.projects.columns.list(board_id) do |col|
  pulls = do |card|
    next unless card.content_url
    next unless card.content_url.include? '/issues/'

    parts = card.content_url.split '/'
    # need to filter for things that are actually PRs, as they have the same `/issues/` URL as an Issue URL
      pr = github.pull_requests.get parts[4], parts[5], parts[-1]
    rescue Github::Error::NotFound
      # almost certainly was an Issue, not a PR, so we can ignore it
  next if pulls.empty?

  jj pulls

We then can run this with:

env TOKEN=... ruby list-project.rb 12649878

And it'll dump out the HTML URLs of the PRs that are part of that project!


You can hopefully see other opportunities, like filtering based on the column that a project is in, so we can query for i.e. PRs that in the "done" column, or to list all the Projects a PR can be found in.

Written by Jamie Tanna's profile image Jamie Tanna on , and last updated on .

Content for this article is shared under the terms of the Creative Commons Attribution Non Commercial Share Alike 4.0 International, and code is shared under the Apache License 2.0.

#blogumentation #github #github-projects #ruby.

This post was filed under articles.

Interactions with this post

Interactions with this post

Below you can find the interactions that this page has had using WebMention.

Have you written a response to this post? Let me know the URL:

Do you not have a website set up with WebMention capabilities? You can use Comment Parade.