API Documentation

The LineCite Evidence Intelligence API allows developers to programmatically extract structured clinical events from medical record packets and verify claims against original evidentiary source documents.

Authentication

LineCite uses API keys to authenticate requests. You can view and manage your API keys in the dashboard under Settings.

Authorization: Bearer LC_YOUR_API_KEY

Keep your API keys secure. Do not share them in publicly accessible areas such as GitHub, client-side code, etc.

Base URL

All API requests should be made to the following base URL:

https://api.linecite.com/v1
POST

/extract-events

Submits a medical record packet for extraction. The API returns an Evidence Graph containing structured clinical events (visits, meds, imaging, etc.) anchored to specific page citations.

Request Body

{
  "document_url": "https://your-bucket.com/packet.pdf",
  "webhook_url": "https://your-app.com/webhooks/linecite",
  "priority": "standard",
  "options": {
    "extract_billing": true,
    "detect_gaps": true
  }
}

Response Example

{
  "job_id": "job_LC_98234",
  "status": "processing",
  "estimated_completion": "2026-03-04T20:45:00Z"
}
POST

/verify-claim

Verifies a natural language claim against the Evidence Graph of a previously processed job.

Request Body

{
  "job_id": "job_LC_98234",
  "claim": "The patient had a lumbar MRI on Oct 12th showing L4-L5 herniation."
}

Response Example

{
  "verified": true,
  "confidence": 0.98,
  "supporting_events": ["event_42", "event_43"],
  "citation": {
    "page": 14,
    "snippet": "MRI Lumbar Spine: L4-L5 disc herniation..."
  }
}

Error Codes

400

Bad Request

The request body is malformed or missing required fields.

401

Unauthorized

Invalid or missing API key.

402

Payment Required

Insufficient credits or subscription expired.

404

Not Found

The requested job or document does not exist.

429

Too Many Requests

Rate limit exceeded for your tier.