NAME

WebService::KvKAPI - Query the Dutch Chamber of Commerence (KvK) API

VERSION

version 0.101

SYNOPSIS

use WebService::KvKAPI;
my $api = WebService::KvKAPI->new(
    api_key => 'foobar',
    # optional
    api_host => 'foo.bar', # send the request to a different host
    spoof => 1, # enable spoof mode, uses the test api of the KvK

);

$api->search(%args);
$api->get_location_profile($location_number);
$api->get_basic_profile($kvk_number);
$api->get_owner($kvk_number);
$api->get_main_location($kvk_number);
$api->get_locations($kvk_number);

DESCRIPTION

Query the KvK API via their OpenAPI definition.

ATTRIBUTES

api_key

The KvK API key. You can request one at https://developers.kvk.nl/.

client

An OpenAPI::Client object. Build for you.

api_host

Optional API host to allow overriding the default host api.kvk.nl.

METHODS

has_api_host

Check if you have an API host set or if you use the default. Publicly available for those who need it.

See "search" in WebService::KvKAPI::Search for more information.

get_basic_profile

See "get_basic_profile" in WebService::KvKAPI::BasicProfile for more information.

get_owner

See "get_owner" in WebService::KvKAPI::BasicProfile for more information.

get_main_location

See "get_main_location" in WebService::KvKAPI::BasicProfile for more information.

get_locations

See "get_locations" in WebService::KvKAPI::BasicProfile for more information.

get_location_profile

See "get_location_profile" in WebService::KvKAPI::LocationProfile for more information.

SSL certificates

The KvK now uses private root certificates, please be aware of this. See the KvK developer portal for more information about this.

AUTHOR

Wesley Schwengle <wesley@mintlab.nl>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018 by Mintlab / Zaaksysteem.nl.

This is free software, licensed under:

The European Union Public License (EUPL) v1.1