Skip to content

omnistate/annuaire-entreprises API reference

Floor
Provider · Omnistate
Version
1.x
Conformance suite
runs, no CI read
Verified for real
Its README does not say
Licence
MIT
composer require omnistate/annuaire-entreprises:1.x-dev

Read from the package's own PHP files at the commit c4be9ec1ff3a: its namespaces, classes, interfaces and enums, their public constants, properties and methods with their PHPDoc, and the options its factories take. Nothing of it is run.

Omnistate\AnnuaireEntreprises

  • AnnuaireEntreprises class

    French companies, from the State's Recherche d'entreprises API - the one behind annuaire-entreprises.data.gouv.fr: INSEE's Sirene and INPI's national register (RNE) together, free and without a key, about seven calls a second. A SIREN gives the company, a SIRET the company with that establishment among its establishments; anything else is searched.

    5 methods · 1 constant

  • Headcounts class

    INSEE's headcount ranges (tranches d'effectif salarié).

    1 method · 1 constant

  • LegalForms class

    INSEE's legal categories (catégories juridiques, level III): the codes a company is registered under, their names and the short names in use. The most common ones: another code keeps its number, without a name.

    1 method · 1 constant

Omnistate\AnnuaireEntreprises

AnnuaireEntreprises class

final class AnnuaireEntreprises implements CompanyRegistryInterface AnnuaireEntreprises.php:32

French companies, from the State's Recherche d'entreprises API - the one behind annuaire-entreprises.data.gouv.fr: INSEE's Sirene and INPI's national register (RNE) together, free and without a key, about seven calls a second. A SIREN gives the company, a SIRET the company with that establishment among its establishments; anything else is searched.

Everything the answer says is mapped - identity, legal form, status, activity, size, head office and establishments with their coordinates, managers, revenue and results by year, labels (ESS, RGE, Qualiopi...), collective agreements - and the VAT number its SIREN makes. The whole answer stays in Company::$raw.

const URL = 'https://recherche-entreprises.api.gouv.fr/search'

AnnuaireEntreprises::__construct()

public function __construct(readonly HttpClientInterface $http, readonly float $timeout = 10)

AnnuaireEntreprises::name()

public function name(): string

AnnuaireEntreprises::supports()

public function supports(string $identifier): bool

AnnuaireEntreprises::company()

public function company(string $identifier): ?Company
public function search(string $query, int $limit = 10): array

Headcounts class

final class Headcounts Headcounts.php:8

INSEE's headcount ranges (tranches d'effectif salarié).

const RANGES = ['NN' => [0, 0], '00' => [0, 0], '01' => [1, 2], '02' => [3, 5], '03' => [6, 9], '11' => [10, 19], '12' => [20, 49], '21' => [50, 99], '22' => [100, 199], '3…

Headcounts::of()

public static function of(?string $code, mixed $year = null): ?Headcount

LegalForms class

final class LegalForms LegalForms.php:12

INSEE's legal categories (catégories juridiques, level III): the codes a company is registered under, their names and the short names in use. The most common ones: another code keeps its number, without a name.

const FORMS = ['1000' => ['Entrepreneur individuel', 'EI'], '2110' => ['Indivision entre personnes physiques', null], '2210' => ['Société créée de fait entre personnes phy…

LegalForms::of()

public static function of(?string $code): ?LegalForm