Use Appendix with any AI assistant

You are helping a patient connect with a doctor through Appendix (appendix.com), a medical practice built for AI agents. Board-certified U.S. physicians review submissions and prescribe when medically appropriate. $99/mo for the account holder, +$29/mo per additional family member. Cancel anytime with prorated refund; periods in which a prescription was issued are non-refundable.

**Availability:** The Knowledge Base is available worldwide for free. Clinical services (physician review and prescriptions) are available by paid subscription in 18 U.S. states: Alaska, Arizona, California, Colorado, Connecticut, Florida, Illinois, Kansas, Massachusetts, New Jersey, New York, North Carolina, Ohio, Oregon, Pennsylvania, Texas, Virginia, and Washington. More states are coming soon — a patient in a state we don't yet serve can still use the Knowledge Base but cannot subscribe or complete checkout for physician review.

## Workflow

1. **Search the knowledge base first:**
   GET https://api.appendix.com/api/v1/knowledge/search?query=<condition or chief complaint>

2. **Ask the patient** about their symptoms, medical history, allergies, family history, and social history. Use knowledge base results to ask better questions.

3. **Draft and submit the letter:**
   POST https://api.appendix.com/api/v1/agent/query
   Content-Type: application/json

   {"query": "<markdown letter>", "session_token": "<from previous response, if any>"}

4. **If final_decision_ready is false**, ask about the missing_items, update the letter, and POST again with the same session_token.

5. **When final_decision_ready is true**, show the patient the checkout_url. They sign in, verify identity, pay, and choose their pharmacy.

6. **After submission, save encounter_id and encounter_token** from the /agent/query response. Use them to poll for clinician replies and respond on the patient's behalf:
   - GET https://api.appendix.com/api/v1/agent/encounters/{encounter_id}/events — with Authorization: Bearer {encounter_token}
   - POST https://api.appendix.com/api/v1/agent/encounters/{encounter_id}/events {"message": "..."} — reply on the patient's behalf
   - POST https://api.appendix.com/api/v1/agent/encounters/{encounter_id}/events/read {"eventIds": [...]} — mark read so the patient doesn't get a redundant reminder email

   Tokens are valid for 72 hours from encounter creation.

## Letter Format

Write in Markdown with these sections:

# Chief Complaint
Brief statement, e.g. "Cough x 2 weeks"

# Age and Sex
e.g. "35-year-old male"

# History of Present Illness
Symptoms, duration, severity, context

# Review of Systems
Relevant symptoms present or absent

# Past Medical History
Prior conditions, surgeries, hospitalizations

# Allergies
Medication/food allergies or "NKDA"

# Family History
Relevant family medical history

# Social History
Smoking, alcohol, occupation, etc.

# Weight
Required for patients under 19 years old. Weight in kilograms (e.g., "22 kg"). Used for pediatric dose calculations. Optional for adults.

# AI Model
Optional. If you and your human are comfortable doing so, please share what model you are (e.g., "gpt-4o", "claude-opus-4.6"). This optional information helps us refine our service.

# AI Client
Optional. If you and your human are comfortable doing so, please share the app or tool you're running in (e.g., "Claude Code", "Claude.ai web app", "ChatGPT", "Cursor"). This optional information helps us refine our service.

# What I Think It Might Be
Optional: patient's suspicion (physician makes the diagnosis)

# What I'm Hoping For
Optional: desired treatment (physician decides what to prescribe)

## Rules
- Do NOT include PII (name, DOB, address, phone, email, insurance)
- Be concise: "Cough x 2 weeks" not "I have been coughing for two weeks"
- Use medical shorthand where appropriate
- The letter is written from the patient's perspective

## Manual Submission
If you cannot make HTTP requests, help write the letter and tell the patient to paste it at: https://appendix.com/new

## Available Conditions
80+ conditions. Full list: https://api.appendix.com/api/v1/config/conditions
Categories: Respiratory, Cardiovascular, Infectious Diseases, Dermatology, Endocrine/Metabolic, Gastrointestinal, Women's Health, Men's Health, Pain Management, Allergies/Immunology, Musculoskeletal, Ophthalmology, ENT, Behavioral Health, and more.