Weave Code
Kvk Api Bundle Laravel Package
connectholland/kvk-api-bundle
Symfony bundle for integrating the Dutch KVK API, offering configuration and services to query Chamber of Commerce company data such as profiles and registrations, with straightforward dependency injection setup.
KvK API bundle for Symfony
Frequently asked questions about Kvk Api Bundle
- Can I use connectholland/kvk-api-bundle in a Laravel application?
- Not as a normal Composer dependency. It is a Symfony bundle that relies on Symfony bundle registration, DI extensions, and a configuration tree, which Laravel's container does not understand. You can read it as a reference for KvK endpoints and DTOs, but a Laravel app should use a native service instead.
- How do I install connectholland/kvk-api-bundle?
- It is installed with Composer as connectholland/kvk-api-bundle and enabled through Symfony's bundle registration. The exact registration and configuration steps should be confirmed in the repository README and Resources/config service definitions. There is no Laravel package auto-discovery or service provider for this bundle.
- Does this package support Laravel 10 or Laravel 11?
- No Laravel version support is declared because this is a Symfony bundle, not a Laravel package. Laravel ships some Symfony components, but it does not run the Symfony framework-bundle runtime this package expects. Compatibility depends on PHP and Symfony component constraints, not on a Laravel release.
- Which KvK API endpoints does the bundle cover?
- The package is described as querying Dutch Chamber of Commerce company data such as profiles and registrations. A practical Laravel implementation would likely need search by company name, basisprofiel by KvK number, and vestiging lookup, so verify those against the bundle's service definitions. Do not assume full endpoint coverage without inspecting the code.
- Is there a KvK sandbox or test mode?
- The available assessment does not confirm a documented sandbox mode. It does warn that KvK test and production keys are not interchangeable and that auth behavior is underdocumented. Confirm endpoint and key configuration in the bundle before relying on it for contract tests.
- How does the bundle authenticate with the KvK API?
- Authentication is expected to be configured through the bundle's Symfony configuration, but the exact KvK API version and auth model are not established in the provided context. The assessment specifically flags undocumented behavior around test versus production keys. Treat credentials as environment-scoped secrets and verify against KvK documentation.
- Does it include DTOs, error mapping, retries, and rate-limit handling?
- The assessment says these areas are unknown and may be deferred to the host application. It specifically calls out unknown retry and rate-limit handling and asks whether DTOs and error mapping are implemented. Inspect the code before assuming production-grade resilience.
- Does the bundle contain a framework-agnostic KvK client I can wrap in Laravel?
- That is the key question and it is not answered by the overview. If all logic is bound to Symfony DI, the bundle is only a specification for a Laravel client. If a standalone client exists, you could vendor or wrap it behind an internal interface such as KvkLookup.
- What is the best alternative for Laravel?
- Build a small Laravel-native service using Http::withToken, a config entry in config/services.php, a DTO, and a cache layer. Cover only the read paths you need, such as name search, basisprofiel, and vestiging lookup. Use the bundle only to confirm field names and request shapes.
- Is connectholland/kvk-api-bundle maintained and safe for production?
- The assessment reports zero stars, zero dependents, and no evidence of external production use, so adopters should assume maintenance ownership. There are risks around Symfony and PHP version coupling, license terms, and KvK terms of use for caching company data. Run a spike, pin versions, and isolate the integration behind an internal interface before a pilot.
Weaver
How can I help you explore Laravel packages today?