MySimpleReport API Integration Guide

Request Body Fields

Code Examples — Option A: upload a file directly

curl -X POST https://dev.mysimplereport.com/v1/analyze-file \
  -H "Authorization: Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4" \
  -F "file=@/path/to/blood-test.pdf" \
  -F "purpose=lab_report"

import requests

url = "https://dev.mysimplereport.com/v1/analyze-file"
headers = {"Authorization": "Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4"}

with open("blood-test.pdf", "rb") as f:
    response = requests.post(
        url,
        headers=headers,
        files={"file": ("blood-test.pdf", f, "application/pdf")},
        data={"purpose": "lab_report"},
    )

result = response.json()
print(response.status_code)
print(result["analysis"]["title"])
print(result["analysis"]["simple_explanation"])

import fs from "node:fs";

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("blood-test.pdf")]), "blood-test.pdf");
form.append("purpose", "lab_report");

const response = await fetch("https://dev.mysimplereport.com/v1/analyze-file", {
  method: "POST",
  headers: { "Authorization": "Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4" },
  body: form
});

const result = await response.json();
console.log(response.status);
console.log(result.analysis.title);
console.log(result.analysis.simple_explanation);

using System.Net.Http.Headers;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4");

using var form = new MultipartFormDataContent();
using var stream = File.OpenRead("blood-test.pdf");

var fileContent = new StreamContent(stream);
fileContent.Headers.ContentType = new MediaTypeHeaderValue("application/pdf");
form.Add(fileContent, "file", "blood-test.pdf");
form.Add(new StringContent("lab_report"), "purpose");

var response = await client.PostAsync("https://dev.mysimplereport.com/v1/analyze-file", form);
var json = await response.Content.ReadAsStringAsync();

Console.WriteLine((int)response.StatusCode);
Console.WriteLine(json);

<?php
$ch = curl_init("https://dev.mysimplereport.com/v1/analyze-file");

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    "file"    => new CURLFile("blood-test.pdf", "application/pdf"),
    "purpose" => "lab_report",
]);

$response = curl_exec($ch);
$status   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $status . PHP_EOL;
$result = json_decode($response, true);
echo $result["analysis"]["simple_explanation"];

cURL — Option B: pass a file URL (JSON)

curl -X POST https://dev.mysimplereport.com/v1/analyze-file \
  -H "Authorization: Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "file_url": "https://yourdomain.com/files/blood-test.pdf",
    "purpose": "lab_report"
  }'

Expected Response (200 OK)

{
  "status": "success",
  "request_id": "5b5ccc65-9005-46dd-85cf-757c915bd386",
  "processed_at": "2026-07-16T15:23:18.4466629Z",
  "file_url": "https://yourdomain.com/files/blood-test.pdf",
  "purpose": "lab_report",
  "analysis": {
    "title": "Understanding Your Blood Test Results",
    "simple_explanation": "<h2>About Your Blood Work</h2><p>You recently had a blood test to check the health of your blood cells... Every single one of your blood counts is in a healthy range.</p>",
    "detailed_findings": "<h2>Detailed Findings</h2><h3>Blood Count Results</h3><ul><li><strong>Oxygen-Carrying Protein (Hemoglobin):</strong> Your result: 14.2 g/dL... within the normal range of 13.5 to 17.5 g/dL.</li></ul>",
    "important_findings_summary": "<h2>Important Findings Summary</h2><h3>Results That Need Attention</h3><p>Great news &mdash; all your results are within healthy ranges.</p>",
    "glossary": "<h2>Medical Terms Explained</h2><ul><li><strong>Hemoglobin:</strong> The protein in red blood cells that carries oxygen through your body.</li></ul>",
    "summary_cards": [
      { "label": "Oxygen-Carrying Protein (Hemoglobin)", "value": "14.2", "unit": "g/dL", "status": "normal", "note": "Healthy range: 13.5–17.5" },
      { "label": "White Blood Cell Count (WBC)", "value": "8200", "unit": "/mcL", "status": "normal", "note": "Healthy range: 4500–11000" },
      { "label": "Clotting Cells (Platelets)", "value": "225000", "unit": "/mcL", "status": "normal", "note": "Healthy range: 150000–450000" }
    ],
    "ask_your_doctor": [
      "Since my blood counts are all healthy, is there anything specific I should keep doing to maintain this good health?",
      "How often should I have these blood tests repeated as part of my general check-ups?"
    ]
  },
  "usage": {
    "documents_analyzed": 1,
    "credits_used": 1,
    "credits_remaining": null
  }
}

Important: simple_explanation, detailed_findings, important_findings_summary and glossary contain ready-to-render HTML (<h2>, <p>, <ul>, <strong>) — not plain text. Inject them into your page as HTML. title, summary_cards and ask_your_doctor are plain text. credits_remaining is null when the key has no prepaid credit balance.

Supported Formats Matrix

Code Examples — Option A: upload files directly

curl -X POST https://dev.mysimplereport.com/v1/analyze-multiple-files \
  -H "Authorization: Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4" \
  -F "files=@/path/to/blood-test.pdf" \
  -F "files=@/path/to/xray.jpg" \
  -F "purpose=lab_report"

import requests

url = "https://dev.mysimplereport.com/v1/analyze-multiple-files"
headers = {"Authorization": "Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4"}

files = [
    ("files", ("blood-test.pdf", open("blood-test.pdf", "rb"), "application/pdf")),
    ("files", ("xray.jpg", open("xray.jpg", "rb"), "image/jpeg")),
]

response = requests.post(url, headers=headers, files=files, data={"purpose": "lab_report"})
result = response.json()

for item in result["results"]:
    print(item["filename"], "->", item["status"])
    if item["status"] == "success":
        print("   ", item["analysis"]["title"])

import fs from "node:fs";

const form = new FormData();
form.append("files", new Blob([fs.readFileSync("blood-test.pdf")]), "blood-test.pdf");
form.append("files", new Blob([fs.readFileSync("xray.jpg")]), "xray.jpg");
form.append("purpose", "lab_report");

const response = await fetch("https://dev.mysimplereport.com/v1/analyze-multiple-files", {
  method: "POST",
  headers: { "Authorization": "Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4" },
  body: form
});

const result = await response.json();
for (const item of result.results) {
  console.log(item.filename, "->", item.status);
  if (item.status === "success") console.log("   ", item.analysis.title);
}

using System.Net.Http.Headers;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4");

using var form = new MultipartFormDataContent();

foreach (var (path, mime) in new[] { ("blood-test.pdf", "application/pdf"), ("xray.jpg", "image/jpeg") })
{
    var bytes = await File.ReadAllBytesAsync(path);
    var part = new ByteArrayContent(bytes);
    part.Headers.ContentType = new MediaTypeHeaderValue(mime);
    form.Add(part, "files", Path.GetFileName(path));
}

form.Add(new StringContent("lab_report"), "purpose");

var response = await client.PostAsync("https://dev.mysimplereport.com/v1/analyze-multiple-files", form);
Console.WriteLine(await response.Content.ReadAsStringAsync());

<?php
$ch = curl_init("https://dev.mysimplereport.com/v1/analyze-multiple-files");

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    "files[0]" => new CURLFile("blood-test.pdf", "application/pdf"),
    "files[1]" => new CURLFile("xray.jpg", "image/jpeg"),
    "purpose"  => "lab_report",
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
foreach ($result["results"] as $item) {
    echo $item["filename"] . " -> " . $item["status"] . PHP_EOL;
}

cURL — Option B: pass file URLs (JSON)

curl -X POST https://dev.mysimplereport.com/v1/analyze-multiple-files \
  -H "Authorization: Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "file_urls": [
      "https://yourdomain.com/files/blood-test.pdf",
      "https://yourdomain.com/files/xray.jpg"
    ],
    "purpose": "lab_report"
  }'

Expected Response (200 OK)

{
  "status": "success",
  "request_id": "z9y8x7w6-v5u4-t3s2-r1q0-p9o8n7m6l5k4",
  "processed_at": "2026-07-16T11:00:09Z",
  "total_files": 2,
  "purpose": "lab_report",
  "results": [
    {
      "file_url": "https://yourdomain.com/files/blood-test.pdf",
      "filename": "blood-test.pdf",
      "status": "success",
      "error": null,
      "analysis": {
        "title": "Understanding Your Blood Test Results",
        "simple_explanation": "<h2>About Your Blood Work</h2><p>Every single one of your blood counts is in a healthy range.</p>",
        "detailed_findings": "<h2>Detailed Findings</h2><ul><li><strong>Hemoglobin:</strong> 14.2 g/dL — within the normal range.</li></ul>",
        "important_findings_summary": "<h2>Important Findings Summary</h2><p>All results are within healthy ranges.</p>",
        "glossary": "<h2>Medical Terms Explained</h2><ul><li><strong>Hemoglobin:</strong> Carries oxygen through your body.</li></ul>",
        "summary_cards": [
          { "label": "Hemoglobin", "value": "14.2", "unit": "g/dL", "status": "normal", "note": "Healthy range: 13.5–17.5" }
        ],
        "ask_your_doctor": [ "How often should I repeat these blood tests?" ]
      }
    },
    {
      "file_url": "https://yourdomain.com/files/xray.jpg",
      "filename": "xray.jpg",
      "status": "error",
      "error": "The provided content could not be analyzed.",
      "analysis": null
    }
  ],
  "usage": {
    "documents_analyzed": 1,
    "credits_used": 1,
    "credits_remaining": null
  }
}

Billing — one request, one report: all files in a single call are treated as pages/images of one medical report, so the request costs 1 report no matter how many files you attach. Note the example above sends 2 files yet reports "documents_analyzed": 1. Batching the pages of one report is therefore cheaper than sending them as separate requests. A request where every file fails bills 0 and returns 422.

Per-file results: each file is still analyzed independently — the example shows one success and one failure. A failed file returns "status": "error", an error message and "analysis": null, while the others still succeed. The HTML-content note from 3.1 applies to each item's analysis block.

Code Examples

curl -X POST https://dev.mysimplereport.com/v1/analyze-text \
  -H "Authorization: Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "text": "Hemoglobin 14.2 g/dL, WBC 8200/mcL, Platelets 225000/mcL. All within normal limits.",
    "purpose": "lab_report"
  }'

import requests

response = requests.post(
    "https://dev.mysimplereport.com/v1/analyze-text",
    headers={
        "Authorization": "Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4",
        "Content-Type": "application/json",
    },
    json={
        "text": "Hemoglobin 14.2 g/dL, WBC 8200/mcL, Platelets 225000/mcL. All within normal limits.",
        "purpose": "lab_report",
    },
)

result = response.json()
print(result["analysis"]["title"])
print(result["analysis"]["simple_explanation"])

const response = await fetch("https://dev.mysimplereport.com/v1/analyze-text", {
  method: "POST",
  headers: {
    "Authorization": "Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "Hemoglobin 14.2 g/dL, WBC 8200/mcL, Platelets 225000/mcL. All within normal limits.",
    purpose: "lab_report"
  })
});

const result = await response.json();
console.log(result.analysis.title);
console.log(result.analysis.simple_explanation);

using System.Text;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4");

var payload = new
{
    text = "Hemoglobin 14.2 g/dL, WBC 8200/mcL, Platelets 225000/mcL. All within normal limits.",
    purpose = "lab_report"
};

var content = new StringContent(JsonSerializer.Serialize(payload), Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://dev.mysimplereport.com/v1/analyze-text", content);

Console.WriteLine(await response.Content.ReadAsStringAsync());

<?php
$ch = curl_init("https://dev.mysimplereport.com/v1/analyze-text");

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer msr_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "text"    => "Hemoglobin 14.2 g/dL, WBC 8200/mcL, Platelets 225000/mcL.",
    "purpose" => "lab_report",
]));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo $result["analysis"]["simple_explanation"];

Expected Response (200 OK)

{
  "status": "success",
  "request_id": "5b5ccc65-9005-46dd-85cf-757c915bd386",
  "processed_at": "2026-07-16T15:23:18.4466629Z",
  "file_url": null,
  "purpose": "lab_report",
  "analysis": {
    "title": "Understanding Your Blood Test Results",
    "simple_explanation": "<h2>About Your Blood Work</h2><p>You recently had a blood test to check the health of your blood cells... Every single one of your blood counts is in a healthy range.</p>",
    "detailed_findings": "<h2>Detailed Findings</h2><h3>Blood Count Results</h3><ul><li><strong>White Blood Cell Count (WBC):</strong> Your result: 8200/mcL... within the normal range of 4500 to 11000/mcL.</li></ul>",
    "important_findings_summary": "<h2>Important Findings Summary</h2><h3>Results That Need Attention</h3><p>Great news &mdash; all your results are within healthy ranges.</p>",
    "glossary": "<h2>Medical Terms Explained</h2><ul><li><strong>WBC:</strong> Stands for White Blood Cells, your body's defense team against germs.</li></ul>",
    "summary_cards": [
      { "label": "Oxygen-Carrying Protein (Hemoglobin)", "value": "14.2", "unit": "g/dL", "status": "normal", "note": "Healthy range: 13.5–17.5" },
      { "label": "White Blood Cell Count (WBC)", "value": "8200", "unit": "/mcL", "status": "normal", "note": "Healthy range: 4500–11000" }
    ],
    "ask_your_doctor": [
      "Since my blood counts are all healthy, is there anything specific I should keep doing to maintain this good health?",
      "How often should I have these blood tests repeated as part of my general check-ups?"
    ]
  },
  "usage": {
    "documents_analyzed": 1,
    "credits_used": 1,
    "credits_remaining": null
  }
}

Live response: this is a real, unedited response shape from the API. file_url is always null for text analysis. The HTML-content note from 3.1 applies here too.