Webservice

Via de web services van Bedrijfsbeeindigingen.com kunt u uw eigen software koppelen aan onze database en direct de status van uw klanten opvragen.
Wij maken gebruik van JSON. Via een POST request kunt u een of meerdere KVK-nummers laten controleren en retourneren wij de status. Indien een klant daadwerkelijk in de database gevonden wordt leveren wij de details van de beëindiging terug.

Het standaard aantal opvragingen is begrensd tot 100 KvK-nummers per dag. Grotere volumes zijn op aanvraag mogelijk.

Onderstaand treft u de documentatie aan. Ontwikkelaars kunnen een testaccount aanvragen via het contactformulier .


Voorbeeld request

curl --request POST \
--header 'Content-Type: application/json' \
--data '{"auth":"«Uw API sleutel»","kvks":["25987412","01234567","36987541","12345678"]}' \
'https://webservice.bedrijfsbeeindigingen.com/'
    

Voorbeeld response


{
    "request_id": "F4t774BLpKyS62fs9mTa",
    "no_results": 2,
    "results": [
    {
        "kvknummer": "01234567",
        "vestigingsnummer": "0654321",
        "bedrijfsnaam": "Voorbeeld BV",
        "adres": "Hoofdweg 7",
        "postcode": "1234BH",
        "plaats": "HAARLEM",
        "beeindigingsdatum": "2016-10-16",
        "reden": "Opheffing (faillissement)"
    },
    {
        "kvknummer": "12345678",
        "vestigingsnummer": "7654321",
        "bedrijfsnaam": "Loodgietersbedrijf Voorbeeld V.O.F.",
        "adres": "Uilenkade 21",
        "postcode": "2409GF",
        "plaats": "ZWIJNDRECHT ",
        "beeindigingsdatum": "2017-02-04",
        "reden": "Opheffing (algemeen)"
    }]
}