Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AWS HealthLake Export API

Asynchronous bulk export operations for exporting FHIR resources to Amazon S3

AWS HealthLake Export API is one of 8 APIs that AWS HealthLake publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Export. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 3 operations across 3 paths, and defines 6 schemas. It is described by OpenAPI 3.0.3, at version 2017-07-01.

Requests are made against a single base URL, https://healthlake.{region}.amazonaws.com.

3 operations 3 paths 6 schemas 3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2017-07-01
Base URL
https://healthlake.us-east-1.amazonaws.com
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

AWS HealthLake Export API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (aws_v4). By default, every request must be authenticated.

  • aws_v4 — AWS Signature Version 4. Sign requests with your AWS access key and secret key. See: https://docs.aws.amazon.com/general/latest/gr/signingawsapirequests.html

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 POST. Each is listed below with its method, path, parameters, and response codes.

Export 3

Asynchronous bulk export operations for exporting FHIR resources to Amazon S3

POST
/#X-Amz-Target=HealthLake.DescribeFHIRExportJob
DescribeFHIRExportJob
describeFHIRExportJob 1 param body → 200400500
POST
/#X-Amz-Target=HealthLake.ListFHIRExportJobs
ListFHIRExportJobs
listFHIRExportJobs 1 param body → 200400500
POST
/#X-Amz-Target=HealthLake.StartFHIRExportJob
StartFHIRExportJob
startFHIRExportJob 1 param body → 200400500

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are ListFHIRExportJobsRequest (7 properties), StartFHIRExportJobRequest (5 properties), StartFHIRExportJobResponse (3 properties), DescribeFHIRExportJobRequest (2 properties). Each schema is shown below with its type and property counts.

StartFHIRExportJobRequest
object
5 properties 4 required
StartFHIRExportJobResponse
object
3 properties 2 required
ListFHIRExportJobsResponse
object
2 properties 1 required
DescribeFHIRExportJobRequest
object
2 properties 2 required
ListFHIRExportJobsRequest
object
7 properties 1 required
DescribeFHIRExportJobResponse
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

aws-healthlake-export-api-openapi.yml Raw ↑

Other APIs AWS HealthLake publishes across the network.

AWS HealthLake FHIR Import API
AWS HealthLake FHIR Export API
AWS HealthLake FHIR R4 Server API
AWS HealthLake Resource Tagging API
AWS HealthLake Datastore API
AWS HealthLake Import API
AWS HealthLake Tags API