Documentation pages
GET/reviews

Key permission: reviews:read

List reviews

Retrieve your organization's review jobs with cursor-based pagination.

What to send · optional query parameters

limitinteger · default 25Optional
Number of reviews per page, from 1 to 100.
statusstringOptional
Optional filter using one of the job statuses on the Check status page.
cursorstringOptional
Pass page.nextCursor from the previous response unchanged. Stop when page.hasMore is false.

What you get back

data contains review jobs, not their full findings. page.hasMore tells you whether another page exists; pass page.nextCursor as the next request's cursor.

For a catalog, create one review per resource. Store your own resource ID and version alongside each returned review ID. The API does not accept a ZIP or a list of files in one review request.

Request example
curl --fail-with-body -X GET 'https://www.steletta.com/api/v1/reviews?limit=25&status=completed' \
  -H "Authorization: Bearer $STELETTA_API_KEY"
Example response · One-page response (excerpt)
{
  "data": [
    {
      "id": "rev_example",
      "status": "completed",
      "createdAt": "2026-09-29T14:00:00Z",
      "completedAt": "2026-09-29T14:02:00Z",
      "usage": {
        "estimatedUnitsMilli": 1000,
        "finalUnitsMilli": 1000
      },
      "error": null
    }
  ],
  "page": {
    "nextCursor": null,
    "hasMore": false
  }
}