GuidesAPI References
GuidesAPI References
  1. Manage tests
  • Authentication
    • Obtain access token
      POST
    • Generate magic link
      POST
  • Manage tests
    • Generate draft test
      POST
    • Run CCSTest
      POST
    • Get CCSTest result
      GET
  • Schemas
    • TestResponse
    • PatientReport
    • ApiResponse
GuidesAPI References
GuidesAPI References
  1. Manage tests

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
Test results are saved

Request

Path Params

Header 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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.cardioexplorer.ai/api/ccs/v1/tests/3fa85f64-5717-4562-b3fc-2c963f66afa6/run' \
--header 'Authorization: Bearer {{token}}'
Response 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": []
}
Modified at 2026-02-02 19:27:02
Previous
Generate draft test
Next
Get CCSTest result
Built with