Get reviews
1GET https://api.markprompt.com/reviews
Retrieves reviews in the given time range.
Request body
| Key | Type | Description | Default |
| from | string | The start of the range, as an ISO 8601 string. | |
| to | string | The end of the range, as an ISO 8601 string. | |
| status | "open" | "closed" | The status of the review. Omit to include all. | |
| limit | number | The maximum number of results to return. | 20 |
| page | number | The page index. | 0 |
| projectKey | string | Instead of the API token, use a project key, for instance for client-facing requests. | |
Example request
1curl "https://api.markprompt.com/reviews?from=2025-09-16T00%3A00%3A00&to=2025-09-17T00%3A00%3A00&limit=3&page=1" \
2 -X GET \
3 -H "Authorization: Bearer <TOKEN>" \
4 -H "Content-type: application/json" \
5 -H "Accept: application/json" \
6 -H "X-Markprompt-API-Version: 2024-05-21"
Response
The response is of the form:
1{
2 "object": "list",
3 "data": [
4 {
5 "id": "review-id-1",
6 "createdAt": "2025-09-16T04:02:21.000000+00:00",
7 "createdBy": "jane@acme.com",
8 "threadId": "thread-id-1",
9 "status": "open",
10 "pass": true,
11 "quality": 4,
12 "votes": {
13 "factuality": 1,
14 "tone": 1,
15 "references": -1
16 },
17 "assignees": ["jane@acme.com", "john@acme.com"],
18 "comments": [
19 {
20 "createdAt": "2025-09-16T04:02:24.000000+00:00",
21 "createdBy": "john@acme.com",
22 "comment": "It referenced an article about…"
23 }
24 ]
25 }
26 // ...
27 ]
28}