Skip to main content
GET
/
v1
/
review-projects
List review projects
curl --request GET \
  --url https://api.coval.dev/v1/review-projects \
  --header 'X-API-Key: <api-key>'
{
  "review_projects": [
    {
      "name": "review-projects/01HXYZ1234567890ABCDEF",
      "id": "01HXYZ1234567890ABCDEF",
      "display_name": "Q1 Voice Agent Review",
      "description": "Review project for Q1 evaluations",
      "assignees": [
        "alice@company.com",
        "bob@company.com"
      ],
      "linked_simulation_ids": [
        "sim-output-001",
        "sim-output-002"
      ],
      "linked_metric_ids": [
        "metric-accuracy",
        "metric-latency"
      ],
      "project_type": "PROJECT_INDIVIDUAL",
      "notifications": true,
      "create_time": "2026-01-10T08:00:00Z",
      "update_time": "2026-01-15T14:30:00Z"
    }
  ],
  "next_page_token": null
}

Authorizations

​
X-API-Key
string
header
required

Organization API key for authentication

Query Parameters

​
page_size
integer
default:50

Maximum number of results per page

Required range: 1 <= x <= 100
​
page_token
string

Opaque pagination token from previous response

​
order_by
string

Sort field and direction. Prefix with - for descending. Valid fields: create_time, update_time, display_name.

Example:

"-create_time"

Response

Projects retrieved successfully

​
review_projects
object[]
required
​
next_page_token
string | null

Opaque token for fetching the next page