Check review status

What to send

The review.id returned at submission, in the URL, plus your API-key header. No request body.

What you get back

The review job: id, status, timestamps, usage and any error. This response does not contain the scores or findings; retrieve those from the result endpoint once completed.

Status	What to do
`created` `awaiting_upload` `queued` `processing`	Still in progress. Wait for the response's `Retry-After` seconds, then poll again.
`completed`	Stop polling and fetch the result.
`failed`	Stop polling. Read `error.code` and `error.message`. No review units are charged.
`cancelled`	Stop polling. No result is produced and no review units are charged.

An automatically requeued job can include error.retryScheduled: true. Keep following its non-terminal status; don't create a duplicate job.

Request example

curl --fail-with-body -X GET 'https://www.steletta.com/api/v1/reviews/rev_example' \
  -H "Authorization: Bearer $STELETTA_API_KEY"

Example response · Review job (excerpt)

{
  "id": "rev_example",
  "status": "queued",
  "createdAt": "2026-09-29T14:00:00Z",
  "completedAt": null,
  "usage": {
    "estimatedUnitsMilli": 1000,
    "finalUnitsMilli": null
  },
  "error": null
}