Recherche Entreprises Bundle Laravel Package

Product Decisions This Supports

• Build vs. buy for French company data: This package wraps the public API Recherche d'entreprises (government open data), so it removes the need to hand-roll an API client for SIREN/SIRET lookups, legal-form normalization, and now dirigeants (company officers/directors). That directly supports "buy/adopt small, build the differentiator" decisions.
• KYB / compliance and onboarding roadmaps: The v0.1.1 addition of dirigeants unlocks beneficial-owner-style screens, signatory verification, and "who runs this company" UI — a common requirement in B2B onboarding, invoicing, and fraud checks. This is the first release where the package plausibly covers a KYB flow end-to-end, not just company identity.
• Data-correctness dependency: The isAssociation fix signals that downstream logic (association vs. commercial entity handling) was previously wrong. If any roadmap item branches on legal status (pricing, tax treatment, contract templates), this release reduces the risk of shipping on bad data.
• Roadmap sequencing: A pre-1.0 package with CI now in place is a credible candidate for a paid pilot or internal tooling. It is not yet a candidate for an un-gated critical path — plan a spike, not a commitment.
• Scope boundaries: The package only reads public registry data. It does not give you financials, scoring, sanctions/PEP screening, or document verification — those remain build-or-buy decisions with other vendors.

When to Consider This Package

Adopt when:

• Your product serves French entities and needs company lookup, legal form, or officer names.
• You are on PHP/Symfony (this is a Symfony bundle — Laravel teams should budget for an adapter or a thin wrapper around the underlying API rather than expecting a drop-in service provider).
• You need officer/director data — genuinely new as of v0.1.1, and the main reason to re-evaluate now.
• You want a fast prototype of KYB/onboarding flows against free public data before committing to a commercial provider.

Look elsewhere when:

• You need guaranteed SLAs, uptime, or support contracts — this is a 0.1.x community package with no support commitment; the underlying API is a public service with its own rate limits and availability characteristics.
• You need non-French or cross-border company coverage, financial statements, or screening lists.
• You require stable public API surface — pre-1.0 means breaking changes are normal and expected; the isAssociation fix in a patch release is itself evidence of evolving contracts.
• Your stack is Laravel-first and you want zero adaptation work.

Watch items before adopting: the release history shows only two contributors and three PRs total, so bus factor is 1–2 people. Mitigate with an abstraction layer over the client so the dependency is swappable.

How to Pitch It (Stakeholders)

To executives: v0.1.1 of this open-source PHP component lets us look up French companies and — new in this release — their directors, using free government data instead of a paid vendor. It's a low-cost way to prototype B2B onboarding and compliance checks and validate demand before we sign a contract. Treat it as a cheap experiment, not infrastructure: no support, no SLA, very early stage, and a small contributor base.

To engineering: It's a thin Symfony bundle over the public Recherche d'entreprises API. This release adds dirigeants, corrects a wrong isAssociation value, and — importantly — adds CI, which is the first real quality signal. Still 0.1.x, so expect breaking changes; wrap it behind our own interface so we can swap to a commercial KYB provider (or a direct HTTP client if we're on Laravel) without touching product code. Recommend a short spike to confirm field coverage and API rate limits before we put it in a customer-facing path.

Recommendation: Re-evaluate, don't commit. Reopen the build-vs-buy decision after we've run a 1–2 week spike on real French customer data and stress-tested the underlying API's limits.