Aidbox

Aidbox is a production-ready FHIR platform and clinical data backend from Health Samurai, used by digital health startups, providers, payers, and life-sciences teams to build interoperable healthcare products in the United States and globally. Built on PostgreSQL, Aidbox exposes a full HL7 FHIR REST API (R4, R5, and R6) plus Aidbox-native SQL search, SQL-on-FHIR, a GraphQL API, Bulk Data export/import, topic-based Subscriptions, and terminology services. It is self-hosted or Aidbox-hosted software rather than a single public multi-tenant endpoint, so each deployment serves its own FHIR base and its own CapabilityStatement; a public sandbox (sandbox.aidbox.app) exposes a live FHIR R4 CapabilityStatement and a SMART-on-FHIR / OpenID .well-known configuration. Authentication is OAuth 2.0 with SMART-on-FHIR support (patient/user/system scopes, EHR and standalone launch, client-confidential and client-public flows). Aidbox aligns with US interoperability needs (US Core, SMART App Launch, Bulk Data) and is HIPAA-oriented, HITRUST and SOC 2 focused. This profile catalogs the documented, real API surface only.

Aidbox publishes 7 APIs on the APIs.io network. Tagged areas include Healthcare, United States, FHIR, HL7, and Interoperability.

The Aidbox catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Aidbox’s developer surface includes documentation, API reference, getting-started guide, pricing, engineering blog, support, signup flow, and 31 more developer resources.

🌐 Visit website 📡 Source on GitHub

52.9/100 developing ▬ flat Agent 52/100 agent ready Full breakdown ↓
scored 2026-07-27 · rubric v0.5

7 APIs 1 MCP Servers

HealthcareUnited StatesFHIRHL7InteroperabilitySMART on FHIREHRHealth DataFHIR ServerBulk DataTerminologyDigital Health

Kin Score

Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5

Composite quality — 52.9/100 · developing

Contract Quality 5.7 / 25

Developer Ergonomics 16.1 / 20

Commercial Clarity 8.4 / 20

Operational Transparency 8.2 / 13

Governance 0.0 / 12

Discoverability 10.0 / 10

Agent readiness — 52/100 · agent ready

Machine-Readable Contract 0 / 18

Agentic Access Contract 0 / 15

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 4 / 4

Consent & Bot Identity 0 / 3

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/aidbox: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Scopes 1

OAuth scopes governing access to this provider's APIs.

Aidbox Scopes

12 scopes · authorizationCode/clientCredentials/implicit/password

12 scopes

SCOPES

Resources

Get Started 4

Portal, sign-up, and the first successful call

DeveloperPortal

GettingStarted

SignUp

Sandbox

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

MCPServer

AgentSkill

WellKnown

LLMsTxt

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Conformance

Conventions

Idempotency

ErrorCatalog

Lifecycle

Webhooks

DataModel

Scroll for all 7

Build 4

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

Packages

SDKs

ToolCrosswalk

Access & Security 5

Authentication, authorization, and security posture

DomainSecurity

Security

Compliance

Authentication

OAuthScopes

Operate 4

Status, limits, changes, and where to get help

StatusPage

Support

Deprecation

ChangeLog

Commercial 2

Pricing, plans, and the legal terms of use

Pricing

Pricing

PrivacyPolicy

PrivacyPolicy

Company 3

The organization behind the API

Website

Website

Blog

Blog

LinkedIn

Other 3

Properties that don't map to a standard resource type

SMARTConfiguration

SMARTConfiguration

OpenIDConfiguration

OpenIDConfiguration

CapabilityStatement

CapabilityStatement

Source (apis.yml)

aid: aidbox
url: https://raw.githubusercontent.com/api-evangelist/aidbox/refs/heads/main/apis.yml
name: Aidbox
kind: company
description: Aidbox is a production-ready FHIR platform and clinical data backend from Health Samurai, used by digital health
  startups, providers, payers, and life-sciences teams to build interoperable healthcare products in the United States and
  globally. Built on PostgreSQL, Aidbox exposes a full HL7 FHIR REST API (R4, R5, and R6) plus Aidbox-native SQL search, SQL-on-FHIR,
  a GraphQL API, Bulk Data export/import, topic-based Subscriptions, and terminology services. It is self-hosted or Aidbox-hosted
  software rather than a single public multi-tenant endpoint, so each deployment serves its own FHIR base and its own CapabilityStatement;
  a public sandbox (sandbox.aidbox.app) exposes a live FHIR R4 CapabilityStatement and a SMART-on-FHIR / OpenID .well-known
  configuration. Authentication is OAuth 2.0 with SMART-on-FHIR support (patient/user/system scopes, EHR and standalone launch,
  client-confidential and client-public flows). Aidbox aligns with US interoperability needs (US Core, SMART App Launch, Bulk
  Data) and is HIPAA-oriented, HITRUST and SOC 2 focused. This profile catalogs the documented, real API surface only.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Healthcare
- United States
- FHIR
- HL7
- Interoperability
- SMART on FHIR
- EHR
- Health Data
- FHIR Server
- Bulk Data
- Terminology
- Digital Health
created: '2026-07-24'
modified: '2026-07-24'
specificationVersion: '0.20'
apis:
- aid: aidbox:aidbox-fhir-api
  name: Aidbox FHIR API
  description: Aidbox's HL7 FHIR REST API for creating, reading, updating, deleting, and searching clinical and administrative
    resources. Supports FHIR R4 (4.0.1), R5, and R6, with standard FHIR interactions, transaction/batch bundles, and operations
    such as $validate, $everything, $document, and $lastn. The live public sandbox exposes a FHIR R4 CapabilityStatement listing
    138 supported resource types at sandbox.aidbox.app/fhir/metadata.
  humanURL: https://www.health-samurai.io/docs/aidbox/api-1/fhir-api
  baseURL: https://sandbox.aidbox.app/fhir
  tags:
  - FHIR
  - Healthcare
  - Interoperability
  properties:
  - type: Documentation
    url: https://www.health-samurai.io/docs/aidbox/api-1/fhir-api
  - type: APIReference
    url: https://www.health-samurai.io/docs/aidbox/api-1/api
  - type: CapabilityStatement
    url: fhir/aidbox-capabilitystatement.json
  - type: SMARTConfiguration
    url: fhir/aidbox-smart-configuration.json
- aid: aidbox:aidbox-rest-search-api
  name: Aidbox REST & Search API
  description: Aidbox-native REST and search API offering CRUD over resources plus SQL-based search implementations for performance
    optimization and complex custom queries beyond standard FHIR search parameters.
  humanURL: https://www.health-samurai.io/docs/aidbox/api-1/rest-api/aidbox-search
  baseURL: https://sandbox.aidbox.app
  tags:
  - Healthcare
  - Search
  properties:
  - type: Documentation
    url: https://www.health-samurai.io/docs/aidbox/api-1/rest-api/aidbox-search
  - type: APIReference
    url: https://www.health-samurai.io/docs/aidbox/api-1/api
- aid: aidbox:aidbox-sql-on-fhir-api
  name: Aidbox SQL-on-FHIR API
  description: SQL-on-FHIR support that lets clients run SQL queries directly against FHIR data, treating FHIR resources as
    relational tables for analytics and reporting.
  humanURL: https://www.health-samurai.io/docs/aidbox/modules/sql-on-fhir
  baseURL: https://sandbox.aidbox.app
  tags:
  - Healthcare
  - SQL
  - Analytics
  properties:
  - type: Documentation
    url: https://www.health-samurai.io/docs/aidbox/modules/sql-on-fhir
- aid: aidbox:aidbox-graphql-api
  name: Aidbox GraphQL API
  description: A GraphQL API over FHIR data that lets clients request exactly the data they need across related resources
    in a single call.
  humanURL: https://www.health-samurai.io/docs/aidbox/api-1/graphql-api
  baseURL: https://sandbox.aidbox.app
  tags:
  - Healthcare
  - GraphQL
  properties:
  - type: Documentation
    url: https://www.health-samurai.io/docs/aidbox/api-1/graphql-api
- aid: aidbox:aidbox-bulk-data-api
  name: Aidbox Bulk Data API
  description: FHIR Bulk Data API for large-scale export and import of FHIR resources, including $export, FHIR import/load,
    and dump utilities for moving datasets in and out of Aidbox.
  humanURL: https://www.health-samurai.io/docs/aidbox/api-1/bulk-api/export
  baseURL: https://sandbox.aidbox.app
  tags:
  - Healthcare
  - Bulk Data
  - FHIR
  properties:
  - type: Documentation
    url: https://www.health-samurai.io/docs/aidbox/api-1/bulk-api/export
- aid: aidbox:aidbox-subscriptions-api
  name: Aidbox Topic-Based Subscriptions API
  description: FHIR topic-based Subscriptions that deliver notifications on changes to FHIR resources through multiple channels
    for event-driven healthcare integrations.
  humanURL: https://www.health-samurai.io/docs/aidbox/modules/topic-based-subscriptions
  baseURL: https://sandbox.aidbox.app
  tags:
  - Healthcare
  - Subscriptions
  - Notifications
  properties:
  - type: Documentation
    url: https://www.health-samurai.io/docs/aidbox/modules/topic-based-subscriptions
- aid: aidbox:aidbox-terminology-api
  name: Aidbox Terminology API
  description: Terminology services for working with FHIR CodeSystems, ValueSets, and ConceptMaps, including validation and
    lookup against clinical terminologies.
  humanURL: https://www.health-samurai.io/docs/aidbox/modules/terminology
  baseURL: https://sandbox.aidbox.app
  tags:
  - Healthcare
  - Terminology
  properties:
  - type: Documentation
    url: https://www.health-samurai.io/docs/aidbox/modules/terminology
common:
- type: DomainSecurity
  url: security/aidbox-domain-security.yml
- type: Website
  url: https://www.health-samurai.io/
- type: DeveloperPortal
  url: https://www.health-samurai.io/docs/aidbox
- type: Documentation
  url: https://www.health-samurai.io/docs/aidbox
- type: APIReference
  url: https://www.health-samurai.io/docs/aidbox/api-1/api
- type: GettingStarted
  url: https://www.health-samurai.io/docs/aidbox/getting-started
- type: Pricing
  url: https://www.health-samurai.io/docs/aidbox/getting-started/editions-and-pricing
- type: Blog
  url: https://www.health-samurai.io/blog
- type: StatusPage
  url: https://status.aidbox.app/
- type: GitHubOrganization
  url: https://github.com/Aidbox
- type: LinkedIn
  url: https://www.linkedin.com/company/health-samurai/
- type: Security
  url: https://www.health-samurai.io/docs/aidbox/modules/security-and-access-control
- type: PrivacyPolicy
  url: https://www.health-samurai.io/legal/privacy-policy
- type: SMARTConfiguration
  url: fhir/aidbox-smart-configuration.json
- type: OpenIDConfiguration
  url: fhir/aidbox-openid-configuration.json
- type: CapabilityStatement
  url: fhir/aidbox-capabilitystatement.json
- type: Support
  url: https://www.health-samurai.io/contacts
- type: SignUp
  url: https://aidbox.app/
- type: Compliance
  url: https://www.health-samurai.io/fhir-server
- type: Authentication
  url: authentication/aidbox-authentication.yml
- type: OAuthScopes
  url: scopes/aidbox-scopes.yml
- type: Conformance
  url: conformance/aidbox-conformance.yml
- type: Conventions
  url: conventions/aidbox-conventions.yml
- type: Idempotency
  url: conventions/aidbox-conventions.yml
- type: ErrorCatalog
  url: errors/aidbox-problem-types.yml
- type: Lifecycle
  url: lifecycle/aidbox-lifecycle.yml
- type: Deprecation
  url: https://www.health-samurai.io/docs/aidbox/overview/release-notes
- type: ChangeLog
  url: changelog/aidbox-changelog.yml
- type: Packages
  url: packages/aidbox-packages.yml
- type: SDKs
  url: packages/aidbox-packages.yml
- type: MCPServer
  url: mcp/aidbox-mcp.yml
- type: ToolCrosswalk
  url: mcp/aidbox-tool-crosswalk.yml
- type: AgentSkill
  url: skills/_index.yml
- type: Webhooks
  url: asyncapi/aidbox-subscriptions-webhooks.yml
- type: Sandbox
  url: sandbox/aidbox-sandbox.yml
- type: DataModel
  url: data-model/aidbox-data-model.yml
- type: WellKnown
  url: well-known/aidbox-well-known.yml
- type: LLMsTxt
  url: llms/aidbox-llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

Aidbox

Kin Score

APIs 7

Aidbox FHIR API

Aidbox REST & Search API

Aidbox SQL-on-FHIR API

Aidbox GraphQL API

Aidbox Bulk Data API

Aidbox Topic-Based Subscriptions API

Aidbox Terminology API