---
title: "List call reviews"
method: GET
path: "/call-reviews"
tags: ["Call Reviews"]
---

# List call reviews

`GET /call-reviews`

Returns a paginated list of call reviews with their per-question answers, ordered by creation date descending. Optionally filter by `createdOn` date range.

## Query parameters

- `page` integer — Page number (1-based)
- `size` integer — Number of items per page
- `startDateTime` string, date-time — Inclusive lower bound on `createdOn` (ISO 8601). Filters reviews created at or after this instant.
- `endDateTime` string, date-time — Inclusive upper bound on `createdOn` (ISO 8601). Filters reviews created at or before this instant.
- `order` 'asc' | 'desc' — Sort direction on `createdOn`. Defaults to `desc` (newest first). Use `asc` for forward-only incremental syncs.

## Response `200`

Paginated list of call reviews

- CallReviewListResponse
  - `data` CallReview[], required
    - `id` number, required — Unique identifier of the review.
    - `callId` number, required — Identifier of the call being reviewed.
    - `template` CallReviewTemplate, nullable, required
      - `id` number, required — Unique identifier of the template.
      - `title` string, nullable, required — Template title. May reference a template that has since been soft-deleted; null if the template row is missing.
    - `revieweeId` number, required — Identifier of the user being reviewed.
    - `rating` number, nullable, required — Overall review rating (weighted average of the per-question ratings, on a 0-4 scale). Null when the reviewer left every question as not-applicable.
    - `isPrivate` boolean, required — When true, the answers are only visible to the reviewer and reviewee inside Modjo. The public API exposes them regardless — treat this flag as guidance for downstream visibility rules.
    - `isAiGenerated` boolean, required — When true, the review was authored by an AI agent rather than a human reviewer.
    - `createdById` number, nullable, required — Identifier of the reviewer. Null when the review was created without a user context (e.g. AI/API pipelines).
    - `createdOn` string, nullable, required — Instant the review was created (ISO 8601).
    - `modifiedOn` string, nullable, required — Instant the review was last modified (ISO 8601).
    - `answers` CallReviewAnswer[], required — Per-question answers attached to the review.
      - `id` number, required — Unique identifier of the answer.
      - `question` CallReviewAnswerQuestion, nullable, required
        - `id` number, required — Unique identifier of the question.
        - `title` string, nullable, required — Question title. May belong to a template question that has since been soft-deleted; null if the question row is missing.
      - `weight` number, required — Position of the answer's question in the template at review time.
      - `rating` number, nullable, required — Per-question rating on a 0-4 scale, or `-1` when the reviewer marked it as not-applicable.
      - `feedback` string, nullable, required — Free-text comment the reviewer wrote for the question.
  - `pagination` object, required
    - `page` number, required — Current page number
    - `size` number, required — Items per page
    - `total` number, required — Total number of items

## Other responses

- `401` — Authentication failed. The API key is missing or invalid.
- `429` — Rate limit exceeded. Retry after the X-RateLimit-Reset interval.

---

[API](https://skmtc.dev/modjo/apis/modjo-public-api.md) · [All operations](https://skmtc.dev/modjo/apis/modjo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/modjo/modjo-public-api/revisions/dcae8b3284e8/schema)