Vanliga frågor
Svar på det som utvecklare frågar oftast.
Korta svar på de frågor som utvecklare ställer oftast. Detaljerna finns på den länkade sidan.
Data
Var kommer datan ifrån?
Från de officiella registren och publikationerna: Handelsregister (handelsregistret), Unternehmensregister (företagsregistret) med årsboksluten, och insolvenskungörelserna. Nyheter och webbplatsinnehåll kommer från webben. Mer i Datatillgänglighet.
Vi läser många uppgifter automatiskt ur de publicerade dokumenten och kungörelserna. Vi använder den senaste tekniken för detta och investerar mycket i kvalitet; enskilda fel är ändå möjliga.
Hur aktuell är datan?
En företagsprofil kommer från vår databas. Med Realtid frågar API:et dessutom Handelsregister live och returnerar de personer som är registrerade just nu. Dokument hämtar API:et från registret när du begär dem.
Om samma dokument hämtades kort innan kan det vara upp till 24 timmar gammalt.
Företag måste publicera årsbokslut senast tolv månader efter balansdagen, och många utnyttjar hela perioden. Det senaste bokslutet avser därför ofta året före förra året.
Varför saknas ett värde för ett företag?
Oftast för att företaget inte behöver publicera det. Vad som är offentligt beror på bolagsform och storlek: en liten GmbH publicerar till exempel ingen resultaträkning, så det finns oftast ingen omsättning för den. Tomma värden visas som null eller [] i svaret.
Vad händer om flera företag har samma namn?
För ett namn som flera företag delar kan API:et returnera ett av dem, inte nödvändigtvis det du menar, eller svara med 404. Om du behöver vara exakt frågar du med registerdomstol och registernummer, till exempel ”Ansbach HRB 6089”, eller med entity_id. Enbart registernumret räcker inte, eftersom samma nummer finns hos många domstolar.
Debitering
Kostar en funktion krediter om den inte returnerar några data?
Nej. En funktion debiteras bara när den returnerar data. AI-läget debiteras däremot även om det inte hittar något företag. Bara om API:et avbryter förfrågan med 408 debiteras det inte. Realtid kostar krediter vid varje lyckad live-hämtning, även om den inte visar något nytt.
Vad kostar en misslyckad förfrågan?
Ingenting. En förfrågan som slutar med ett fel debiteras inte; det enda undantaget är tillägget för AI-läget. Vid status 402 anger meta.request_credit_cost det mesta som förfrågan hade kostat. Mer i Fel.
Behöver jag en kreditprenumeration?
Nej. Företagsprofiler, Sök & export, dokument och Signals kan du använda med varje konto; du betalar bara krediterna. En kreditprenumeration låser upp ytterligare data:
- Plus: personprofilen.
- Pro: de utökade finansiella nyckeltalen, funktionen Företagsnätverk, sökfilter för ägarstruktur, ledning och insolvens, och Signals-ämnet Insolvenser.
- Max: allt i Pro, plus funktionen Fördjupade delägardata, energibolagens verksamhetsbokslut och Signals-ämnet Omvandlingar & M&A.
Allt om priser och planer finns i Debitering.
Hur länge gäller startkrediter och påfyllningskrediter?
Ett nytt konto får 150 startkrediter. Utan kreditprenumeration gäller startkrediter och påfyllningskrediter i 30 dagar. Så länge en kreditprenumeration är aktiv förfaller de inte.
Teknik
Vilken timeout ska jag ställa in?
För Realtid, personprofiler och dokument minst 120 sekunder, eftersom dessa förfrågningar tar längre tid. Om bara live-hämtningen misslyckas med Realtid får du sparade data utan tillägget för Realtid. Om förfrågan tar för lång tid slutar den med 408, för dokument med 504. Då debiteras ingenting. Försök igen senare.
Hur många förfrågningar kan jag göra?
För företagsprofiler 60 förfrågningar per minut och konto, för dokument 5. Därutöver svarar API:et med status 429 och anger väntetiden i Retry-After. Alla gränser finns i Gränser.
Kan jag upprepa en förfrågan utan att betala två gånger?
Ja, för företagsprofiler, personprofiler, sökning och dokument. Skicka ett eget värde i headern Idempotency-Key. Om du upprepar förfrågan med samma nyckel och samma parametrar inom 24 timmar kostar den ingenting.
Kan jag använda flera API-nycklar?
Ja. Under Konto › API-nycklar skapar du fler nycklar, till exempel en per applikation. Om du raderar en nyckel blir den ogiltig direkt. Alla nycklar delar ditt kontos saldo.