PHPackages                             hireatlas/super-funds - 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. hireatlas/super-funds

ActiveLibrary[API Development](/categories/api)

hireatlas/super-funds
=====================

Pull the latest list of superannuation funds directly from the Australian Government, right into your Laravel application.

1.0.0(2y ago)16MITPHP

Since Dec 5Pushed 2y ago1 watchersCompare

[ Source](https://github.com/hireatlas/super-funds)[ Packagist](https://packagist.org/packages/hireatlas/super-funds)[ RSS](/packages/hireatlas-super-funds/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (7)Versions (2)Used By (0)

Fetch the list of Australian superannuation funds straight from the government
==============================================================================

[](#fetch-the-list-of-australian-superannuation-funds-straight-from-the-government)

[![GitHub Tests Action Status](https://camo.githubusercontent.com/bd50dc29ed4be89478f586601fb9c8400b8e3d3034e0f549f0c4815809ecd31a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6869726561746c61732f73757065722d66756e64732f72756e2d74657374732e796d6c)](https://github.com/hireatlas/super-funds/actions?query=workflow%3Arun-tests+branch%3Amaster)[![Latest Version on Packagist](https://camo.githubusercontent.com/67ace25aea488e9ea31a5826d4ce67fe4e4fea4d8851cda32c10e1624caf2762/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6869726561746c61732f73757065722d66756e64732e737667)](https://packagist.org/packages/hireatlas/super-funds)[![Total Downloads](https://camo.githubusercontent.com/dbba34b7f9b5d4bb062e97cd5da071e6ecfe279934ee664fafabe5ace902c582/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6869726561746c61732f73757065722d66756e64732e737667)](https://packagist.org/packages/hireatlas/super-funds)

This package is a fairly lightweight Laravel wrapper around the service provided by the Australian government that lists all superannuation funds and products by their identifier (USI).

You can find the download [here](https://superfundlookup.gov.au/Tools/DownloadUsiList?download=usi), and structural information about the download [here](https://superfundlookup.gov.au/Tools/DownloadUsiList).

We download the text file from this URL, then parse it into some DTOs which you can then save in your database, or use however you wish.

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

[](#installation)

```
composer require hireatlas/super-funds
```

This package supports Laravel 10+, and PHP 8.1+.

Usage
-----

[](#usage)

### Fetching the list of super funds as DTOs

[](#fetching-the-list-of-super-funds-as-dtos)

To fetch the list of current super funds, you can call the `fetch()` method on the `SuperFunds` class. This will return a Collection of `SuperFundDTO` objects.

```
use Atlas\SuperFunds\SuperFunds;

/** @var SuperFunds $superFundsFetcher */
$superFundsFetcher = app(SuperFunds::class);

$superFunds = $superFundsFetcher->fetch();

dd($superannuationFunds);
```

### Persisting the list of super funds as Eloquent models to your database

[](#persisting-the-list-of-super-funds-as-eloquent-models-to-your-database)

The package publishes a migration to store the super funds as Eloquent models in your database, so be sure to run `php artisan migrate` first before running the below.

To fetch and persist the list of current super funds to the database, you can call the `persist()` method on the `SuperFunds` class.

```
use Atlas\SuperFunds\SuperFunds;

/** @var SuperFunds $superFundsFetcher */
$superFundsFetcher = app(SuperFunds::class);

$superannuationFunds = $superFundsFetcher->persist();

dd($superannuationFunds);
```

### Using a custom Eloquent model

[](#using-a-custom-eloquent-model)

You can use a custom Eloquent model by calling the `useModel()` method on the `SuperFunds` class. You should call this from the `boot()` method in your `App\Providers\AppServiceProvider`.

```
use App\Models\SuperFund as CustomSuperFundModel;
use Atlas\SuperFunds\SuperFunds;

public function boot() {
    SuperFunds::useModel(CustomSuperFundModel::class);
}
```

### Disabling migrations

[](#disabling-migrations)

If you don't wish to use the default migration, or don't wish to persist models at all, then you can call the `ignoreMigrations()` method on the `SuperFunds` class. You should call this from the `boot()` method in your `App\Providers\AppServiceProvider`.

```
use Atlas\SuperFunds\SuperFunds;

public function boot() {
    SuperFunds::ignoreMigrations();
}
```

### Regularly fetching the current list via task scheduling

[](#regularly-fetching-the-current-list-via-task-scheduling)

The package includes both a command and a job for you to invoke from your `App\Console\Kernel`. They're equivalent, so use whichever method your prefer.

To avoid overloading the upstream service, please pick a random time of the day to fetch the list.

```
use Atlas\SuperFunds\Jobs\UpdateSuperFunds;

$schedule->command('super-funds:update')->dailyAt('01:23');
// OR
$schedule->job(new UpdateSuperFunds)->dailyAt('01:23');
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Mitchell Davis](https://github.com/mitchdav)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

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

Unknown

Total

1

Last Release

890d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/12d90228bd4fe97ca6509022b1933a49ff1eb86f5699e04c5aadd1cd160bbb07?d=identicon)[mitchdav](/maintainers/mitchdav)

---

Top Contributors

[![mitchdav](https://avatars.githubusercontent.com/u/3215585?v=4)](https://github.com/mitchdav "mitchdav (26 commits)")

---

Tags

australiafinancefinancesfundslaravelphpsuperannuation

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/hireatlas-super-funds/health.svg)

```
[![Health](https://phpackages.com/badges/hireatlas-super-funds/health.svg)](https://phpackages.com/packages/hireatlas-super-funds)
```

###  Alternatives

[spatie/laravel-query-builder

Easily build Eloquent queries from API requests

4.4k26.9M220](/packages/spatie-laravel-query-builder)[essa/api-tool-kit

set of tools to build an api with laravel

52680.5k](/packages/essa-api-tool-kit)[flat3/lodata

OData v4.01 Producer for Laravel

96320.9k](/packages/flat3-lodata)[simplestats-io/laravel-client

Client for SimpleStats!

4515.5k](/packages/simplestats-io-laravel-client)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1344.8k1](/packages/jasara-php-amzn-selling-partner-api)

PHPackages © 2026

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