List issues

Issues on a repository, newest first.

GET/repos/{owner}/{name}/issues

An issue is something that should change: a bug, a feature, a question. Pull requests are made against it.

Returns at most 100 issues, newest first. comment_count counts comments, not events such as “opened #14 for this”.

Authentication: Optional. Public data can be read without a token; send one to see what is private.
MCP tool: issue with action list, and the same inputs
Scope: An access token needs issues:read.

Path parameters

Name	Type	Required	Description
`owner`	string	Yes	The workspace that owns the repository.
`name`	string	Yes	The repository’s name.

Query parameters

Name	Type	Required	Description
`state`	string	No	One of `open`, `closed`.
`label`	string	No	Only issues carrying this label.

Example request

curl "https://api.g1t.sh/repos/flagon-io/hello/issues?state=open&label=feature" \
  -H "Authorization: Bearer $G1T_TOKEN"

Example response

A successful request answers 200 with:

[
  {
    "id": "iss_01m43shrzpfe49x74ga7sj1c6v",
    "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
    "number": 12,
    "title": "Greeting should name the caller",
    "body": "Take a name from the first argument; fall back to world.",
    "labels": [
      "feature"
    ],
    "checks": [
      "cargo test"
    ],
    "state": "open",
    "reason": null,
    "resolved_by": null,
    "author": {
      "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
      "username": "syntaqx",
      "kind": "user",
      "verified": false,
      "workspaces": []
    },
    "created_at": "2026-10-01T18:04:11.482Z",
    "updated_at": "2026-10-01T18:04:11.482Z",
    "closed_at": null,
    "pull_count": 1,
    "comment_count": 0,
    "assignees": [],
    "blocked_by": [],
    "queued": false,
    "agent": "claude-code"
  }
]

Errors

A failed request answers with one of these statuses and a body like {"error": {"code": "not_found", "message": "Repository not found."}}. See errors.

Status	Code	When
401	`unauthenticated`	A token is required, or the one sent is not valid.
403	`forbidden`	The token is valid but not allowed to do this, such as a member-only change or an agent token outside its repository.
404	`not_found`	It does not exist, or you cannot see it.
422	`invalid`	The input is not valid. `message` says which field and why.