Get a pull request

GET/repos/{owner}/{name}/pulls/{number}

An overlap with a pull request for a different issue means the two will conflict; say so, or keep clear of those files.

Field
pull.files	The files it changes, with lines added and removed.
checks	The latest run of the acceptance checks against its head, with each command’s output.
overlaps	Other pull requests in progress that change the same files.
behind	Whether the default branch has moved since it was made.
landing	Whether it is being brought up to date to land.
lifecycle	For a pull request the g1t agent is seeing through: its stage, such as working, checking, reviewing or needs_you.
comments	Comments, reviews and events, with path, line and verdict.
messages	Messages sent to the agent working on it.
statuses	Commit statuses reported for its head, such as workflow runs.
mergeable	Whether it merges cleanly into its target: clean, conflicting, checking (being worked out) or unknown. Worked out ahead of time whenever it or its target moves.
conflicts	When mergeable is conflicting, the files that conflict. Resolve them by merging the target in, or have the g1t agent do it.
earlierChecks	Earlier runs of the acceptance checks, newest first, without their output.

Checks are started by g1t, not through the API. They run when a pull request becomes ready for review and again when its head moves.

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

Path parameters

Name	Type	Required	Description
owner	string	Yes	The workspace that owns the repository.
name	string	Yes	The repository’s name.
number	integer	Yes	The number shown after the #. Issues and pull requests share one sequence.

Example request

curl https://api.g1t.sh/repos/flagon-io/hello/pulls/14 \
  -H "Authorization: Bearer $G1T_TOKEN"

Example response

A successful request answers 200 with:

{
  "pull": {
    "id": "pr_01m43smh3vexsr5pmp60qwv0vs",
    "repo_id": "rep_01m3m5q6p0e2qaw6mmjahk0qrr",
    "number": 14,
    "issue": 12,
    "title": "Greeting should name the caller",
    "body": "Reads a name from the first argument. `hello ana` prints \"Hello, ana!\".",
    "agent": "claude-code",
    "runtime": "external",
    "status": "open",
    "fork": {
      "namespace": "pulls",
      "name": "pr_01m43smh3vexsr5pmp60qwv0vs"
    },
    "fork_repo_id": "rep_01m43smh5xd7aw2kq9tv0b4c8e",
    "branch": null,
    "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
    "merge_base": null,
    "merged_by": null,
    "merged_at": null,
    "superseded_by": null,
    "check_status": "passed",
    "files": [
      {
        "path": "src/main.rs",
        "additions": 6,
        "deletions": 2
      }
    ],
    "assignees": [],
    "reviewers": [
      "ana"
    ],
    "author": {
      "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
      "username": "syntaqx",
      "kind": "user",
      "verified": false,
      "workspaces": []
    },
    "created_at": "2026-10-01T18:20:02.117Z",
    "updated_at": "2026-10-01T18:35:44.902Z",
    "confidence": null
  },
  "issue": {
    "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:20:02.117Z",
    "closed_at": null,
    "pull_count": 1,
    "comment_count": 0,
    "assignees": [],
    "blocked_by": [],
    "queued": false,
    "agent": "claude-code"
  },
  "comments": [
    {
      "id": "cmt_01m43st6d0f4h8k2n6r0v4z8c2",
      "kind": "event",
      "author": {
        "id": "usr_01kkntcg1eeb98j62xjm7eh09p",
        "username": "syntaqx",
        "kind": "user",
        "verified": false,
        "workspaces": []
      },
      "body": "marked this ready for review",
      "path": null,
      "line": null,
      "verdict": null,
      "created_at": "2026-10-01T18:33:10.420Z"
    }
  ],
  "checks": {
    "id": "chk_01m43sw8e2g6j0m4q8t2x6a0c4",
    "head_commit": "9f2c4e1a7b3d5f60812a4c6e8b0d2f4a6c8e0b13",
    "status": "passed",
    "results": [
      {
        "command": "cargo test",
        "passed": true,
        "exit_code": 0,
        "output": "test result: ok. 3 passed; 0 failed",
        "duration_ms": 18234
      }
    ],
    "error": null,
    "created_at": "2026-10-01T18:33:11.002Z",
    "finished_at": "2026-10-01T18:35:44.902Z"
  },
  "overlaps": [],
  "behind": false,
  "review_pending": false,
  "lifecycle": null,
  "landing": false,
  "stalled": null,
  "messages": [
    {
      "id": "msg_01m43tx5egeh4t3f9zcnjenqvz",
      "author": "syntaqx",
      "body": "Keep \"world\" as the default when no name is given.",
      "created_at": "2026-10-01T18:25:00.310Z",
      "delivered_at": "2026-10-01T18:25:31.007Z",
      "kind": "message",
      "from_number": null,
      "to_number": 14,
      "answer": null,
      "declined": false
    }
  ],
  "statuses": []
}

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.