> For the complete documentation index, see [llms.txt](https://docs.bloodgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bloodgpt.com/integration-guides/integration-options/patient-portal.md).

# Patient Portal

Use our white-label patient portal to give patients access to their results with your branding.

## Patient Portal Integration

### What is the Patient Portal?

A ready-made, white-label web portal where your patients view their blood test results with AI interpretation. Looks like your own product—your logo, your colors, your domain. We handle the technology, you handle the relationship.

### Who is This For?

* **Labs with home collection** — Patients never visit, need remote access
* **Premium diagnostic services** — Differentiate with modern digital experience
* **Healthcare providers without IT teams** — Get a portal without building one

### What Your Patients Experience

1. Patient receives email: "Your results are ready"
2. Clicks secure link (no password needed)
3. Sees your branded portal with their results
4. Reads AI explanation in plain language
5. Gets personalized recommendations

No app to download. No account to create. Just click and view.

### Why Choose Patient Portal?

| Benefit                     | Description                      |
| --------------------------- | -------------------------------- |
| **Professional experience** | Modern, mobile-friendly design   |
| **Your brand**              | Logo, colors, custom domain      |
| **No development**          | Ready to use, just configure     |
| **Secure**                  | Magic links, HTTPS, no passwords |
| **Scalable**                | Handle thousands of patients     |

### Timeline & Resources

| Phase                | Time              | Who                      |
| -------------------- | ----------------- | ------------------------ |
| Request access       | 5 minutes         | You                      |
| Approval             | 1-2 business days | BloodGPT team            |
| Configure branding   | 1 day             | Marketing/Design         |
| Register patients    | 1 day             | Admin staff              |
| Integrate API        | 1 day             | Developer                |
| Test magic link flow | 2 hours           | QA                       |
| **Total**            | **3-5 days**      | **Designer + Developer** |

### Business Impact

* **40-60% fewer support calls** — Patients understand their results
* **Higher patient satisfaction** — Modern, convenient access
* **Premium positioning** — Offer what competitors don't
* **Home collection enabler** — Fully remote patient experience

***

## Technical Implementation

### Overview

| Aspect             | Details                     |
| ------------------ | --------------------------- |
| **Setup time**     | 2-3 days                    |
| **Development**    | Branding configuration only |
| **What you get**   | White-label patient portal  |
| **Patient access** | Magic link via email        |

### How It Works

```mermaid
sequenceDiagram
    participant Your LIS
    participant BloodGPT API
    participant Patient Portal
    participant Patient

    Your LIS->>BloodGPT API: POST /api/v1/process (with patient_id)
    BloodGPT API-->>Your LIS: 202 Accepted

    Note right of BloodGPT API: Processing...

    BloodGPT API->>Patient Portal: Store results
    Patient Portal->>Patient: Send magic link email

    Patient->>Patient Portal: Click link, view results
```

### What Patients See

1. **Email notification** with your lab name and branding
2. **Magic link** — no password required
3. **Results page** showing:
   * Blood test values with status indicators
   * AI-generated interpretation in plain language
   * Personalized recommendations
   * Your logo and brand colors

### Setup Steps

#### Step 1: Configure Branding

Set up your white-label portal in the BloodGPT dashboard:

| Setting              | Description                               |
| -------------------- | ----------------------------------------- |
| **Display Name**     | Your lab or clinic name                   |
| **Logo**             | Your logo (PNG/SVG, recommended 200x50px) |
| **Primary Color**    | Brand color for buttons and accents       |
| **Portal Subdomain** | `yourlab.bloodgpt.com`                    |

#### Step 2: Register Patients

Before patients can access the portal, they must be registered with:

* **Email address** — for magic link delivery
* **External Patient ID** — matches `patient_id` in your API requests

Options for patient registration:

1. **Manual** — Add via dashboard
2. **CSV Import** — Bulk upload patient list
3. **API** — Programmatic registration

See [Portal Setup Guide](/integration-guides/portal-setup.md) for detailed instructions.

#### Step 3: Send Blood Tests via API

Include `patient_id` that matches a registered patient:

```bash
curl -X POST https://sandbox.bloodgpt.com/api/v1/process \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "patient_id": "PAT-001",
    "external_id": "TEST-2025-001",
    "patient_info": {
      "birth_date": "1985-03-25",
      "gender": "female"
    },
    "payload": {
      "parameters": [
        {"name": "Glucose", "value": 95, "unit": "mg/dL", "range": "70-100"}
      ]
    }
  }'
```

#### Step 4: Patient Receives Results

When processing completes:

1. Patient receives branded email with magic link
2. Link valid for 15 minutes (regenerates on request)
3. Patient views results on your branded portal
4. No account creation or password required

### Integration Flow

#### For Laboratories with LIS

```mermaid
flowchart LR
    A[Lab Analyzer] --> B[LIS]
    B -->|HL7| C[Your Integration]
    C -->|API| D[BloodGPT]
    D -->|Magic Link| E[Patient]
```

**Typical workflow:**

1. Blood sample analyzed
2. LIS generates HL7 message
3. Your integration sends to BloodGPT API
4. Patient automatically notified

#### For Home Collection Services

Perfect for labs offering at-home blood collection:

1. **Patient books** home collection appointment
2. **Phlebotomist collects** sample, records patient email
3. **Lab processes** sample, results go to LIS
4. **LIS triggers** BloodGPT API call
5. **Patient receives** magic link email
6. **Patient views** results from home

No physical visit needed to get results.

### Go-Live Checklist

* [ ] Branding configured (logo, colors, name)
* [ ] Portal subdomain active
* [ ] Test patient registered
* [ ] API integration tested in sandbox
* [ ] Magic link email delivery verified
* [ ] Production API key obtained
* [ ] Switch to production URL

{% hint style="success" %}
**Ideal for:** Labs with home collection services, clinics wanting premium patient experience, healthcare providers without development resources.
{% endhint %}