PHPackages                             carloeusebi/laravel-registro-sport-e-salute - 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. carloeusebi/laravel-registro-sport-e-salute

ActiveLibrary[API Development](/categories/api)

carloeusebi/laravel-registro-sport-e-salute
===========================================

A Laravel package that provides a simple and elegant wrapper around the Italian "Registro Sport e Salute" API. This package allows you to search and retrieve information about sports organizations registered in the Italian Sports Registry.

v0.5(2mo ago)21.4k↓27.8%MITPHPPHP ^8.4.0CI failing

Since May 27Pushed 2mo agoCompare

[ Source](https://github.com/carloeusebi/laravel-registro-sport-e-salute)[ Packagist](https://packagist.org/packages/carloeusebi/laravel-registro-sport-e-salute)[ Fund](https://www.paypal.com/paypalme/carloeusebi)[ RSS](/packages/carloeusebi-laravel-registro-sport-e-salute/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (22)Versions (9)Used By (0)

[ ![Tests](https://github.com/carloeusebi/laravel-registro-sport-e-salute/actions/workflows/tests.yml/badge.svg)](https://github.com/carloeusebi/laravel-registro-sport-e-salute/actions)[ ![Total Downloads](https://camo.githubusercontent.com/72d9e175cf8fea5d15960393e8e8843682955d72f0edcabea8a84a90ae62ae3d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6361726c6f6575736562692f6c61726176656c2d726567697374726f2d73706f72742d652d73616c757465)](https://packagist.org/packages/carloeusebi/laravel-registro-sport-e-salute)[ ![Latest Version](https://camo.githubusercontent.com/b0355bae78770a48fd0f56c2f54d72c9f1a1cc0981b133da234e1ebc7dd5388c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6361726c6f6575736562692f6c61726176656c2d726567697374726f2d73706f72742d652d73616c757465)](https://packagist.org/packages/carloeusebi/laravel-registro-sport-e-salute)[ ![License](https://camo.githubusercontent.com/10e797e3803adf8095dd6210920bcdda9a59cb648adefc5b170c1fcf7ebb073c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6361726c6f6575736562692f6c61726176656c2d726567697374726f2d73706f72742d652d73616c757465)](https://packagist.org/packages/carloeusebi/laravel-registro-sport-e-salute)Laravel Registro Sport e Salute
===============================

[](#laravel-registro-sport-e-salute)

A Laravel package that provides a simple and elegant wrapper around the Italian "Registro Sport e Salute" API. This package allows you to search and retrieve information about sports organizations registered in the Italian Sports Registry.

Please visit the original [https://registro.sportesalute.eu](https://registro.sportesalute.eu/#/registro).

Table of Contents
-----------------

[](#table-of-contents)

- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
    - [Basic Usage](#basic-usage)
    - [Filtering](#filtering)
    - [Pagination](#pagination)
    - [Order](#order)
    - [Getting Organization Details](#getting-organization-details)
    - [Faking](#faking)
- [Testing](#testing)
- [Contributing](#contributing)
- [License](#license)

Requirements
------------

[](#requirements)

- PHP 8.4 or higher
- Laravel 12.15 or higher

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

[](#installation)

Run the following command to install the latest version of the package:

```
composer require carloeusebi/laravel-registro-sport-e-salute
```

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

```
use CarloEusebi\RegistroSportESalute\Facades\RegistroSportESalute;

// Get organizations (returns a Collection of Organization objects)
$organizations = RegistroSportESalute::get();

// Access organization properties
foreach ($organizations as $organization) {
    echo $organization->getDenominazione(); // Organization name
    echo $organization->getCodiceFiscale(); // Tax code
    echo $organization->getRegioneSedeLegale(); // Region
    echo $organization->getComuneSedeLegale(); // City

    // Convert to array
    $organizationArray = $organization->toArray();
}

RegistroSportESalute::getCount() // The total number of matched records, useful for pagination
```

### Filtering

[](#filtering)

You can filter organizations by name (denominazione) or tax code (codice fiscale):

```
use CarloEusebi\RegistroSportESalute\Facades\RegistroSportESalute;

// Filter by name
$organizations = RegistroSportESalute::filterByDenominazione('Sport Club')->get();

// Filter by tax code
$organizations = RegistroSportESalute::filterByCodiceFiscale('12345678901')->get();

// Chain filters
//💡 Tip: the `builder` method is an eye candy for when you have multiple statements
$organizations = RegistroSportESalute::builder()
    ->filterByDenominazione('Sport Club')
    ->filterByCodiceFiscale('12345678901')
    ->get();
```

The ability to filter by other fields may come in future updates, or if you really really need it you can submit a PR.

### Pagination

[](#pagination)

The API supports pagination:

```
use CarloEusebi\RegistroSportESalute\Facades\RegistroSportESalute;

// Set page (default is 1)
$organizations = RegistroSportESalute::page(2)->get();

// Set page size (default is 10)
$organizations = RegistroSportESalute::page(pageSize: 25)->get();

// Chain with filters
$organizations = RegistroSportESalute::builder()
    ->filterByDenominazione('Sport Club')
    ->page(2, 25)
    ->get();
```

### Order

[](#order)

Order feature is not present. If you need it please create an issue or submit a PR.

### Getting Organization Details

[](#getting-organization-details)

You can get detailed information about a specific organization by its ID:

```
use CarloEusebi\RegistroSportESalute\Facades\RegistroSportESalute;

// Get organization details by ID
$details = RegistroSportESalute::getById(123);

// $details is an associative array with organization details
echo $details['Denominazione'];
echo $details['Codice Fiscale'];
// etc.
```

### Faking

[](#faking)

You can `fake` the facade so you can focus on testing your own code.

```
use CarloEusebi\RegistroSportESalute\Facades\RegistroSportESalute;

RegistroSportESalute::fake(
   count: 2 // how may mock Organizations should return; will return one by default
   shouldThrowHttpException: true, // it should simulate an HttpClientException
);
```

Testing
-------

[](#testing)

This package includes a comprehensive test suite. To run the tests:

```
composer test
```

You can also run specific test suites:

```
# Run only unit tests
composer test:unit

# Check types wit PHPStan
composer test:types

# Check code style with Pint
composer test:lint
```

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

[](#contributing)

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

License
-------

[](#license)

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

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance87

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

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

Every ~42 days

Recently: every ~71 days

Total

8

Last Release

62d ago

### Community

Maintainers

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

---

Top Contributors

[![carloeusebi](https://avatars.githubusercontent.com/u/129429172?v=4)](https://github.com/carloeusebi "carloeusebi (13 commits)")

---

Tags

laravelregistrosalutesportphplaravelregistro-sport-e-salute

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/carloeusebi-laravel-registro-sport-e-salute/health.svg)

```
[![Health](https://phpackages.com/badges/carloeusebi-laravel-registro-sport-e-salute/health.svg)](https://phpackages.com/packages/carloeusebi-laravel-registro-sport-e-salute)
```

###  Alternatives

[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[resend/resend-laravel

Resend for Laravel

1191.4M6](/packages/resend-resend-laravel)[defstudio/pest-plugin-laravel-expectations

A plugin to add laravel tailored expectations to Pest

98548.9k4](/packages/defstudio-pest-plugin-laravel-expectations)[anahkiasen/flickering

A modern interface for the Flickr API

535.9k1](/packages/anahkiasen-flickering)[surface/laravel-webfinger

A Laravel package to create an ActivityPub webfinger.

113.8k](/packages/surface-laravel-webfinger)

PHPackages © 2026

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