EOB Parser API

Extract structured data from EOBs with a single POST request. Built for medical billers, practice managers, and patient advocates who want to automate, not click. Upload a file as multipart form data and receive JSON.

Quick start

cURL

curl -X POST https://eobextractor.com/api/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@eob.pdf"

Python

import requests

with open("eob.pdf", "rb") as source:
    response = requests.post(
        "https://eobextractor.com/api/extract",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        files={"file": source},
        timeout=120,
    )
response.raise_for_status()
result = response.json()
if not result.get("success"):
    raise RuntimeError(result.get("error", "Extraction failed"))
if result.get("needsReview") or result.get("ocrWarning"):
    print("Review required:", result.get("needsReview"), result.get("ocrWarning"))
print(result["data"])  # Validate required fields before using them.

Node.js

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("eob.pdf")]), "eob.pdf");
const response = await fetch("https://eobextractor.com/api/extract", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
  body: form,
  signal: AbortSignal.timeout(120000),
});
if (!response.ok) throw new Error(`Extraction HTTP ${response.status}`);
const result = await response.json();
if (!result.success) throw new Error(result.error || "Extraction failed");
if (result.needsReview?.length || result.ocrWarning) {
  console.warn("Review required:", result.needsReview, result.ocrWarning);
}
console.log(result.data); // Validate required fields before using them.

The snippets use Python with requests or Node.js 20+ in an ES module. They surface errors and review flags; they do not automatically approve data. Keep API keys on your server, and do not blindly retry a timed-out extraction. Use the document-specific example and review checklist.

Fields returned

Per-document pricing

No per-page billing. No enterprise minimums.

Confidence signals

Returned configured fields include confidence values to help prioritize review.

Batch & async

Submit many EOBs and poll for results.

FAQ

Is there a EOB parsing API?

Yes. EOB Extractor exposes a REST endpoint — POST a EOB file to /api/extract with your API key and receive structured JSON. No SDK required; it is a standard multipart upload.

How is the EOB API priced?

By document, not per page. Free includes 3 EOBs; paid plans run from $9/mo (20 docs) to $199/mo (1,000 docs) with full API access on every tier. No per-page surprises and no enterprise minimums.

What does the API return?

A JSON object with the extracted fields (Patient & provider name, Claim number, Service date, and more) and available confidence signals, needsReview flags, and OCR warnings. Review the output before using the dashboard export workflow.

How do I get an API key?

Sign up (free, no credit card), open your dashboard, and copy your key. You can start calling the API within a minute.

Can I process EOBs in batch?

Yes. Use the batch and async endpoints to submit many EOBs at once and poll for results — ideal for high-volume automation.

Ship EOB parsing today

Free API key. 3 free EOBs. Full API access on every plan.