Usein kysytyt kysymykset

Virallisista rekistereistä ja julkaisuista: Handelsregisteristä (kaupparekisteri), Unternehmensregisteristä (yritysrekisteri) tilinpäätöksineen sekä maksukyvyttömyyskuulutuksista. Uutiset ja verkkosivujen sisältö tulevat verkosta. Lisää kohdassa Datan saatavuus.

Luemme monet yksityiskohdat automaattisesti julkaistuista asiakirjoista ja kuulutuksista. Käytämme siihen uusinta tekniikkaa ja panostamme paljon laatuun; yksittäiset virheet ovat silti mahdollisia.

Yritysprofiili tulee tietokannastamme. Reaaliajalla API hakee tiedot myös suoraan Handelsregisteristä ja palauttaa tällä hetkellä rekisteröidyt henkilöt. Asiakirjat API hakee rekisteristä silloin, kun pyydät niitä.

Jos sama asiakirja on haettu hetkeä aiemmin, se voi olla enintään 24 tuntia vanha.

Yritysten on julkaistava tilinpäätöksensä viimeistään kahdentoista kuukauden kuluttua tilinpäätöspäivästä, ja moni käyttää koko ajan. Uusin tilinpäätös koskee siksi usein toissa vuotta.

Yleensä siksi, ettei yrityksen tarvitse julkaista sitä. Julkisuus riippuu yhtiömuodosta ja koosta: pieni GmbH ei esimerkiksi julkaise tuloslaskelmaa, joten sille ei yleensä ole liikevaihtoa. Tyhjät arvot näkyvät vastauksessa muodossa null tai [].

Nimellä, joka on usealla yrityksellä, API voi palauttaa yhden niistä, ei välttämättä tarkoittamaasi, tai vastata 404. Jos tarvitset tarkkuutta, hae rekisterituomioistuimella ja rekisterinumerolla, esimerkiksi ”Ansbach HRB 6089”, tai entity_id:llä. Pelkkä rekisterinumero ei riitä, koska sama numero on käytössä monessa tuomioistuimessa.

Ei. Ominaisuus veloitetaan vain, kun se palauttaa dataa. AI-tila sen sijaan veloitetaan, vaikka se ei löytäisi yritystä. Vain jos API keskeyttää pyynnön vastauksella 408, sitä ei veloiteta. Reaaliaika maksaa krediittejä jokaisesta onnistuneesta suorasta hausta, vaikka se ei näyttäisi mitään uutta.

Ei mitään. Virheeseen päättyvää pyyntöä ei veloiteta; ainoa poikkeus on AI-tilan lisämaksu. Tilakoodilla 402 meta.request_credit_cost kertoo, paljonko pyyntö olisi enintään maksanut. Lisää kohdassa Virheet.

Et. Yritysprofiileja, Haku & vientiä, asiakirjoja ja Signalsia voit käyttää millä tahansa tilillä; maksat vain krediitit. Krediittitilaus avaa lisää dataa:

• Plus: henkilöprofiili.
• Pro: laajennetut taloudelliset tunnusluvut, ominaisuus Yritysverkosto, hakusuodattimet omistukselle, johdolle ja maksukyvyttömyydelle sekä Signals-aihe Maksukyvyttömyydet.
• Max: kaikki Pron sisältö sekä ominaisuus Syvät osakastiedot, energiayhtiöiden toimintokohtaiset tilinpäätökset ja Signals-aihe Rakennejärjestelyt & M&A.

Kaikki hinnoista ja tilauksista kohdassa Laskutus.

Uusi tili saa 150 aloituskrediittiä. Ilman krediittitilausta aloituskrediitit ja lisäkrediitit ovat voimassa 30 päivää. Niin kauan kuin krediittitilaus on voimassa, ne eivät vanhene.

Reaaliajalle, henkilöprofiileille ja asiakirjoille vähintään 120 sekuntia, koska nämä pyynnöt kestävät kauemmin. Jos Reaaliajalla vain suora haku epäonnistuu, saat tallennetut tiedot ilman Reaaliajan lisämaksua. Jos pyyntö kestää liian kauan, se päättyy vastaukseen 408, asiakirjoilla 504. Silloin mitään ei veloiteta. Yritä myöhemmin uudelleen.

Yritysprofiileja 60 pyyntöä minuutissa tiliä kohden, asiakirjoja 5. Sen ylittyessä API vastaa tilakoodilla 429 ja kertoo odotusajan headerissa Retry-After. Kaikki rajat ovat kohdassa Rajat.

Voit, yritysprofiileille, henkilöprofiileille, haulle ja asiakirjoille. Lähetä oma arvosi headerissa Idempotency-Key. Jos toistat pyynnön samalla avaimella ja samoilla parametreilla 24 tunnin sisällä, se ei maksa mitään.

Voit. Kohdassa Tili › API-avaimet luot lisää avaimia, esimerkiksi yhden sovellusta kohden. Jos poistat avaimen, se lakkaa toimimasta heti. Kaikki avaimet käyttävät tilisi yhteistä saldoa.