
List Origin Pull Request Reviews via the API
List submitted reviews on a pull request with GET https://api.cursor.com/v1/origin/repos/{ownerSlug}/{repoName}/pulls/{pullNumber}/reviews. Official reference: Origin API → List Pull Request Reviews (OpenAPI OriginService_ListPullRequestReviews).
Origin is in Early Beta and subject to change. Authenticate with an installation access token (oit_…) or a user access token that carries repository:pull_requests:reviews:read. Availability: Early Beta per the API overview.
Reviews are ordered by submittedAt ascending. Pending (unsubmitted draft) reviews are omitted. Dismissed reviews remain in the list with dismissal set. Pull request number is a JSON string (protobuf 64-bit encoding). An unknown or unreachable pull returns 404. A 404 never distinguishes a missing pull from one your installation cannot reach.
Cost: 1 point against the principal budget (ordinary read).
Path parameters
| Param | Required | Meaning |
|---|---|---|
ownerSlug |
yes | Owning entity's unique slug |
repoName |
yes | Repo name, unique to the owner |
pullNumber |
yes | Pull request number within the repository (string on the wire) |
Query parameters
| Param | Required | Meaning |
|---|---|---|
pageSize |
no | Maximum reviews to return. Defaults to 30; maximum 100 |
pageToken |
no | Opaque cursor from a previous response's nextPageToken. Omit for the first page |
curl --request GET \
--url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME/pulls/17/reviews' \
--header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'
Response
200 returns reviews, a container pullRequest reference, and optional nextPageToken. Each review carries id (rev_…), author (user, app, or serviceAccount), verdict (approve, request_changes, or comment), body, submittedAt (RFC 3339), pullRequestVersion (number as a JSON string, headSha, baseSha, createdAt), and optional dismissal (dismissedBy, dismissedAt, message).
{
"reviews": [
{
"id": "rev_01k2ja2000e0080000000000f6",
"author": {
"user": {
"id": "user_01k2ja2000e0080000000000c3",
"email": "jane@acme.dev"
}
},
"verdict": "approve",
"body": "Approving. The telemetry schema matches the spec.",
"submittedAt": "2026-08-02T15:00:00Z",
"pullRequestVersion": {
"number": "3",
"headSha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4",
"baseSha": "3b1f9c2d8a7e6f5049c8b7a6d5e4f3a2b1c0d9e8",
"createdAt": "2026-08-01T09:30:00Z"
}
}
],
"pullRequest": {
"id": "pr_01k2ja2000e0080000000000d4",
"number": "17",
"repository": {
"id": "repo_01k2ja2000e0080000000000q4",
"name": "rocket",
"owner": {
"slug": "acme",
"id": "ns_01k2ja2000e0080000000000p3",
"type": "team"
}
}
}
}
Create, update, or dismiss a review with the matching write endpoints. Base URL: https://api.cursor.com/v1/origin.