---
title: "List reviews"
method: GET
path: "/repos/{repo_id}/reviews"
tags: ["Reviews"]
---

# List reviews

`GET /repos/{repo_id}/reviews`

## Request

- Base URL: `https://api.diversion.dev/v0`
- URL: `https://api.diversion.dev/v0/repos/{repo_id}/reviews`
- Auth: OAuth 2
  - Implicit: `https://auth.diversion.dev/oauth2/authorize`
  - Scopes: `coreapi/read`
- TypeScript: <https://skmtc.dev/diversion/apis/diversion-core-api/docs/repos/:repo_id/reviews/get.ts> (a function with typed inputs; its response is checked against the schema)

List all reviews for a repository

## Query parameters

- `status` 'open' | 'closed'
- `author_id` string
- `search` string

## Response `200`

Reviews returned

- object
  - `items` Review[]
    - `id` string, required: Review ID
    - `title` string, required: Review title
    - `description` string: Review description
    - `status` 'open' | 'closed', required: Review status
    - `author` User, required: User details
      - `image` string: URL of the user image. If updating the image, could be a base64 encoded image.
      - `email` string, email
      - `full_name` string
      - `id` string, required
      - `name` string
      - `tier` 'EDUCATION' | 'INDIE' | 'PROFESSIONAL' | 'ENTERPRISE' | 'UNKNOWN': The tier of the user
    - `reviewers` User[]: List of reviewers
      - `image` string: URL of the user image. If updating the image, could be a base64 encoded image.
      - `email` string, email
      - `full_name` string
      - `id` string, required
      - `name` string
      - `tier` 'EDUCATION' | 'INDIE' | 'PROFESSIONAL' | 'ENTERPRISE' | 'UNKNOWN': The tier of the user
    - `reviewer_statuses` ReviewerStatus[]: List of reviewer statuses
      - `user_id` string, required: Reviewer user ID
      - `status` 'requested' | 'approved' | 'changes_requested' | 'rejected', required: Reviewer's status
      - `updated_at` integer, required: Unix timestamp when the reviewer status was last updated
    - `created_at` integer, required: Unix timestamp when the review was created
    - `updated_at` integer, required: Unix timestamp when the review was last updated
    - `base_ref` string, required: Base reference (branch/commit)
    - `compare_ref` string, required: Compare reference (branch/commit)
    - `repo_id` string, required: Repository ID
    - `merge_commit_id` integer: ID of the commit that merged this review
    - `active_merge_id` string: ID of active merge with conflicts
    - `draft_commit_id` string: ID of the draft commit that created this review

## Other responses

- `default`: An error occurred

---

[API](https://skmtc.dev/diversion/apis/diversion-core-api.md) - [All operations](https://skmtc.dev/diversion/apis/diversion-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/diversion/apis/diversion-core-api/revisions/38a18aba804b?raw)