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.1.0-beta.1(1mo ago)11271[3 PRs](https://github.com/chrisreedio/laravel-athena-sdk/pulls)MITPHPPHP ^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 1mo ago

READMEChangelog (10)Dependencies (32)Versions (56)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 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

45

—

FairBetter than 92% of packages

Maintenance90

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 92% 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 ~21 days

Recently: every ~98 days

Total

38

Last Release

54d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/edf125933a93f1f09822d1679b36b2d6deed75b2380f6e1c57d54cd52a8db29d?d=identicon)[chrisreedio](/maintainers/chrisreedio)

---

Top Contributors

[![chrisreedio](https://avatars.githubusercontent.com/u/77644584?v=4)](https://github.com/chrisreedio "chrisreedio (218 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (8 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

1221.1k](/packages/codebar-ag-laravel-docuware)[codebar-ag/laravel-zammad

Zammad integration with Laravel

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

A laravel package for interacting with plausible analytics api.

208.8k](/packages/njoguamos-laravel-plausible)

PHPackages © 2026

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