PHPackages                             chrisreedio/laravel-athena-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. chrisreedio/laravel-athena-sdk

ActiveLibrary[API Development](/categories/api)

chrisreedio/laravel-athena-sdk
==============================

Provides an interface to Athena EHR's API

v1.9.1(1w ago)22341MITPHPPHP ^8.2CI passing

Since Jan 6Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/chrisreedio/laravel-athena-sdk)[ Packagist](https://packagist.org/packages/chrisreedio/laravel-athena-sdk)[ Docs](https://github.com/chrisreedio/laravel-athena-sdk)[ RSS](/packages/chrisreedio-laravel-athena-sdk/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (66)Versions (79)Used By (0)

Athena EHR API SDK for Laravel
==============================

[](#athena-ehr-api-sdk-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a3ab7e8982a8d392b09239ecbd32b2354244e346b37e030ffbe064e5aa0377a7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636872697372656564696f2f6c61726176656c2d617468656e612d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chrisreedio/laravel-athena-sdk)[![Tests](https://camo.githubusercontent.com/f1f95c3f277f1dfc9d5495598504c32559af2fdf64bcc76ec879b7f4b0b8d4a1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636872697372656564696f2f6c61726176656c2d617468656e612d73646b2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/chrisreedio/laravel-athena-sdk/actions/workflows/run-tests.yml)[![Code Style](https://camo.githubusercontent.com/bf2a27c95747d97f7617c492817c1198face2342134372e51f4d9205021c84e6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636872697372656564696f2f6c61726176656c2d617468656e612d73646b2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d7374796c65267374796c653d666c61742d737175617265)](https://github.com/chrisreedio/laravel-athena-sdk/actions/workflows/fix-php-code-style-issues.yml)[![Total Downloads](https://camo.githubusercontent.com/2239e15ab6bafa678da2f04bd5b4577be5610f4d870d4880b976c30d47b19ddf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636872697372656564696f2f6c61726176656c2d617468656e612d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chrisreedio/laravel-athena-sdk)

`laravel-athena-sdk` is a Laravel-first wrapper around Athenahealth's API. It provides a configured connector, resource-style entry points for common API domains, and DTOs for mapping Athena responses into typed PHP objects.

The package is best suited for applications that want a package-native integration layer instead of building raw Saloon requests and response mapping from scratch.

Installation
------------

[](#installation)

```
composer require chrisreedio/laravel-athena-sdk
```

Publish the package config:

```
php artisan vendor:publish --tag="laravel-athena-sdk-config"
```

Set the required Athena credentials in your environment:

```
ATHENA_BASE_URL=https://api.preview.platform.athenahealth.com
ATHENA_CLIENT_ID=your-client-id
ATHENA_CLIENT_SECRET=your-client-secret
ATHENA_PRACTICE_ID=your-practice-id
ATHENA_LEAVE_UNPROCESSED=false
```

Configuration
-------------

[](#configuration)

The package currently publishes a config file only. There are no package views or package migrations to publish.

The connector also ships with built-in Athena rate limiting using Saloon's rate-limit plugin. All requests are capped per connector instance to 15 requests per second outside `production` and 150 requests per second in `production`. Rate-limit violations fail fast (a `RateLimitReachedException` will be thrown rather than auto-sleeping and retrying).

The connector authenticates with Athena using the client credentials grant flow and caches the access token under the `athena_access_token` cache key.

Usage
-----

[](#usage)

Instantiate the connector directly:

```
use ChrisReedIO\AthenaSDK\AthenaConnector;

$athena = new AthenaConnector();

$appointment = $athena->appointments()->get(
    appointmentId: 123456,
);
```

Or use the facade:

```
use ChrisReedIO\AthenaSDK\Facades\Athena;

$providers = Athena::providers();
```

The top-level resources currently exposed by the connector are:

- `appointments()`
- `departments()`
- `patients()`
- `providers()`
- `referringProviders()`
- `practice()`
- `encounters()`

Public API
----------

[](#public-api)

The supported Laravel-facing wrapper surface is documented in [`docs/public-api.md`](docs/public-api.md).

That document covers:

- the connector and facade entry points
- the resource methods exposed through `AthenaConnector`
- the nested resource helpers exposed from those top-level resources

Raw request classes under `src/Requests` are still available for lower-level use, but they are not the primary API documented in this package.

Local Checks
------------

[](#local-checks)

```
composer test
composer analyse
composer format:test
```

Additional Notes
----------------

[](#additional-notes)

- [`docs/endpoints.md`](docs/endpoints.md) tracks endpoint coverage work still to be validated.
- `composer analyse` runs cleanly and is enforced in CI alongside tests and formatting checks.

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for release history.

Contributing
------------

[](#contributing)

See [CONTRIBUTING.md](CONTRIBUTING.md) for local setup and pull request expectations.

Security
--------

[](#security)

See [SECURITY.md](SECURITY.md) for how to report vulnerabilities.

License
-------

[](#license)

Released under the [MIT license](LICENSE.md).

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance96

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 90.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~18 days

Recently: every ~12 days

Total

51

Last Release

7d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/77644584?v=4)[Chris Reed](/maintainers/chrisreedio)[@chrisreedio](https://github.com/chrisreedio)

---

Top Contributors

[![chrisreedio](https://avatars.githubusercontent.com/u/77644584?v=4)](https://github.com/chrisreedio "chrisreedio (258 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (12 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (8 commits)")[![sc-chgraham](https://avatars.githubusercontent.com/u/97906213?v=4)](https://github.com/sc-chgraham "sc-chgraham (6 commits)")

---

Tags

laravelChris Reedlaravel-athena-sdk

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/chrisreedio-laravel-athena-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/chrisreedio-laravel-athena-sdk/health.svg)](https://phpackages.com/packages/chrisreedio-laravel-athena-sdk)
```

###  Alternatives

[codebar-ag/laravel-docuware

DocuWare integration with Laravel

1123.7k](/packages/codebar-ag-laravel-docuware)[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M100](/packages/dedoc-scramble)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

816333.6k3](/packages/defstudio-telegraph)[codebar-ag/laravel-zammad

Zammad integration with Laravel

107.1k](/packages/codebar-ag-laravel-zammad)[njoguamos/laravel-plausible

A laravel package for interacting with plausible analytics api.

209.6k](/packages/njoguamos-laravel-plausible)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
