athenahealth · Rate Limits
Athena Health Rate Limits
Rate limit policies for athenahealth's API surface. athenahealth applies per-application throttles. Specific quantitative limits are disclosed to registered developers in the portal and may vary by environment, tablespace, and product. The values below are typical for athenaOne integrations; refer to the athenahealth Developer Portal for authoritative limits for your app.
Athena Health Rate Limits is the machine-readable rate-limit profile for athenahealth on the APIs.io network, conforming to the API Commons Rate Limits specification.
The profile also includes 5 backoff/retry policies defined.
Tagged areas include EHR, Electronic Health Records, Healthcare, HL7, and FHIR.
0 Limits
EHRElectronic Health RecordsHealthcareHL7FHIRInteroperabilityPractice ManagementRevenue Cycle ManagementUSCDICures ActSMART on FHIRCDS HooksCloud EHR
Policies
The athenaOne proprietary REST API enforces per-application throttles
against each tablespace (production or preview). Typical default is in
the range of ~10 requests/sec sustained per app per tablespace; exact
limit is disclosed to the developer.
The FHIR R4 endpoints share the same throttling tier as the proprietary
REST surface. SMART Backend Services tokens are scoped to system-level
reads and follow the same per-app quotas.
The athenahealth Event Subscription Platform delivers notifications via
rest-hook. Subscriber webhooks MUST acknowledge with a 2xx response
within a 2-second timeout. Delivery failures are retried with backoff;
persistent failures move the subscription into error status.
Bulk Data Access ($export) is asynchronous. Concurrent job limits are
enforced per application; clients SHOULD respect the Retry-After header
returned with 202 responses and SHOULD NOT poll status more frequently
than once per minute.
OAuth 2.0 token endpoints are subject to anti-abuse throttling. Clients
SHOULD cache access tokens for their full TTL and avoid token churn.