List Reviews

List Reviews

curl --request GET \
  --url https://api.example.com/api/v1/reviews

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/reviews",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/reviews"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/reviews")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "[]": [
    {}
  ],
  "[].id": 123,
  "[].event_type": "<string>",
  "[].source": "<string>",
  "[].status": "<string>",
  "[].pr_status": "<string>",
  "[].created_at": {},
  "[].processed_at": {},
  "[].pr_title": "<string>",
  "[].pr_number": 123,
  "[].repo_name": "<string>",
  "[].branch": "<string>",
  "[].author": "<string>",
  "[].pr_url": "<string>",
  "[].ai_summary": "<string>",
  "[].files_analyzed": 123
}

GET

api

reviews

List Reviews

curl --request GET \
  --url https://api.example.com/api/v1/reviews

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/reviews",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/reviews"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/reviews")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "[]": [
    {}
  ],
  "[].id": 123,
  "[].event_type": "<string>",
  "[].source": "<string>",
  "[].status": "<string>",
  "[].pr_status": "<string>",
  "[].created_at": {},
  "[].processed_at": {},
  "[].pr_title": "<string>",
  "[].pr_number": 123,
  "[].repo_name": "<string>",
  "[].branch": "<string>",
  "[].author": "<string>",
  "[].pr_url": "<string>",
  "[].ai_summary": "<string>",
  "[].files_analyzed": 123
}

Overview

Retrieve a paginated list of PR reviews processed by Nectr AI. This endpoint deduplicates reviews by PR number and repository, returning the most recent event with the highest priority status for each unique PR.

Authentication

Requires a valid JWT token in the Authorization header:

Authorization: Bearer YOUR_JWT_TOKEN

Query Parameters

integer

default:"20"

Maximum number of reviews to return (1-100)

string

Filter by event status or PR status. Valid values:

Event status: pending, processing, completed, failed
PR status: open, merged, closed

string

Search reviews by PR title, repository name, or PR number

Response

Returns an array of review objects, deduplicated by unique PR.

array

Array of review objects

integer

Event ID

string

Type of event (e.g., “pull_request”)

string

Event source (e.g., “github”)

string

Processing status: pending, processing, completed, or failed

string

Live PR status from GitHub: open, merged, or closed

datetime

Timestamp when the event was created

datetime

Timestamp when the event was processed (null if pending)

string

Pull request title

integer

Pull request number

string

Repository full name (owner/repo)

string

Source branch name

string

GitHub username of the PR author

string

Direct URL to the pull request on GitHub

string

AI-generated review summary (available when status is completed)

integer

Number of files analyzed by the AI reviewer

Example Request

curl -X GET "https://api.nectr.ai/api/v1/reviews?limit=10&status=completed" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

import requests

response = requests.get(
    "https://api.nectr.ai/api/v1/reviews",
    headers={"Authorization": f"Bearer {token}"},
    params={
        "limit": 10,
        "status": "completed"
    }
)

reviews = response.json()

const response = await fetch(
  'https://api.nectr.ai/api/v1/reviews?limit=10&status=completed',
  {
    headers: {
      'Authorization': `Bearer ${token}`
    }
  }
);

const reviews = await response.json();

Example Response

[
  {
    "id": 1234,
    "event_type": "pull_request",
    "source": "github",
    "status": "completed",
    "pr_status": "open",
    "created_at": "2026-03-10T14:30:00Z",
    "processed_at": "2026-03-10T14:32:15Z",
    "pr_title": "Add user authentication endpoints",
    "pr_number": 42,
    "repo_name": "acme/api-server",
    "branch": "feature/auth",
    "author": "johndoe",
    "pr_url": "https://github.com/acme/api-server/pull/42",
    "ai_summary": "APPROVE\n\nConfidence: 4/5\n\nThis PR implements secure authentication...",
    "files_analyzed": 8
  },
  {
    "id": 1230,
    "event_type": "pull_request",
    "source": "github",
    "status": "completed",
    "pr_status": "merged",
    "created_at": "2026-03-09T10:15:00Z",
    "processed_at": "2026-03-09T10:17:45Z",
    "pr_title": "Fix database connection pooling",
    "pr_number": 41,
    "repo_name": "acme/api-server",
    "branch": "bugfix/db-pool",
    "author": "janedoe",
    "pr_url": "https://github.com/acme/api-server/pull/41",
    "ai_summary": "APPROVE\n\nConfidence: 5/5\n\n🟢 **Minor Suggestion**: Consider adding...",
    "files_analyzed": 3
  }
]

Filtering Examples

Filter by Event Status

Get all reviews that are currently being processed:

GET /api/v1/reviews?status=processing

Filter by PR Status

Get all reviews for merged PRs:

GET /api/v1/reviews?status=merged

Search Reviews

Search for reviews containing “authentication” in title or repo name:

GET /api/v1/reviews?search=authentication

Search for a specific PR number:

GET /api/v1/reviews?search=42

Notes

Reviews are deduplicated by unique PR (repo + PR number). If multiple events exist for the same PR, the endpoint returns the event with the highest priority status
Status priority (highest to lowest): completed > failed > processing > pending
The pr_status field is fetched live from GitHub API for accuracy
If GitHub API fetch fails, pr_status falls back to the last known state from the webhook payload
The search parameter matches against PR title, repo name, and PR number (case-insensitive)

Rescan Repository

Get Review Details

⌘I

Authentication

Repositories

Reviews

Events

Analytics

Memory

Webhooks

MCP Server

Overview

Authentication

Query Parameters

Response

Example Request

Example Response

Filtering Examples

Filter by Event Status

Filter by PR Status

Search Reviews

Notes

​Overview

​Authentication

​Query Parameters

​Response

​Example Request

​Example Response

​Filtering Examples

​Filter by Event Status

​Filter by PR Status

​Search Reviews

​Notes

Overview

Authentication

Query Parameters

Response

Example Request

Example Response

Filtering Examples

Filter by Event Status

Filter by PR Status

Search Reviews

Notes