Ivory Cognitive Assessment — API Integration Proposal

BETTROI

Technology Solutions | bettroi.com

PROPOSAL REF: BTR-2026-LBL-02 Date: March 6, 2026
Valid Until: April 6, 2026

LimitlessBrainLab.com — Dr. Sweta Adatia | Seamless in-app cognitive assessment experience

v2 — Based on Official Ivory API Documentation

Prepared For

Dr. Sweta Adatia — LimitlessBrainLab

Integration Partner

Ivory — liveivory.com

Integration Mode Selected

Embedded Magic Link

Estimated Delivery

15 Working Days

Integration Mode Selection

Embedded Magic Link

iframe inside LimitlessBrainLab — no separate patient login, full UX control, complete co-branding and result visibility within the existing platform

SELECTED

Available Assessment Products

Cantab Insights

KEY: CANTAB_INSIGHTS

Gold-standard neuropsychological battery — memory, attention, executive function

Cognitive Assessment Profiler

KEY: DIY

Self-administered cognitive profiling — ideal for regular monitoring

GAD-7 Scale

KEY: GAD_7

Generalised Anxiety Disorder 7-item validated scale

PHQ-9 Scale

KEY: PHQ_9

Patient Health Questionnaire for depression screening

Technical Integration Flow (Step by Step)

Automatic Patient Registration via LBL Portal

When a user completes registration or selects a cognitive assessment on the LimitlessBrainLab portal, their Ivory account is created automatically — no separate Ivory sign-up is required. Every access to Ivory assessments, for both new and returning users, goes through the LimitlessBrainLab sign-in only. Ivory credentials are never shared with the user. The LimitlessBrainLab dashboard does not display the number of users — user accounts are managed entirely within the Ivory dashboard, which holds all account records for users of the platform.

POST /users — Partner ID + API Key auth (triggered automatically on LBL registration)

Assign Assessment to Patient

The user selects an assessment type (CANTAB, DIY, GAD-7, PHQ-9) from within the LimitlessBrainLab portal and triggers the assignment. The system calls the Ivory API to create the session, and an order/session ID from LimitlessBrainLab is mapped for cross-system tracking.

POST /assessments/assign — product key + user ID

Generate Pre-Authenticated Magic Link

A unique magic link is generated for each assessment session. This link is embedded via iframe inside LimitlessBrainLab — the patient completes the assessment without any separate login or redirect.

POST /assessments/magic-link — returns hosted page URL

Track Completion & Fetch Results

The hosted detail page shows assessment lifecycle (steps completed, report generated). Once done, the report PDF and raw domain scores are pulled via the report API and displayed in the Ivory portal.

GET /reports/{assessmentId} — raw scores + co-branded PDF link

Scope of Work

#	Module	Description
1	API Auth & Patient Sync	Setup Ivory Partner ID + API Key, auto-register patients on first encounter
2	Assessment Selection UI	Product selector (CANTAB/DIY/GAD-7/PHQ-9) within the user's LBL portal — user selects and triggers assignment
3	Magic Link + iframe Embed	Generate pre-auth magic link, embed Ivory assessment in-app via iframe, no patient login
4	Assessment Status Tracking	Live status on patient profile — Not Started, In Progress, Completed, Report Ready
5	Trend & Progress Charts	Multi-session score comparison charts — track cognitive improvement over time
7	Co-Branded PDF Report	Pull Ivory's co-branded PDF (with LimitlessBrainLab logo) via report API, download per session
8	Testing (Test Env) + Prod Deploy	Full QA on Ivory test environment, then go-live with production credentials

Total: 15 working days — Test environment credentials already in hand. Integration begins immediately upon receipt of all required access and credentials from Dr. Sweta. No WhatsApp integration is in scope.

Delivery Timeline

Working Days

Estimated end-to-end delivery from project kickoff, covering API integration, assessment embedding, results dashboard, full QA on test environment, and production deployment. Timeline begins upon receipt of all required credentials and access from Dr. Sweta.

Requirements from Dr. Sweta

To initiate and complete this integration, Bettroi requires the following inputs and access from Dr. Sweta / LimitlessBrainLab:

Ivory Partner ID & API Key — Production credentials issued after completion of the Ivory partnership agreement. Test credentials already provided and in use.
Ivory Partnership Agreement — The Ivory partnership/reseller agreement must be executed by Dr. Sweta directly with Ivory to unlock production API access and co-branding features.
LimitlessBrainLab Logo Assets — High-resolution logo files (PNG/SVG) for Ivory to configure co-branded PDF reports and the in-app assessment interface.
Payment Portal Integration Details — Credentials and API documentation for the LimitlessBrainLab.com payment portal, so that patient payments are routed through the existing payment gateway without any separate setup.
UI/UX Sign-off — Approval of the assessment flow and results dashboard wireframes before development begins, to avoid revision cycles.

Assumptions and Notes

Ivory test environment credentials already provided — integration can begin immediately
Assessment UI delivered via Ivory-hosted iframe — no custom assessment logic to build
LimitlessBrainLab existing platform remains intact — this is an additive integration only
Co-branded PDF reports with LimitlessBrainLab logo enabled on Ivory side (client to confirm)
Ivory subscription and per-assessment fees to be paid directly by Dr. Sweta to Ivory
All user access to Ivory assessments is exclusively through the LimitlessBrainLab sign-in — Ivory credentials are never exposed to users
User account management (including total user count) resides in the Ivory dashboard — the LBL dashboard does not display Ivory user counts
Patient payments are collected via the existing payment portal on LimitlessBrainLab.com — no new payment gateway is required as part of this integration. Bettroi will integrate with the existing payment portal API to trigger and track patient payments seamlessly within the platform.