Skip to main content

ECG Long-term Analysis API

Long-term ECG analysis (Holter) supports continuous ECG data analysis from 24 hours up to (and beyond) several days, and provides professional long-term ECG reports.

Asynchronous processing

Long-term analysis uses an asynchronous flow. After you submit a task, you can retrieve results via polling and/or Webhook callbacks. Task duration depends on data volume and analysis depth.

Analysis workflow​

Endpoint list​

EndpointMethodDescription
/api/v1/advanced/ecg/holter/upload-urlPOSTGet file upload credential
/api/v1/advanced/ecg/holter/submitPOSTSubmit long-term analysis task
/api/v1/advanced/ecg/holter/status/:task_idGETQuery task status
/api/v1/advanced/ecg/holter/result/:task_idGETGet analysis result
/api/v1/advanced/ecg/holter/report/:task_idGETDownload PDF report
/api/v1/advanced/ecg/holter/cancel/:task_idPOSTCancel analysis task

Step 1: Get upload credential​

POST /api/v1/advanced/ecg/holter/upload-url​

Obtain a pre-signed URL for secure upload of large files.

Step 2: Submit analysis task​

POST /api/v1/advanced/ecg/holter/submit​

After uploading is complete, submit the analysis request using the task_id.

Step 3: Query task status​

GET /api/v1/advanced/ecg/holter/status/:task_id​

Check the current status of your analysis task.

Step 4: Get analysis results​

GET /api/v1/advanced/ecg/holter/result/:task_id​

Retrieve the structured analysis output.

Step 5: Download PDF report​

GET /api/v1/advanced/ecg/holter/report/:task_id​

Download the generated PDF report.

Webhook callback​

If you provide a callback_url, AIECG can notify you when the task progresses or finishes.

Supported data formats​

The endpoint supports ECG file formats such as:

  • aiecg
  • edf
  • mit
  • csv

Code examples​

You can follow the original request examples in the Chinese documentation for:

  • Upload URL retrieval
  • Task submission
  • Polling status
  • Downloading report PDF

Pricing​

Long-term ECG analysis typically belongs to the Advanced tier pricing model. Please refer to the Service & Pricing page for current details.