---
title: "Get PR suggestions (CLI) via GET"
method: GET
path: "/pull-requests/cli/suggestions"
tags: ["Pull Requests"]
---

# Get PR suggestions (CLI) via GET

`GET /pull-requests/cli/suggestions`

Returns suggestions for a PR via CLI key. `format=markdown` returns `{ markdown }`.

## Query parameters

- `prUrl` string, required
- `repositoryId` string, required
- `prNumber` string, required
- `format` string, required
- `severity` string, required
- `category` string, required

## Headers

- `x-team-key` string, required
- `authorization` string, required

## Response `200`

- PullRequestSuggestionsResponseDto
  - `statusCode` number, required
  - `type` string, required
  - `data` PullRequestSuggestionsPayloadDto, required
    - `prNumber` number, required
    - `repositoryId` string, required
    - `repositoryFullName` string
    - `suggestions` PullRequestSuggestionsGroupDto, required
      - `files` PullRequestSuggestionDto[], required
        - `id` string
        - `suggestionContent` string
        - `oneSentenceSummary` string
        - `label` string
        - `severity` string
        - `deliveryStatus` string
        - `relevantLinesStart` number
        - `relevantLinesEnd` number
        - `existingCode` string
        - `improvedCode` string
        - `filePath` string
        - `createdAt` string
        - `updatedAt` string
        - `comment` PullRequestSuggestionCommentDto
          - `id` object, required
          - `pullRequestReviewId` object, required
      - `prLevel` PullRequestSuggestionDto[], required
        - `id` string
        - `suggestionContent` string
        - `oneSentenceSummary` string
        - `label` string
        - `severity` string
        - `deliveryStatus` string
        - `relevantLinesStart` number
        - `relevantLinesEnd` number
        - `existingCode` string
        - `improvedCode` string
        - `filePath` string
        - `createdAt` string
        - `updatedAt` string
        - `comment` PullRequestSuggestionCommentDto
          - `id` object, required
          - `pullRequestReviewId` object, required

## Other responses

- `400` — Validation error
- `401` — Not authenticated
- `403` — Insufficient permissions
- `500` — Unexpected error

---

[API](https://skmtc.net/kodustech/apis/kodus-api.md) · [All operations](https://skmtc.net/kodustech/apis/kodus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kodustech/kodus-api/revisions/e2282ac5fb3a/schema)