Current path
Use polling
Poll the review-run URL returned by `POST /v1/review-runs`. When the run reaches `completed`, fetch the claims, verification results, and claim report.
| Step | Endpoint | Stop condition |
|---|---|---|
Create review run | POST /v1/review-runs | Store `review_run_id`, `polling_url`, and `request_id`. |
Poll status | GET /v1/review-runs/{reviewRunId} | Stop when status is `completed`, `failed`, or `cancelled`. |
Fetch artifacts | GET claims, verification results, and claim report endpoints | Use the claim report for reviewer-facing findings. |
Polling example
Poll review run
curl -sS "$KIVO_API_BASE_URL/v1/review-runs/$REVIEW_RUN_ID" \
-H "Authorization: Bearer $KIVO_API_KEY"