# GitHub API: List issues or pull requests

> Lists public issues or pull requests for a GitHub project, with state, label and sort options. A bare project name matches the most-starred repository with that name.

Unofficial. Not affiliated with or endorsed by GitHub.

- Page: https://fous.com/methods/github.com/list-issues
- Method: `github.com/list_issues`, version 1
- Website: github.com
- Returns: project, project link, items with title, number, author, labels, state, comment count, dates, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `sort` | string | no |  | Sort order, for example recently_updated. One of "newest", "most_commented", "recently_updated". Default "newest". |
| `type` | string | no |  | What to list, for example issues. One of "issues", "pull_requests". Default "issues". |
| `label` | string | no | `"kind/bug"` | Only items with this label, for example bug. |
| `state` | string | no |  | Which state to include, for example open. One of "open", "closed", "all". Default "open". |
| `project` | string | yes | `"kubernetes"` | Repository name, owner/name or GitHub project link, for example kubernetes or kubernetes/kubernetes. |
| `max_results` | integer | no | `3` | Maximum number of items to return, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "label": "kind/bug",
  "project": "kubernetes",
  "max_results": 3
}
```

Its output:

```json
{
  "items": [
    {
      "link": "https://github.com/kubernetes/kubernetes/issues/143308",
      "state": "open",
      "title": "PodTopologyLabels (KEP-4742): pods bound before their Node gets topology labels, never receive them (e.g. DaemonSet pods on new nodes)",
      "author": "rodrigorfk",
      "labels": [
        "kind/bug",
        "sig/node",
        "sig/cloud-provider"
      ],
      "number": 143308,
      "created_date": "2026-10-22",
      "comment_count": 1,
      "last_updated_date": "2026-10-22"
    },
    {
      "link": "https://github.com/kubernetes/kubernetes/issues/143275",
      "state": "open",
      "title": "kube-proxy can lose the initial node topology event and ignore zone hints until restart",
      "author": "sboulkour",
      "labels": [
        "kind/bug",
        "sig/network",
        "needs-triage"
      ],
      "number": 143275,
      "created_date": "2026-10-21",
      "comment_count": 5,
      "last_updated_date": "2026-10-23"
    },
    {
      "link": "https://github.com/kubernetes/kubernetes/issues/143268",
      "state": "open",
      "title": "Scheduling queue: gated pod group is requeued on events its gating plugin's QueueingHint skips",
      "author": "Argh4k",
      "labels": [
        "kind/bug",
        "sig/scheduling",
        "needs-triage"
      ],
      "number": 143268,
      "created_date": "2026-10-21",
      "comment_count": 4,
      "last_updated_date": "2026-10-22"
    }
  ],
  "project": "kubernetes/kubernetes",
  "project_link": "https://github.com/kubernetes/kubernetes"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"github.com/list_issues","input":{"label":"kind/bug","project":"kubernetes","max_results":3}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the 15 most recently updated open bug issues for the facebook/react repo
- list closed pull requests on tensorflow/tensorflow sorted by most commented, top 10
- Find open issues labeled good first issue in the rust-lang project
- What pull requests are still open on the vuejs/core repository? Sort them newest first.
- Give me all issues, open or closed, from the most-starred repo named django, limited to 25 results

## Input schema

```json
{
  "type": "object",
  "required": [
    "project"
  ],
  "properties": {
    "sort": {
      "enum": [
        "newest",
        "most_commented",
        "recently_updated"
      ],
      "type": "string",
      "default": "newest",
      "description": "Sort order, for example recently_updated."
    },
    "type": {
      "enum": [
        "issues",
        "pull_requests"
      ],
      "type": "string",
      "default": "issues",
      "description": "What to list, for example issues."
    },
    "label": {
      "type": "string",
      "description": "Only items with this label, for example bug."
    },
    "state": {
      "enum": [
        "open",
        "closed",
        "all"
      ],
      "type": "string",
      "default": "open",
      "description": "Which state to include, for example open."
    },
    "project": {
      "type": "string",
      "description": "Repository name, owner/name or GitHub project link, for example kubernetes or kubernetes/kubernetes."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of items to return, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "project",
    "project_link",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "number",
          "author",
          "labels",
          "state",
          "comment_count",
          "created_date",
          "last_updated_date",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "state": {
            "enum": [
              "open",
              "closed"
            ],
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "number": {
            "type": "integer"
          },
          "created_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "comment_count": {
            "type": "integer"
          },
          "last_updated_date": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "project": {
      "type": "string"
    },
    "project_link": {
      "type": "string"
    }
  }
}
```

## See more

- [GitHub API: List releases](https://fous.com/methods/github.com/list-releases.md): Lists published, non-draft releases of a public GitHub project, newest first. A bare project name matches the most-starred repository.
- [GitHub API: Search repositories](https://fous.com/methods/github.com/search-repositories.md): Finds public GitHub repositories by keywords, with an optional language filter and sort order. Returns up to 100 matches.
- [GitHub API: Get repository facts](https://fous.com/methods/github.com/get-repository.md): Looks up a public GitHub repository by name, owner/name, or link and returns its stars, forks, release, commit and contributor facts.
- [GitHub API: List trending repositories](https://fous.com/methods/github.com/list-trending-repositories.md): Lists up to 25 public repositories trending on GitHub, in page order, optionally filtered by programming language and time period.
- [SoundCloud API: List artist tracks](https://fous.com/methods/soundcloud.com/list-artist-tracks.md): Lists a SoundCloud artist's public tracks in latest or SoundCloud popular order, with profile and track details. SoundCloud's popular list may contain fewer than 100 tracks (currently at most 30).
- [Google API: Get place reviews](https://fous.com/methods/google.com/get-place-reviews.md): Finds a place on Google Maps by name and location and returns its public reviews in the chosen order.
- [Stack Overflow API: Search questions](https://fous.com/methods/stackoverflow.com/search-questions.md): Finds Stack Overflow programming questions matching plain-language search words, optionally filtered by tag and answer status, with a chosen sort order.
- [YouTube API: List channel videos](https://fous.com/methods/youtube.com/list-channel-videos.md): Lists a YouTube channel's public videos, Shorts, or live uploads, newest first or most popular first, along with channel details. Counts and dates taken from displayed text may be approximate.
- [All GitHub methods](https://fous.com/methods/github.com.md)