Aidbox website screenshot

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 33 more developer resources.

🌐 Visit website 📡 Source on GitHub
56.1/100 strong ▬ flat Agent 53/100 agent native Full breakdown ↓
scored 2026-08-17 · rubric v0.11.0
7 APIs 1 MCP Servers
HealthcareUnited StatesFHIRHL7InteroperabilitySMART on FHIREHRHealth DataFHIR ServerBulk DataTerminologyDigital Health

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-17 · rubric v0.11.0
Composite quality — 56.1/100 · strong
Contract Quality 11.7 / 21
Developer Ergonomics 12.8 / 17
Commercial Clarity 7.2 / 17
Operational Transparency 7.0 / 11
Governance 1.3 / 10
Discoverability 6.9 / 9
Regulatory Posture 9.2 / 15
Agent readiness — 53/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 0 / 10
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 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Regulatory Posture applies to this provider. Its tags matched the Health regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
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.

Aidbox FHIR API

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 FH...

Aidbox REST & Search API

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...

Aidbox SQL-on-FHIR API

SQL-on-FHIR support that lets clients run SQL queries directly against FHIR data, treating FHIR resources as relational tables for analytics and reporting.

Aidbox GraphQL API

A GraphQL API over FHIR data that lets clients request exactly the data they need across related resources in a single call.

Aidbox Bulk Data API

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.

Aidbox Topic-Based Subscriptions API

FHIR topic-based Subscriptions that deliver notifications on changes to FHIR resources through multiple channels for event-driven healthcare integrations.

Aidbox Terminology API

Terminology services for working with FHIR CodeSystems, ValueSets, and ConceptMaps, including validation and lookup against clinical terminologies.

Scroll for all 7

MCP Servers 1

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

aidbox-mcp.yml

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Aidbox Plans Pricing

0 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Aidbox Rate Limits

0 limits

RATE LIMITS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Aidbox Subscriptions Webhooks

ASYNCAPI

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Aidbox Authentication

oauth2/openIdConnect/http · 3 schemes

SECURITY

Aidbox Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

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
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp
 Sandbox
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
MCPServer
 AgentSkill
AgentSkill
 WellKnown
WellKnown
 LLMsTxt
LLMsTxt

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Conformance
Conformance
 Conventions
Conventions
 Idempotency
Idempotency
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 Webhooks
Webhooks
 DataModel
DataModel

Scroll for all 7

Build 4

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 Packages
Packages
 SDKs
SDKs
 ToolCrosswalk
ToolCrosswalk

Access & Security 5

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Security
Security
 Compliance
Compliance
 Authentication
Authentication
 OAuthScopes
OAuthScopes

Operate 5

Status, limits, changes, and where to get help

StatusPage
StatusPage
 Support
Support
 Deprecation
Deprecation
 ChangeLog
ChangeLog
 RateLimits
RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 PrivacyPolicy
PrivacyPolicy
 Plans
Plans

Company 3

The organization behind the API

Website
Website
 Blog
Blog
 LinkedIn
LinkedIn

Other 3

Properties that don't map to a standard resource type

SMARTConfiguration
SMARTConfiguration
 OpenIDConfiguration
OpenIDConfiguration
 CapabilityStatement
CapabilityStatement

Source (apis.yml)

apis.yml Raw ↑ 
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-08-14'
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
- type: RateLimits
  url: rate-limits/aidbox-rate-limits.yml
- type: Plans
  url: plans/aidbox-plans-pricing.yml
x-enrichment:
  date: '2026-08-14'
  status: enriched
  artifacts_added: 3
  pass: local-v1
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com