CoderHelm Docs
APIReviews

Get a review

GET
/api/reviewer/review

Returns one review in full: the whole body, the structured findings with file, line, severity and what each rests on, and the team's ratings.

Authorization

api_key view
headerAuthorizationBearer <token>

A team API key, made by an admin under Settings, API keys. Send it as Authorization: Bearer chk_....

Scope: view

Query Parameters

sk*string

The review's sk, from a list of reviews.

Response Body

The review.

application/json
  1. response

A pull request review by CoderHelm's reviewer.

action_summary*string

What the reviewer did besides reviewing, such as arming auto-merge.

Example"Requested changes; auto-merge stays off until they are fixed."
applied_standards*array<string>

The team standards the review was given in full ("always apply").

Example
[  "api-error-format"]
body*string

The review as posted, in Markdown. Cut to about 4,000 characters in a list.

Example"**Request changes.** The attempt counter is never reset after a successful login, so a user who mistypes their password nine times is locked out on their next good attempt."
created_at*string

When it was written (RFC 3339).

Example"2026-10-22T14:20:05Z"
findings?array<>|

The structured findings. Null in a list (get the review for them) and on older reviews.

Example
[  {    "blocks": false,    "body": "After a good password the counter for the IP stays where it was.",    "category": "bug",    "end_line": 44,    "evidence": "verified-defect",    "file": "src/auth/login.ts",    "line": 42,    "lookups": [],    "severity": "high",    "suggestion": "attempts.delete(ip);",    "title": "The attempt counter is never reset after a successful login"  }]
head_sha*string

The commit reviewed.

Example"9fceb02d0ae598e95dc970b74767f19372d61af8"
posted_as*string

The GitHub review event it was posted as: APPROVE, REQUEST_CHANGES or COMMENT.

Example"REQUEST_CHANGES"
pr_number*integer

The pull request number.

Formatint64
Range0 <= value
Example318
pr_title*string

The pull request's title. Empty on older reviews.

Example"Rate-limit the login form"
rating_comments*array<>

Ratings with comments.

repo*string

The repository, owner/name.

Example"acme/web"
risk*string

The risk the reviewer gave the change: LOW, MEDIUM or HIGH.

Example"MEDIUM"
sk*string

The review's key: pass it as sk to get the review.

Example"REVIEW#acme/web#318#2026-10-22T14:20:05Z"
thumbs_down*integer

Thumbs down from the team.

Formatint64
Range0 <= value
Example0
thumbs_up*integer

Thumbs up from the team.

Formatint64
Range0 <= value
Example2
trigger*string

What asked for it, such as label, rerequest, reply or sweep.

Example"label"
verdict*string

The reviewer's verdict: APPROVE or REQUEST_CHANGES.

Example"REQUEST_CHANGES"
curl -X GET 'https://api.coderhelm.com/api/reviewer/review?sk=REVIEW%23acme%2Fweb%23318%232026-10-22T14%3A20%3A05Z' \  -H "Authorization: Bearer $CODERHELM_API_KEY"
{  "action_summary": "Requested changes; auto-merge stays off until they are fixed.",  "applied_standards": [    "api-error-format"  ],  "body": "**Request changes.** The attempt counter is never reset after a successful login, so a user who mistypes their password nine times is locked out on their next good attempt.",  "created_at": "2026-10-22T14:20:05Z",  "findings": [    {      "blocks": false,      "body": "After a good password the counter for the IP stays where it was.",      "category": "bug",      "end_line": 44,      "evidence": "verified-defect",      "file": "src/auth/login.ts",      "line": 42,      "lookups": [],      "severity": "high",      "suggestion": "attempts.delete(ip);",      "title": "The attempt counter is never reset after a successful login"    }  ],  "head_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",  "posted_as": "REQUEST_CHANGES",  "pr_number": 318,  "pr_title": "Rate-limit the login form",  "rating_comments": [    {      "at": "2026-10-22T15:01:44+00:00",      "by": "octocat",      "rating": "up",      "text": "Good catch on the counter."    }  ],  "repo": "acme/web",  "risk": "MEDIUM",  "sk": "REVIEW#acme/web#318#2026-10-22T14:20:05Z",  "thumbs_down": 0,  "thumbs_up": 2,  "trigger": "label",  "verdict": "REQUEST_CHANGES"}
Edit on GitHub