API Documentation

Integrate MySimpleReport into your healthcare platform with our powerful REST API. Analyze medical reports at scale with enterprise-grade reliability.

Quick Start

1. Get API Key

Sign up for a developer account and generate your API key from the dashboard.

2. Make Request

Send a POST request with your medical report data to our analysis endpoint.

3. Get Results

Receive a plain-language summary within seconds, ready to display to your users.

Example Request

cURL 
curl -X POST https://api.mysimplereport.com/v1/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "report_type": "blood_work",
    "file_url": "https://example.com/report.pdf",
    "language": "en"
  }'

API Features

Fast Processing

Get analysis results in under 3 seconds with 99.9% uptime SLA.

HIPAA Compliant

Enterprise-grade security with end-to-end encryption and SOC 2 certification.

Multi-Language

Support for 5+ languages with automatic language detection.

RESTful Design

Clean, predictable API design following REST best practices.

Webhooks

Real-time notifications for long-running analysis operations.

Comprehensive Docs

Interactive API documentation with code examples in multiple languages.

Main Endpoints

POST /v1/analyze

Analyze a medical report and get plain-language summary

Parameters:
report_type string required

Type of report (blood_work, mri, xray, etc.)

file_url string

URL to report file (PDF, JPG, PNG)

file_data base64

Base64 encoded file data

language string

Output language (en, es, fr, zh, ar)

GET /v1/reports/:id

Retrieve analysis results for a specific report

Parameters:
id string required

Report ID from analysis request

GET /v1/reports

List all analyzed reports with pagination

Parameters:
page integer

Page number (default: 1)

limit integer

Results per page (default: 20, max: 100)

report_type string

Filter by report type

DELETE /v1/reports/:id

Delete a report and its analysis

Parameters:
id string required

Report ID to delete

Response Example

Success Response (200)

JSON 
{
  "id": "rep_abc123xyz",
  "status": "completed",
  "report_type": "blood_work",
  "created_at": "2026-03-06T10:30:00Z",
  "summary": {
    "overview": "Your blood test shows how healthy your blood cells are...",
    "key_findings": [
      {
        "test": "Red Blood Cells",
        "value": "4.8 million/mcL",
        "status": "normal",
        "explanation": "This shows you have a healthy number of red blood cells..."
      },
      {
        "test": "White Blood Cells",
        "value": "7,200/mcL",
        "status": "normal",
        "explanation": "Your white blood cell count is in the normal range..."
      }
    ],
    "questions_for_doctor": [
      "Are there any lifestyle changes I should make?",
      "When should I get retested?",
      "Do these results indicate any concerns?"
    ]
  },
  "language": "en"
}

Authentication

The MySimpleReport API uses Bearer token authentication. Include your API key in the Authorization header of every request:

Authorization: Bearer YOUR_API_KEY

Important: Keep your API key secure. Never expose it in client-side code or public repositories. All API requests must be made over HTTPS.

Need Help?

Our developer support team is help you integrate MySimpleReport.

Contact API Support