Skip to main content
GET
/
api
/
v1
/
test-suites
/
{id}
Get Test Suite
curl --request GET \
  --url https://api.example.com/api/v1/test-suites/{id}
Get detailed information about a specific test suite including the full list of scenario IDs.

Request

GET /api/v1/test-suites/{id}
Authorization: Bearer YOUR_API_KEY

Path Parameters

ParameterTypeRequiredDescription
idstringYesUUID of the test suite

Response

FieldTypeDescription
idstringTest suite UUID
namestringDisplay name
descriptionstringDescription (or null)
scenario_idsarrayArray of scenario UUIDs
scenario_countnumberNumber of scenarios in the suite
created_atstringISO-8601 creation timestamp
updated_atstringISO-8601 last update timestamp

Examples

curl "https://app.preclinical.dev/api/v1/test-suites/6ba7b810-9dad-11d1-80b4-00c04fd430c8" \
  -H "Authorization: Bearer $API_KEY"

Success Response

{
  "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "name": "Emergency Triage",
  "description": "Scenarios testing emergency response protocols",
  "scenario_ids": [
    "scenario-uuid-1",
    "scenario-uuid-2",
    "scenario-uuid-3"
  ],
  "scenario_count": 3,
  "created_at": "2026-01-15T08:00:00Z",
  "updated_at": "2026-01-28T12:30:00Z"
}

Errors

CodeDescription
NOT_FOUNDTest suite not found