We use cookies for analytics and marketing to improve your experience and communicate with you. You can accept or reject cookies below. View our Cookie Policy for more information.

FHIR server Release notes Talk to us Ask community Blog Health Samurai

Run Aidbox locally Run Aidbox in Sandbox Examples

Product

FHIR server Release notes Talk to us Ask community Blog Health Samurai Run Aidbox locally Run Aidbox in Sandbox Examples

CtrlK

Run Aidbox in Sandbox Run Aidbox locally Use Aidbox with Java Use Aidbox with TypeScript Use Aidbox with Python Use Aidbox with C#Run Aidbox on AWS Upload Sample Data

Features Architecture

Delete data Set up uniqueness in Resource

Custom SearchParameter tutorial Create custom Aidbox Search resource Multilingual search tutorial Migrate from Aidbox SearchParameter to FHIR SearchParameter Change sort order by locale collation

Synthea by Bulk API $dump-sql tutorial

Allow patients to see their own data Restrict operations on resource type Relationship-based access control Creating user and set up full user access Restricting Access to Patient Data Create and test access control

Flexible RBAC built-in to Aidbox RBAC with JWT containing role

Set-up token introspection Prohibit user to login Managing Admin Access to the Aidbox UI Using Okta Groups Run Multibox locally How to enable labels-based access control How to enable patient data access API How to enable SMART on FHIR on Patient Access API How to enable hierarchical access control How to configure FHIR Audit Log How is an HTTP request processed in Aidbox How to configure SSO with another Aidbox instance to access Aidbox UI How to configure SSO with Okta to access Aidbox UI How to configure sign-in with Apple for access to the Aidbox UI How to configure Azure AD SSO for access to the Aidbox UI How to configure Microsoft AD FS for access to the Aidbox UI How to configure Azure AD SSO with certificate authentication for access to the Aidbox UI How to configure GitHub SSO for access to Aidbox UI How to configure Keycloak for access for AidboxUI Auto-create User from foreign token tutorial How to implement consent-based access control using FHIR Search and Aidbox Access Policy Debug Access Control AccessPolicy best practices How to configure Basic Auth flow Deprecated Access policy dev tool How to configure Authorization Code Grant How to configure Client Credentials Grant How to configure Implicit Grant How to configure Token Exchange How to configure Resource Owner Grant flow SSO with External OAuth Identity Provider Access policies examples

Load ICD-10 terminology into Aidbox Uploading IG terminology content to external FHIR terminology server Local Terminology

ISiK Carin BB US Core Davinci Pdex mCode

Postmark integration tutorial Mailgun integration tutorial

FHIR R5 Subscription Setup FHIR R4B Backport Subscription Setup FHIR R4 Backport Subscription Setup Kafka AidboxTopicDestination ClickHouse AidboxTopicDestination Tutorial: Produce QuestionnaireResponse to Kafka topic GCP Pub/Sub AidboxTopicDestination Webhook AidboxTopicDestination AidboxTopicSubscription NATS tutorial AidboxTopicSubscription RabbitMQ tutorial AidboxTopicSubscription ActiveMQ tutorial Subscribe to New Patient Resource

How to create FHIR npm package

Extensions using StructureDefinition Extensions using FHIRSchema

Custom resources using FHIR Schema Custom resources using StructureDefinition

Migrate custom resources defined with Entity and Attributes to FHIR Schema Migrate custom resources defined with Zen to FHIR Schema

How to load FHIR IG with Init Bundle Environment Variable

IG Package from Aidbox Registry Public URL to IG Package Local IG Package

Aidbox FHIR API UploadFIG Tool

Run Aidbox with FHIR R6 Migrate from Multibox to Aidbox SDC with Custom Resources Migrate from legacy licence portal to Aidbox portal Set up Aidbox with Postman How to run Aidbox in GCP Cloud Run How to run Aidbox in Azure Container Apps How to run Aidbox using different Java AI Prompts How to configure Aidbox to use a proxy for outgoing requests

Overview

Licensing and Support

Projects Licenses Members

Aidbox Notebooks REST Console Database Console Attrs Stats DB Tables DB Queries

Versioning Release Notes FAQ Contact us

Configuration

Recommended environment variables Settings Configure Aidbox and Multibox Init Bundle

API

Create Read Update Patch Delete

SearchParameter Include and Revinclude Chaining

Aidbox Search Bundle History $everything on Patient

Aidbox and FHIR formats Capability Statement $document Observation/$lastn $validate SQL endpoints $matcho $to-format Aidbox version Health check $meta $meta-add $meta-delete

Configure Access Policies for Bulk API $dump $dump-sql $dump-csv $export $load and /fhir/$load $import and /fhir/$import Aidbox.bulk data import Bulk import from an S3 bucket

Batch/Transaction GraphQL API

Practitioner PractitionerRole Organization OrganizationAffiliation

Create-archive Restore-archive Prune-archived-data Delete-archive

ETAG support Cache Changes API RPC API Sequence API Encryption API Batch Upsert

Access Control

User management Application/Client Management

Basic HTTP Authentication OAuth 2.0 Token Introspector SSO with External Identity Provider Two Factor Authentication

Access Policies

SMART App Launch SMART backend services

SMART: Asymmetric ("private key JWT") authentication SMART: Symmetric (/"client secret") authentication

SMART: Scopes for Limiting Access Pass Inferno tests with Aidbox Example: SMART app launch using Aidbox and Keycloak Example: SMART app launch using Smartbox and Keycloak

Organization-based hierarchical access control Compartments API Patient data access API

Label-based Access Control

Audit and Logging

Artifact Registry

Artifact Registry overview StructureDefinition SearchParameter CodeSystem ValueSet ConceptMap

Terminology Module

Terminology Overview

Coded Values Profiles, Binding, and Validation

Setup Hybrid Mode Capabilities

Database

Database overview PostgreSQL Requirements Database schema PostgreSQL Extensions

Modules

Setup Aidbox with FHIR Schema validation engine

Skip validation of references in resource using request header Asynchronous resource validation

Run Aidbox with OpenTelemetry locally How to export telemetry to the OTEL collector

OpenTelemetry logs Elastic Logs and Monitoring Integration Datadog log management integration Loki log management integration

Log analysis and visualization tutorial Export logs to Datadog tutorial Set up logs with Aidbox project

Extending Aidbox Logs

Log appenders Log transformations Log Schema OTEL logs exporter parameters

How to export metrics to the OTEL collector Use Aidbox Metrics Server Set-up Grafana integration

OpenTelemetry Metrics OTEL metrics exporter parameters

How to use tracing OTEL traces exporter parameters

Aidbox Topic-Based Subscriptions FHIR Topic-Based Subscriptions Aidbox SubSubscriptions

Getting started Aidbox Forms Interface

UI Builder Interface AI Assistant

Form Settings Widgets Components Entry Mode Versioning Validation Nesting Form customisation in theme editor Form signature NHS integration

How to: Populate forms with data How to extract data from forms How to calculate form filling percentage How to create a form with dynamical answers into questions

Multilingual forms FHIRPath Expressions with Visual Editor Data Extraction Population

Import Questionnaire Form sharing

Native look form printing Template-based PDF generation

FHIR versions Offline forms

Request Interception

Configuration Forms multitenancy Building reports using SQL on FHIR Integration with external terminology servers Parameterised ValueSet External Form Renderer in Builder Preview External FHIR servers as a data backend Store attachments in S3-like storages

Form creation How to create a dynamic form How to create a form with calculated fields Form Customisation Versioning Form sharing Aidbox Form Workflow Changing data after form signing FHIR Questionnaire to Aidbox forms and back conversion

Any familiar form editor (docs deprecated)Access control in forms Adaptive Forms Audit logging in forms Aidbox Form Gallery Da Vinci DTR

$run operation $materialize operation Defining flat views with view definitions Migrate to the spec-compliant ViewDefinition format Query data from flat views Reference

Admission Diagnosis Section (/V3)Advance directives section (/entries optional) (/V3)Advance directives section (/entries required) (/V3)Allergies and intolerances section (/entries optional) (/V3)Allergies and intolerances section (/entries required) (/V3)Assessment Section Chief Complaint Section Chief Complaint and Reason for Visit Section Complications Section (/V3)Course of Care Section DICOM Object Catalog Section - DCM 121181 Default Section Rules Discharge Diagnosis Section (/V3)Document Header Encounters section (/entries optional) (/V3)Encounters section (/entries required) (/V3)Family History Section (/V3)Functional Status Section (/V2)General Status Section Goals Section Health Concerns Section (/V2)History of Present Illness Section Hospital Consultations Section Hospital Course Section Hospital Discharge Instructions Section Hospital Discharge Physical Section Hospital Discharge Studies Summary Section Immunizations section (/entries optional) (/V3)Immunizations section (/entries required) (/V3)Medical (/General) History Section Medical Equipment Section (/V2)Medications Administered Section (/V2)Medications section (/entries optional) (/V2)Medications section (/entries required) (/V2)Mental Status Section (/V2)Notes Nutrition Section Objective Section Operative Note Fluids Section Operative Note Surgical Procedure Section Past Medical History (/V3)Payers Section (/V3)Plan of Treatment Section (/V2)Postprocedure Diagnosis Section (/V3)Preoperative Diagnosis Section (/V3)Problem section (/entries optional) (/V3)Problem section (/entries required) (/V3)Procedure Description Section Procedure Disposition Section Procedure Estimated Blood Loss Section Procedure Implants Section Procedure Specimens Taken Section Procedures section (/entries optional) (/V2)Procedures section (/entries required) (/V2)Reason for Visit Section Results section (/entries optional) (/V3)Results section (/entries required) (/V3)Review of Systems Section Social History Section (/V3)Vital signs section (/entries optional) (/V3)Vital signs section (/entries required) (/V3)Discharge Meds section (/entries optional)Discharge Meds section (/entries required)

How to deploy the service Producing C-CDA documents How to customize conversion rules

HL7 v2 integration with Aidbox project Mappings with lisp/mapping

X12 message converter

Setup SMTP provider

Getting Started Authentication with mTLS Pharmacies Synchronization

NewRx Message CancelRx Message

RxRenewal Message RxChange Message

DetectedIssue How to test Callback

DirectoryDownload Message GetProviderLocation Message AddProviderLocation Message UpdateProviderLocation Message DisableProviderLocation Message

Environment Variables List of Metrics

Frequently Asked Questions

Run MDM locally Configure MPI module

Find duplicates: $match Merging and Unmerging Records: $merge and $unmerge Matching Model Explanation Mathematical Details

Set up Smartbox locally Deploy Smartbox with Kubernetes

(/G)(/10) Standardized API for patient and population services

Source attributes Feedback Sections

Perform EHR Launch Revoke Granted Access Set up EHR-level Customization Check email templates Setup email provider Register Users Set up SSO with Auth0 Publish Terms of Use Link Onto the Documentation Page Find Out What Resources Were Exported During the $export Operation Find Documentation Endpoint

Considerations for Testing with Inferno ONC Adding Clients for Inferno Tests Multitenancy Approach What Is Tenant Email Templating

MCP AidboxTrigger

Getting Started FHIR Resources Default Mappings Module Limitations Message Lifecycle

File storage

AWS S3 GCP Cloud Storage Azure Blob Storage Oracle Cloud Storage

Deployment and maintenance

Deploy Production-ready Aidbox to Kubernetes Deploy Aidbox with Helm Charts Highly Available Aidbox Self-signed SSL Certificates

Run Aidbox on managed PostgreSQL How to inject env variables into Init Bundle

Crunchy Operator (/pgbackrest)pg_dump pg_basebackup WAL-G

Get Suggested Indexes Create Indexes Manually

Developer experience

Developer experience overview Working with AI Apps Use Aidbox with React Aidbox SDK Examples

Solutions

Run Aidbox + FHIR Portal locally Run Aidbox + FHIR Portals on k8s Migrate from Smartbox to Aidbox + FHIR App portal

Developer Sandbox Admin Portal FHIR App Gallery

Pass Inferno Tests with Aidbox Pass Inferno Visual Inspection and Attestation

Run Aidbox + CMS App locally

Prior Authorization Support (PAS) API

Reference

Aidbox Settings Reference

IAM Module Resources SDC Module Resources Base Module Resources Bulk Module Resources AWF Module Resources Cloud Module Resources HL7v2 Module Resources SQL on FHIR Module Resources Subscriptions Module Resources

FHIR Schema Reference

Notification Resource Reference Mailgun Environment Variables Postmark Environment Variables

FHIR SDC API Aidbox SDC API Generating Questionnaire from PDF API Generating Questionnaire from openEHR Template API

Aidbox SQL Functions Matcho DSL Reference FAR Package Management API

Deprecated

aidbox.mdm/update-mdm-tables aidbox.mdm/match

Run Aidbox Locally Using Aidbox Configuraiton Project Aidbox Configuration Project Structure Set up and Use Configuration Projects Enable IGs Repository Seed Import Manage Indexes in Zen Project Seed v2 Migrate to Git Aidbox Configuration Projects

Zen Configuration Aidbox Project RPC Reference aidbox.config/config

Custom Resources Using Aidbox Project First-Class Extensions Using Zen Zen Indexes

US Core IG Support Reference

Aidbox Built-in Tasks Task Executor API Task User API

Workflow User API

Services Monitoring

Touchstone FHIR 4.0.1 Basic Server Touchstone FHIR USCore ClinData

Start Aidbox Locally with US Core IG Enabled Add US Core IG to a Running Aidbox Instance

HL7 FHIR Da Vinci PDex Plan Net IG

Inferno Test-Suite US Core 3.1.1

API Constructor (/Beta)

Write a Custom Zen Profile Load Zen Profiles into Aidbox

Set up SubscriptionTopic Tutorial: Subscribe to Topic (/R4B)

SubscriptionTopic API Subscription API

FTR Specification

FTR from CSV FTR from FHIR IG FTR from FTR — Direct Dependency FTR from FTR — Supplement

FTR Manifest Load SNOMED CT into Aidbox Load LOINC into Aidbox Load ICD-10-CM into Aidbox Load RxNorm into Aidbox Load US VSAC Package to Aidbox Import via FTR

Zen Search Parameters Access Control Lists (/ACL)RBAC with ACL

Entities and Attributes First-Class Extensions Using Attribute Custom Resources Using Entity Working with Extensions Aidbox Search Parameters

Layout DSL (docs deprecased)Document DSL (docs deprecased)Launch DSL (docs deprecased)Lisp (Deprecated)FinalizeConstraints DSL (Deprecated)Finalize DSL (docs deprecased)Form DSL (docs deprecased)Lisp API (docs deprecased)Form API (docs deprecased)Workflow API (docs deprecased)Addendum API (docs deprecased)

HA AidboxDB Migrate to AidboxDB 16 Working with pgAgent

AidboxDB Environment Variables Custom Search SearchQuery

Patient Encounter Notification Application

Configuring Two Factor Authentication in Aidbox Identity Provider

Resource Generation with Map-to-FHIR-Bundle-Task and Subscription Triggers APM Aidbox Automatically Archive AuditEvent Resources in GCP Storage Guide HL7 v2 Pipeline with Patient Mapping How to Migrate to Apline Linux How to Migrate Transaction Id to Bigint How to Fix Broken Dates Configure Multi-Tenancy

AidboxProfile GCP Pub/Sub

SMART on FHIR Set up SMART on FHIR in Aidbox Get a SMART App Launched

$translate-concepts (deprecated)Handling hierarchies using ancestors (deprecated)

ValueSet Expansion (deprecated)ValueSet Code Validation (deprecated)Create a ValueSet (deprecated page)

CodeSystem Concept Lookup (deprecated)CodeSystem subsumption testing (deprecated)CodeSystem Code Composition (deprecated)

Import flat file (/CSV) (deprecated)$import operation (deprecated)Ready-to-use terminologies (deprecated)

$translate on ConceptMap (deprecated)

Aidbox JavaScript SDK NodeJs SDK Python SDK

Developer Sandbox Portal Flow Description

Modules

/

SMARTbox | FHIR API for EHRs

/

How-to Guides

View as Markdown

View this page as plain text

Edit this page on GitHub

Find Documentation Endpoint

SMART on FHIR Find Documentation Endpoint implementation in Aidbox for healthcare app integration.

To see Smartbox documentation

Open the https://[aidbox-base-url]/documentaion address in a browser

PreviousFind Out What Resources Were Exported During the $export Operation

NextBackground Information

Last updated: 2025-12-05T13:53:00Z

To see Smartbox documentation

© Health Samurai

•

Contact us•Docs source (2859179)•