PHPackages                             springfieldclinic/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. springfieldclinic/laravel-athena-sdk

ActiveLibrary[API Development](/categories/api)

springfieldclinic/laravel-athena-sdk
====================================

Provides an interface to Athena EHR's API

019PHP

Since May 7Pushed 2w agoCompare

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

READMEChangelogDependenciesVersions (5)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

24

—

LowBetter than 31% of packages

Maintenance63

Regular maintenance activity

Popularity6

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity17

Early-stage or recently created project

 Bus Factor1

Top contributor holds 89.3% 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/97906213?v=4)[Christopher Graham](/maintainers/sc-chgraham)[@sc-chgraham](https://github.com/sc-chgraham)

---

Top Contributors

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

### Embed Badge

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

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

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35916.4M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172445.0k15](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

93459.5k6](/packages/botman-driver-telegram)

PHPackages © 2026

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