Run CCSTest

POST

/api/ccs/v1/tests/{id}/run

Processes a previously stored CCS test through the AI model and saves the results. This endpoint is typically called after creating a draft test to generate risk assessment scores and recommendations. The test must belong to the authenticated user and exist in the database before it can be run.

What happens when you run a test:

Risk score and class are calculated

Personalized recommendations are generated (localized based on optional language parameter)

Risk level is translated (e.g., 'High' in English or 'Hoch' in German)

Test results are saved

Language Support: Use the optional language query parameter to receive both clinical recommendations and risk level display text in English (en) or German (de). Defaults to English if not specified.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟢200OK

application/json

Test successfully processed and results returned. The response includes the risk score, risk classification, recommendations, and any warnings from the AI model.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.cardioexplorer.ai/api/ccs/v1/tests/9c6b148e-dc28-48ca-bde7-6db87b32142f/run?language=en' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "testId": "ccb7368d-209c-42b1-ac55-1a60c25d287a",
    "patientId": "23",
    "riskScore": 0.045910000801086426,
    "riskLevel": "Low",
    "recommendation": "Defer further cardiac testing. If clinically relevant risk factors (e.g., elevated glucose, lipids, blood pressure) are present, consider appropriate modification or treatment in line with preventive care guidelines.",
    "completedAt": "2026-02-01T19:10:10.7066667",
    "warnings": [],
    "expectedPrevalence": 0.14
}

Modified at 2026-04-09 11:40:41

Generate draft test

Get CCSTest result