PHPackages oi-lab/oi-laravel-insee - 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. oi-lab/oi-laravel-insee ActiveLibrary[API Development](/categories/api) oi-lab/oi-laravel-insee ======================= Laravel package for INSEE SIRENE API integration v1.0.3(3w ago)0544↓92.2%MITPHPPHP ^8.2 Since Apr 16Pushed 3w agoCompare [ Source](https://github.com/oi-lab/oi-laravel-insee)[ Packagist](https://packagist.org/packages/oi-lab/oi-laravel-insee)[ RSS](/packages/oi-lab-oi-laravel-insee/feed)WikiDiscussions main Synced 1w ago READMEChangelog (1)Dependencies (6)Versions (5)Used By (0) [![OI Laravel INSEE](./assets/github-preview.png)](./assets/github-preview.png) OI Laravel INSEE ================ [](#oi-laravel-insee) [![Latest Version on Packagist](https://camo.githubusercontent.com/7e039f05207874a8fdbc40bfdf31f628d24e8af8955587f8f1dab2eb960befbb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f692d6c61622f6f692d6c61726176656c2d696e7365652e737667)](https://packagist.org/packages/oi-lab/oi-laravel-insee)[![Total Downloads](https://camo.githubusercontent.com/7d398ab8ab8cddaf691f12cf5f67776c3eb9ae96761fe4ebcd0c91a01d3cc4c1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f692d6c61622f6f692d6c61726176656c2d696e7365652e737667)](https://packagist.org/packages/oi-lab/oi-laravel-insee)[![Tests](https://camo.githubusercontent.com/9cac69b369a794a26b625217f095840eeec1be30f09a69f7fb301b06d1269c18/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6f692d6c61622f6f692d6c61726176656c2d696e7365652f74657374732e796d6c3f6c6162656c3d7465737473)](https://github.com/oi-lab/oi-laravel-insee/actions)[![License](https://camo.githubusercontent.com/0a49041733002cd96ff1e5b840082f2a3b81e842bd63238ea6bac0fba4d4778a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6f692d6c61622f6f692d6c61726176656c2d696e736565)](LICENSE) A Laravel package for integrating with the French INSEE SIRENE API to retrieve company and establishment information. Installation ------------ [](#installation) You can install the package via composer: ``` composer require oi-lab/oi-laravel-insee ``` Configuration ------------- [](#configuration) Publish the configuration file: ``` php artisan vendor:publish --tag=oi-laravel-insee-config ``` Add your INSEE API credentials to your `.env` file: ``` INSEE_CLIENT_SECRET=your-insee-api-key INSEE_CLIENT_ID=your-client-id # Optional, for OAuth authentication INSEE_BASE_URL=https://api.insee.fr/api-sirene/3.11 # Optional INSEE_CACHE_DURATION=23 # Optional, in hours ``` You can obtain your API credentials from [INSEE API Portal](https://portail-api.insee.fr/). Usage ----- [](#usage) ### Using the Facade [](#using-the-facade) ``` use OiLab\OiLaravelInsee\Facades\Insee; // Find establishment by SIRET $establishment = Insee::findSiret('12345678901234'); // Find company by SIREN $company = Insee::findSiren('123456789'); // Search companies $companies = Insee::searchCompanies([ 'q' => 'denomination:ACME' ]); // Search establishments $establishments = Insee::searchEstablishments([ 'q' => 'denominationUniteLegale:ACME' ]); // Get API status $status = Insee::getApiStatus(); ``` ### Using Dependency Injection [](#using-dependency-injection) ``` use OiLab\OiLaravelInsee\Client; class CompanyController extends Controller { public function __construct(private Client $insee) { } public function show(string $siret) { $establishment = $this->insee->findSiret($siret); return view('company.show', compact('establishment')); } } ``` ### Using the Helper [](#using-the-helper) ``` $client = app('insee'); $result = $client->findSiret('12345678901234'); ``` Available Methods ----------------- [](#available-methods) ### `findSiret(string $siret): array` [](#findsiretstring-siret-array) Retrieve information about an establishment using its SIRET number (14 digits). ``` $establishment = Insee::findSiret('12345678901234'); ``` ### `findSiren(string $siren): array` [](#findsirenstring-siren-array) Retrieve information about a company using its SIREN number (9 digits). ``` $company = Insee::findSiren('123456789'); ``` ### `searchCompanies(array $params): array` [](#searchcompaniesarray-params-array) Search for companies using query parameters. ``` $companies = Insee::searchCompanies([ 'q' => 'denomination:ACME AND categorieJuridiqueUniteLegale:5499', 'nombre' => 20, 'debut' => 0 ]); ``` Common search parameters: - `q`: Search query (use field:value format) - `nombre`: Number of results (default: 20, max: 1000) - `debut`: Starting position for pagination ### `searchEstablishments(array $params): array` [](#searchestablishmentsarray-params-array) Search for establishments using query parameters. ``` $establishments = Insee::searchEstablishments([ 'q' => 'denominationUniteLegale:ACME AND codePostalEtablissement:75001', 'nombre' => 20 ]); ``` ### `getApiStatus(): array` [](#getapistatus-array) Get the current status of the INSEE API. ``` $status = Insee::getApiStatus(); ``` Search Query Syntax ------------------- [](#search-query-syntax) The INSEE API uses a specific query syntax for searches: ``` // Single field search 'q' => 'denomination:ACME' // Multiple criteria with AND 'q' => 'denomination:ACME AND codePostalEtablissement:75001' // Multiple criteria with OR 'q' => 'codePostalEtablissement:75001 OR codePostalEtablissement:75002' // Wildcard search 'q' => 'denomination:ACM*' ``` ### Common Search Fields [](#common-search-fields) **For companies (SIREN):** - `siren`: SIREN number - `denomination`: Company name - `categorieJuridiqueUniteLegale`: Legal category - `activitePrincipaleUniteLegale`: Main activity code (NAF/APE) **For establishments (SIRET):** - `siret`: SIRET number - `denominationUniteLegale`: Company name of the legal unit - `codePostalEtablissement`: Postal code - `activitePrincipaleEtablissement`: Main activity code - `etatAdministratifEtablissement`: Administrative status (A=active, F=closed) Response Format --------------- [](#response-format) All methods return arrays containing the API response. Successful responses include: ``` [ 'header' => [ 'statut' => 200, 'message' => 'OK' ], 'etablissement' => [...], // for findSiret 'uniteLegale' => [...], // for findSiren // or 'etablissements' => [...], // for searchEstablishments 'unitesLegales' => [...] // for searchCompanies ] ``` ### Dirigeant (Natural Persons Only) [](#dirigeant-natural-persons-only) For natural persons (entrepreneur individuel, micro-entrepreneur, EIRL), the package automatically injects a `dirigeant` key into every `uniteLegale` node of the response: ``` $result = Insee::findSiren('123456789'); $result['uniteLegale']['dirigeant']; // [ // 'nom' => 'DUPONT', // nomUniteLegale (birth name) // 'nomUsage' => 'MARTIN', // nomUsageUniteLegale (married/usage name, may be null) // 'prenom' => 'Jean', // prenomUsuelUniteLegale, falls back to prenom1UniteLegale // 'sexe' => 'M', // 'M' or 'F' // ] ``` The `dirigeant` key is injected at the same locations across all endpoints: - `findSiret` → `etablissement.uniteLegale.dirigeant` - `findSiren` → `uniteLegale.dirigeant` - `searchCompanies` → `unitesLegales[].dirigeant` - `searchEstablishments` → `etablissements[].uniteLegale.dirigeant` **Important limitation:** the INSEE Sirene API does not expose director information for legal entities (SAS, SARL, SCI, associations…). For those, the `dirigeant` key is **not** injected — the original response is returned unchanged. To retrieve directors of legal entities, you need a complementary source such as the [Recherche d'entreprises API](https://recherche-entreprises.api.gouv.fr/) (which aggregates INPI/RNE data). Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. When contributing: 1. Write tests for new features 2. Ensure all tests pass: `vendor/bin/pest` 3. Follow existing code style 4. Update documentation as needed License ------- [](#license) This package is open-source software licensed under the [MIT license](LICENSE). Credits ------- [](#credits) **[Olivier Lacombe](https://www.olacombe.com)** - Creator and maintainer Olivier is a Product & Technology Director based in Montpellier, France, with over 20 years of experience innovating in UX/UI and emerging technologies. He specializes in guiding enterprises toward cutting-edge digital solutions, combining user-centered design with continuous optimization and artificial intelligence integration. **Projects & Resources:** - [OnAI](https://onai.olacombe.com) - Training courses and masterclasses on generative AI for businesses - [Promptr](https://promptr.olacombe.com) - Prompt engineering Management Platform Support ------- [](#support) For support, please open an issue on the [GitHub repository](https://github.com/oi-lab/oi-laravel-insee/issues). ### Health Score 45 — FairBetter than 91% of packages Maintenance95 Actively maintained with recent releases Popularity18 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 ~9 days Total 4 Last Release 24d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/369876?v=4)[Olivier Lacombe](/maintainers/olacombe)[@olacombe](https://github.com/olacombe) --- Top Contributors [![olacombe](https://avatars.githubusercontent.com/u/369876?v=4)](https://github.com/olacombe "olacombe (7 commits)") ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/oi-lab-oi-laravel-insee/health.svg) ``` [![Health](https://phpackages.com/badges/oi-lab-oi-laravel-insee/health.svg)](https://phpackages.com/packages/oi-lab-oi-laravel-insee) ``` ### Alternatives [spatie/laravel-responsecache Speed up a Laravel application by caching the entire response 2.8k8.7M64](/packages/spatie-laravel-responsecache)[psalm/plugin-laravel Psalm plugin for Laravel 3325.1M337](/packages/psalm-plugin-laravel)[defstudio/telegraph A laravel facade to interact with Telegram Bots 815320.5k3](/packages/defstudio-telegraph)[simplestats-io/laravel-client Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof. 5019.3k](/packages/simplestats-io-laravel-client)[jasara/php-amzn-selling-partner-api A fluent interface for Amazon's Selling Partner API in PHP 1348.1k1](/packages/jasara-php-amzn-selling-partner-api) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)