Skip to main content
POST
/
api
/
generate-letter
cURL
curl --request POST \
  --url https://forecaster.cairhealth.com/api/generate-letter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_content": "<Base64 encoded file content here>",
  "patient_identifier": "PAT-12345",
  "patient_name": "John Doe",
  "patient_age": "45",
  "facility_name": "Medical Center",
  "visit_cost": "500.00",
  "provider_email": "contact@medicalcenter.com",
  "provider_phone": "+1-555-123-4567",
  "provider_signature": "Dr. Jane Smith",
  "provider_name": "Dr. Jane Smith, MD",
  "output_format": "pdf"
}
'
{
  "letter": "<Letter Content Here>",
  "timestamp": "2025-10-16T14:30:45Z",
  "invoice_cost": "500.00",
  "patient_identifier": "PAT-12345"
}

​
Overview

This endpoint generates a Letter of Medical Necessity (LMN) from uploaded procedure notes using AI analysis. The letter can be returned in two formats:
  • Text format (default): Returns the letter content as plain text markdown
  • PDF format: Returns a professionally formatted PDF document with proper letter layout, including header, patient information, body content, signature, and footer

​
Output Formats

​
Text Format (output_format: "text" or omitted)

When requesting text format, the response includes a letter field containing the markdown-formatted letter content.

​
PDF Format (output_format: "pdf")

When requesting PDF format, the response includes a fileContent field containing a base64-encoded PDF document. The PDF includes:
  • Professional letter header with center name, contact information, and date
  • Patient information section
  • Formatted letter body with proper text wrapping
  • Signature section with expert name
  • Footer with generation timestamp

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body containing base64 encoded file content and additional metadata

Request body for generating a Letter of Medical Necessity from encounter notes

​
file_content
string
required

Base64 encoded content of the procedure notes file (PDF)

​
patient_identifier
string
required

Unique identifier for the patient

​
patient_name
string
required

Patient's full name

​
patient_age
string
required

Patient's age

​
facility_name
string
required

Name of the medical facility or center

​
visit_cost
string
required

Cost of the visit or procedure

​
provider_email
string<email>
required

Provider's contact email address

​
provider_phone
string
required

Provider's contact phone number

Example:

"+1-555-123-4567"

​
provider_signature
string
required

Signature line text for the letter

​
provider_name
string
required

Name and credentials of the provider signing the letter

Example:

"Dr. Jane Smith, MD"

​
output_format
enum<string>
default:text

Output format for the letter. Defaults to 'text' if not specified.

Available options:
text,
pdf

Response

Letter of Medical Necessity generated successfully

Response containing the generated Letter of Medical Necessity. The response format depends on the output_format parameter in the request.

​
letter
string

The generated Letter of Medical Necessity content in text format. Present when output_format is 'text' or not specified.

​
fileContent
string

Base64 encoded PDF content of the generated letter. Present when output_format is 'pdf'.

​
timestamp
string<date-time>

Timestamp when the letter was generated

​
invoice_cost
string

The visit cost associated with the letter generation

​
patient_identifier
string

The patient identifier associated with the letter