Reviews
Endpoints for creating, listing, and retrieving contract reviews for the current organization.
Retrieve a review
Shows one review for the current organization (by id). Includes nested redline_evaluations, summary_positions, and flag_violations when applicable—the paginated GET /v1/organizations/{organization_id}/reviews index omits those for each item.
path Parameters
organization_idOrganization id
idReview id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Retrieve a review › Responses
A single review
Retrieve all reviews
Lists reviews for the current organization with pagination (page[number]). The default page size is 30 reviews per page.
Each list item includes core review fields, name (imported file name), and review_type. redline_evaluations, summary_positions (per-topic summaries), and flag_violations are not included here; they appear on GET /v1/organizations/{organization_id}/reviews/{id} (and on the dedicated nested collection endpoints where applicable).
path Parameters
organization_idOrganization id
query Parameters
page[number]Page number for the review list (defaults to 1 when omitted). Each page returns up to 30 reviews by default.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Retrieve all reviews › Responses
A paginated list of reviews for the organization (data, meta.pagination, and links are siblings).
Create a review
Start a new review in one of two ways: point at an import you already uploaded with a small application/json body (imported_file_id, optional playbook_id, optional review_type), or upload the contract directly with multipart/form-data using a file part (playbook_id and review_type optional there too). review_type must be RedlineReview or SummaryReview when you send it. Don't send imported_file_id on multipart—that path is only for new files. A 201 response uses the same JSON:API review resource as GET /v1/organizations/{organization_id}/reviews/{id} (full attributes, including nested evaluations or summary data when present); the create call itself is just flat JSON or multipart, not a JSON:API request document.
path Parameters
organization_idOrganization id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Create a review › Request Body
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: imported_file_id | |
| type = object · requires: file |
imported_file_id^[0-9a-fA-F]{8}-[0-9… · requiredplaybook_id^[0-9a-fA-F]{8}-[0-9…review_typeOptional; when omitted the service chooses the review mode.
Create a review › Responses
Review created; returns the new review resource
List redline evaluations for a review
Returns every redline evaluation for the given review, scoped to the current organization. This applies to redline reviews (review_type: RedlineReview); the list matches the redline_evaluations array on the review resource from GET /v1/organizations/{organization_id}/reviews/{id}.
path Parameters
organization_idOrganization id
review_idReview id (must be a redline review to contain evaluations)
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
List redline evaluations for a review › Responses
Evaluations for the review (may be an empty array while processing or if none apply)
Redline evaluations for the review (same objects as attributes.redline_evaluations on a RedlineReview resource).
Retrieve a single redline evaluation
Returns one redline evaluation by id under the given review, scoped to the current organization. The payload matches a single element of redline_evaluations on GET /v1/organizations/{organization_id}/reviews/{id}. When a counterproposal exists, attributes.counterproposal is included as a JSON:API-style object with nested data (type counterproposal, id, attributes including directive, suggested_counterproposal_text, created_at, updated_at, and status). Nested attributes.status is always completed or in_progress. When there is no counterproposal, the counterproposal key is omitted from attributes (never null).
path Parameters
organization_idOrganization id
review_idParent review id
evaluation_idRedline evaluation id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Retrieve a single redline evaluation › Responses
The requested redline evaluation
Update a redline evaluation
Updates how a single redline evaluation is classified. Send a required evaluation object (discriminated by type) and an optional top-level comment. Simple outcomes are accept, reject, manual, and needs_review (each is only type). counterpropose adds a required counterproposal: either an object { directive } (instruction text) or { new_text } (replacement copy)—exactly one of those two shapes. Applies only to the evaluation identified by evaluation_id under the given review.
path Parameters
organization_idOrganization id
review_idParent review id
evaluation_idRedline evaluation id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Update a redline evaluation › Request Body
Outcome and payload for this redline evaluation. Discriminated by type; see oneOf variants below.
commentOptional comment accompanying the evaluation update.
Update a redline evaluation › Responses
Updated redline evaluation (same JSON:API data shape as GET). When a counterproposal exists, attributes.counterproposal is a nested JSON:API document { "data": { "id", "type": "counterproposal", "attributes": { … } } }; nested attributes.status is completed or in_progress. Otherwise the counterproposal key is omitted (see GET examples).
List flag violations for a review
Returns every summary-review flag violation for the given review, scoped to the current organization. This applies to summary reviews (review_type: SummaryReview); the list matches the flag_violations array on the review resource from GET /v1/organizations/{organization_id}/reviews/{id}.
path Parameters
organization_idOrganization id
review_idReview id (must be a summary review to contain flag violations)
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
List flag violations for a review › Responses
Flag violations for the review (may be an empty array if none were detected)
Flag violations for the review (same objects as attributes.flag_violations on a SummaryReview resource).
Retrieve a single flag violation
Returns one flag violation by id under the given review, scoped to the current organization. The payload matches a single element of flag_violations on GET /v1/organizations/{organization_id}/reviews/{id}.
path Parameters
organization_idOrganization id
review_idParent review id
flag_violation_idFlag violation id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Retrieve a single flag violation › Responses
The requested flag violation
Update a flag violation
Records a user decision for a single flag violation: either exception_approved (the exception is accepted) or issue_confirmed (the issue stands). Applies only to the violation identified by flag_violation_id under the given review.
path Parameters
organization_idOrganization id
review_idParent review id
flag_violation_idFlag violation id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Update a flag violation › Request Body
decisionUser decision for this flag violation.
Update a flag violation › Responses
Updated flag violation
Download review bundle (ZIP)
Downloads a .zip archive containing the original contract, processed (redlined) document, and audit trail for a RedlineReview.
SummaryReview is not supported — this endpoint returns 422 for summary reviews. Use GET /v1/organizations/{organization_id}/reviews/{review_id}/downloads/original instead.
Example:
Code
path Parameters
organization_idOrganization id
review_idReview id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Download review bundle (ZIP) › Responses
ZIP archive (application/zip).
Download review audit document
Downloads the audit document for a RedlineReview.
SummaryReview is not supported — returns 422. Use GET /v1/organizations/{organization_id}/reviews/{review_id}/downloads/original for summary reviews.
Example:
Code
path Parameters
organization_idOrganization id
review_idReview id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Download review audit document › Responses
Audit document download (typically .docx).
Download processed (redlined) contract
Downloads the processed (redlined) contract for a RedlineReview.
SummaryReview is not supported — returns 422. Use GET /v1/organizations/{organization_id}/reviews/{review_id}/downloads/original for summary reviews.
Example:
Code
path Parameters
organization_idOrganization id
review_idReview id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Download processed (redlined) contract › Responses
Processed document (typically .docx, or application/pdf when applicable).
Download original uploaded contract
Downloads the original uploaded contract (.docx or .pdf, depending on the upload). Supported for both RedlineReview and SummaryReview — this is the only download path available for summary reviews.
Example:
Code
path Parameters
organization_idOrganization id
review_idReview id
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Download original uploaded contract › Responses
Original file: application/vnd.openxmlformats-officedocument.wordprocessingml.document (.docx) or application/pdf.