Skip to main content
GET
/
repos
/
{repo_id}
/
reviews
List reviews
curl --request GET \
  --url https://api.diversion.dev/v0/repos/{repo_id}/reviews \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "<string>",
      "title": "<string>",
      "author": {
        "id": "<string>",
        "image": "<string>",
        "email": "jsmith@example.com",
        "full_name": "<string>",
        "name": "<string>"
      },
      "created_at": 123,
      "updated_at": 123,
      "base_ref": "<string>",
      "compare_ref": "<string>",
      "repo_id": "<string>",
      "description": "<string>",
      "reviewers": [
        {
          "id": "<string>",
          "image": "<string>",
          "email": "jsmith@example.com",
          "full_name": "<string>",
          "name": "<string>"
        }
      ],
      "reviewer_statuses": [
        {
          "user_id": "<string>",
          "updated_at": 123
        }
      ],
      "merge_commit_id": 123,
      "active_merge_id": "<string>",
      "draft_commit_id": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

This API uses OAuth 2 with the implicit grant flow

Path Parameters

​
repo_id
string
required

The repo ID of the repository. Repo name can be used instead of the ID, but usage of ID for permanent linking and API requests is preferred.

Required string length: 3 - 128
Example:

"example_id"

Query Parameters

​
status
enum<string>

Filter by review status

Available options:
open,
closed
​
author_id
string

Filter by author ID

Maximum string length: 256
​
search
string

Search reviews by title or description

Maximum string length: 256

Response

Reviews returned

​
items
object[]