PHPackages                             offline-agency/laravel-bank-of-italy - 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. offline-agency/laravel-bank-of-italy

ActiveLibrary

offline-agency/laravel-bank-of-italy
====================================

A simple Laravel package to information from the Bank of Italy

1.0.1(1y ago)011[1 PRs](https://github.com/offline-agency/laravel-bank-of-italy/pulls)MITPHPPHP >=8.0

Since Sep 11Pushed 11mo ago2 watchersCompare

[ Source](https://github.com/offline-agency/laravel-bank-of-italy)[ Packagist](https://packagist.org/packages/offline-agency/laravel-bank-of-italy)[ Docs](https://github.com/offline-agency/laravel-bank-of-italy)[ RSS](/packages/offline-agency-laravel-bank-of-italy/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (6)Versions (4)Used By (0)

Laravel Bank of Italy
=====================

[](#laravel-bank-of-italy)

[![Latest Stable Version](https://camo.githubusercontent.com/c9f258e20a8c681772479b04d800bb4aff9aee68a99665fb7deba100a76c0848/68747470733a2f2f706f7365722e707567782e6f72672f6f66666c696e652d6167656e63792f6c61726176656c2d62616e6b2d6f662d6974616c792f762f737461626c65)](https://packagist.org/packages/offline-agency/laravel-bank-of-italy)[![MIT Licensed](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/dc250a26998f81883a1564b229992c03c0075352fd62217565098967740d7a6c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f66666c696e652d6167656e63792f6c61726176656c2d62616e6b2d6f662d6974616c792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/offline-agency/laravel-bank-of-italy)[![Laravel Bank of Italy](https://camo.githubusercontent.com/9c821ed9683e79a3c0f8c6432eb4fbb1d95d1bf03fbfd368d3740de0680ad579/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f4c61726176656c25323042616e6b2532306f662532304974616c792e706e673f7468656d653d6461726b267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d6f66666c696e652d6167656e63792532466c61726176656c2d62616e6b2d6f662d6974616c79267061747465726e3d797979267374796c653d7374796c655f31266465736372697074696f6e3d412b73696d706c652b4c61726176656c2b7061636b6167652b746f2b72657472696576652b696e666f726d6174696f6e2b66726f6d2b7468652b42616e6b2b6f662b4974616c79266d643d312673686f7757617465726d61726b3d3126666f6e7453697a653d313030707826696d616765733d63617368)](https://camo.githubusercontent.com/9c821ed9683e79a3c0f8c6432eb4fbb1d95d1bf03fbfd368d3740de0680ad579/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f4c61726176656c25323042616e6b2532306f662532304974616c792e706e673f7468656d653d6461726b267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d6f66666c696e652d6167656e63792532466c61726176656c2d62616e6b2d6f662d6974616c79267061747465726e3d797979267374796c653d7374796c655f31266465736372697074696f6e3d412b73696d706c652b4c61726176656c2b7061636b6167652b746f2b72657472696576652b696e666f726d6174696f6e2b66726f6d2b7468652b42616e6b2b6f662b4974616c79266d643d312673686f7757617465726d61726b3d3126666f6e7453697a653d313030707826696d616765733d63617368)

A simple Laravel package to retrieve information from the Bank of Italy.

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

[](#installation)

You can install the package via composer:

```
composer require offline-agency/laravel-bank-of-italy
```

You need to publish config file with:

```
php artisan vendor:publish --provider="OfflineAgency\LaravelBankOfItaly\LaravelBankOfItalyServiceProvider"
```

Usage
-----

[](#usage)

Currently, the package provides a method to retrieve exchange rates between currencies.

### Basic

[](#basic)

```
$exchange_rate = new ExchangeRate();
$exchange_rates = $exchange_rate->getExchangeRates();

foreach ($exchange_rates->getItems() as $exchange_rate) {
    dd($exchange_rate);
    /*
     OfflineAgency\LaravelBankOfItaly\Entities\ExchangeRate\ExchangeRate {
        +currency: "Dollaro USA"
        +currencyIsoCode: "USD"
        +currencyUicCode: "001"
        +rate: "1.0724"
        +rateConvention: "Quantità di valuta estera per 1 Euro"
        +referenceDate: "Y-m-d"
     }
     */
}
```

In this example, the method `getExchangeRates()` returns an instance of `OfflineAgency\LaravelBankOfItaly\Entities\ExchangeRate\ExchangeRates`. You can use the `getItems()` method to retrieve an array of `ExchangeRate` objects. Each `ExchangeRate` object contains the following properties:

- currency: The name of the currency (e.g., "Dollaro USA")
- currencyIsoCode: The ISO code of the currency (e.g., "USD")
- currencyUicCode: The UIC code of the currency (e.g., "001")
- rate: The exchange rate (e.g., "1.0724")
- rateConvention: The rate convention (e.g., "Quantità di valuta estera per 1 Euro")
- referenceDate: The reference date of the rate (format: Y-m-d)

### Custom Query Parameters

[](#custom-query-parameters)

You can also provide custom query parameters to filter the results. Here are the fields you can specify:

```
$exchange_rate = new ExchangeRate();
$response = $exchange_rate->getExchangeRates([
    'lang' => 'en', // Default: it
    'baseCurrencyIsoCode' => 'EUR', // Default: USD
    'currencyIsoCode' => 'ITL', // Default: EUR (accepted values: EUR, USD, ITL)
    'startDate' => '01-01-2000', // Default: Carbon::now()->subYear() (format: Y-m-d)
    'endDate' => '01-01-2000' // Default: Carbon::now() (format: Y-m-d)
]);
```

### Error Handling

[](#error-handling)

- If there is a validation error, the method returns an instance of `Illuminate\Support\MessageBag`.
- If there is an error during the API call, the method returns an instance of `OfflineAgency\LaravelBankOfItaly\Entities\Error`, which contains an error property.

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security-related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Offline Agency](https://github.com/offline-agency)
- [Giacomo Fabbian](https://github.com/Giacomo92)
- [Nicolas Sanavia](https://github.com/SanaviaNicolas)
- [All Contributors](../../contributors)

About us
--------

[](#about-us)

Offline Agency is a web design agency based in Padua, Italy. You'll find an overview of our projects [on our website](https://offlineagency.it/).

License
-------

[](#license)

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

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance49

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity46

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 ~209 days

Total

2

Last Release

399d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/33f8b76656d71bddf83e5924863f37dea04f3f89196e7fb9cf25e30c3ee27093?d=identicon)[offlineagency](/maintainers/offlineagency)

---

Top Contributors

[![SanaviaNicolas](https://avatars.githubusercontent.com/u/56884198?v=4)](https://github.com/SanaviaNicolas "SanaviaNicolas (11 commits)")

---

Tags

offline-agencylaravel-bank-of-italy

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/offline-agency-laravel-bank-of-italy/health.svg)

```
[![Health](https://phpackages.com/badges/offline-agency-laravel-bank-of-italy/health.svg)](https://phpackages.com/packages/offline-agency-laravel-bank-of-italy)
```

###  Alternatives

[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

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

Recaptcha V3 for Laravel package

2641.6M2](/packages/josiasmontag-laravel-recaptchav3)[aedart/athenaeum

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

255.2k](/packages/aedart-athenaeum)[spatie/laravel-export

Create a static site bundle from a Laravel app

646127.9k5](/packages/spatie-laravel-export)[torchlight/torchlight-laravel

A Laravel Client for Torchlight, the syntax highlighting API.

120452.8k11](/packages/torchlight-torchlight-laravel)[api-platform/laravel

API Platform support for Laravel

59126.4k6](/packages/api-platform-laravel)

PHPackages © 2026

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