Ettevõtte üldandmed

Meetod: GET /company/{registryCode}/generalData

OpenAPI/Swagger: https://ar-rest.rik.ee/docs#/Company/get_company_general_data

Tagastab ettevõtte üldandmed registrikoodi järgi. Vastus sisaldab põhjalikku infot ettevõtte kohta – staatust, ärinimede ajalugu, aadresse, õiguslikku vormi, kapitali, majandusaastaid, tegevusalasid, sidevahendeid ja palju muud. See on spetsialiseeritud endpoint ainult üldandmete pärimiseks.

Tee parameetrid

Parameeter Tüüp Kohustuslik Kirjeldus
registryCode integer Kohustuslik Ettevõtte registrikood.

Päringu parameetrid

Parameeter Tüüp Kohustuslik Kirjeldus
onlyValid boolean Valikuline Kuvab ainult kehtivad andmed. Vaikeväärtus: true.

Päise parameetrid

Parameeter Tüüp Kohustuslik Kirjeldus
apiVersion ApiVersions Valikuline API versiooni päis Vaikeväärtus: "V1"; Lubatud väärtused: ["V1"]; Toetatud versioonid: ["V1"].
acceptLanguage AcceptLanguage Valikuline Klassifikaatorite tõlgete keel (est – eesti, eng – inglise) Vaikeväärtus: "est"; Lubatud väärtused: ["est", "eng"].

Vastuse skeem

CompanyGeneralDataResponse

Väli Tüüp Kirjeldus
legalEntityName string Kohustuslik. Ettevõtte ärinimi
registryCode integer Kohustuslik. Ettevõtte registrikood
companyId integer Kohustuslik. Ettevõtte sisemine ID
vatID string | null Käibemaksukohustuslase number
generalData DetailDataGeneralData Kohustuslik. Üldandmed

DetailDataGeneralData

Väli Tüüp Kirjeldus
companyRegistryNumber integer | null Ettevõtte registrikood
einvoiceProvider string | null E-arve teenusepakkuja tunnus
hasUndeclaredReports boolean | null Teave kohustuste täitmise kohta: kas viimase kolme aasta majandusaasta aruandeid on esitamata? Teavet ei väljastata, kui see puudub või seda ei saa pärida.
firstEntryTime string (date) | null Esmase registreerimise kuupäev
deletionDate string (date) | null Kustutamise kuupäev
isFIEOperating boolean | null Kas FIE tegutseb
isFIEOperatingAsText string | null FIE tegutsemine tekstina
mkrRegDate array[RecordDateTime] | null Maksukohustuslaste registrisse kandmise alguskuupäevad
accountingEntityIdentifierEntries array[AccountingEntityIdentifierEntry] | null Raamatupidamiskohustuslase tunnuse kanded. Täidetakse ainult riigi- ja kohaliku omavalitsuse asutustel.
companyActivityTimes array[ActivityTime] | null Ettevõtja tegutsemisajad
isCSDRegistered boolean | null Kas on registreeritud väärtpaberite keskregistris
entryCSDRegistrationDate string (date) | null Väärtpaberite keskregistris registreerimise kuupäev
forceTerminationDetails ForceTerminationDetails | null
status RecordStatus | null Ettevõtte staatus
foreignParentCompany ForeignParentCompany | null
legalEntityNames array[RecordString] | null Ärinimede ajalugu
additionalNames array[RecordString] | null Täiendavate nimede ajalugu
addresses array[RecordFullAddress] | null Aadressid
boardLocationAddresses array[RecordFullAddress] | null Juhatuse asukoha aadressid
contactPersonAddresses array[RecordFullAddress] | null Kontaktisiku aadressid
apartAssocLocationAddresses array[RecordFullAddress] | null Korteriühistu asukoha aadressid
apartAssocPropertyAddresses array[PropertyAddress] | null Korteriühistu kinnisasjade aadressid
immovableProperties array[ImmovableProperty] | null Kinnisasjad
legalForm array[DetailDataLegalForm] | null Õiguslik vorm
legalFormSubtypes array[RecordDescription] | null Õigusliku vormi alaliik
capitals array[RecordCapital] | null Kapitaliandmed
noParValueShares array[NoParValueShare] | null Nimiväärtuseta aktsiad
successions array[RecordType] | null Õigusjärglused
statusChanges array[RecordType] | null Staatuse muutused
financialYears array[FinancialYear] | null Majandusaastad
associationArticles array[AssociationArticle] | null Põhikirjad
compromiseDeadlines array[RecordDateTime] | null Kompromissi tähtajad
foundingTimes array[RecordDateTime] | null Asutamisajad
actionDeadlines array[RecordDateTime] | null Toimingute tähtajad
firstAppointmentTimes array[RecordString] | null Esmase määramise ajad
foreignAgreementDates array[ForeignAgreementDate] | null Välislepingu kuupäevad
registryCardNotes array[RecordColumnNumber] | null Registrikaardi märkused
registryCardAreasOfActivity array[RecordString] | null Registrikaardile kantud tegevusalad
registryCardObjectives array[RecordString] | null Registrikaardile kantud eesmärgid
commMeans array[RecordType] | null Sidevahendid
reportedActivities array[ReportedActivityArea] | null Aruandes esitatud tegevusalad
infoFinancialYearFromReports array[ReportInfo] | null Finantsaruannete andmed
isFoundedWithoutPayment boolean Kohustuslik. Kas asutatud sissemakset tegemata
hasAbandonedFormReqs boolean | null Osaühing on loobunud osa võõrandamise ja pantimise käsutustehingu kohustuslikust vorminõudest
isAccountingLiable boolean | null
isRequiredtoProvideBeneficiaries boolean | null Kas ettevõtja peab esitama tegelike kasusaajate andmed
landImprovementSystemCodes array[RecordString] | null Maaparandussüsteemi koodid
isHDRCompetentAuthority boolean | null Kas isik on huvide deklaratsioonide registri pädev asutus

RecordDateTime

Väli Tüüp Kirjeldus
content string (date) | null Sisu
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

AccountingEntityIdentifierEntry

Väli Tüüp Kirjeldus
isAccountingLiable boolean | null Kas asutus on raamatupidamiskohustuslane
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

ActivityTime

Väli Tüüp Kirjeldus
periodStartDate string | null Tegevusperiood
periodEndDate string | null Perioodi lõppkuupäev
period string | null Periood
periodAsText string | null Tegevusperiood tekstina
entryPartType string | null Kande osa tüüp
typeAsText string | null Tüüp tekstina
content string | null Sisu
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

ForceTerminationDetails

Väli Tüüp Kirjeldus
basis integer (int64) | null Alus
basisAsText string | null Alus tekstina
subdivision integer (int64) | null Allüksus
subdivisionAsText string | null Allüksus tekstina
subdivisionDate string (date) | null Allüksuse kuupäev
notice string | null Teade
noticeDate string (date) | null Teate kuupäev
noticePetitionerRegistryDep integer (int64) | null Teate esitaja registriosakond
noticePetitionerRegistryDepAsText string | null Teate esitaja registriosakond tekstina
courtByLocation integer (int64) | null Asukohajärgne kohus
courtByLocationAsText string | null Asukohajärgne kohus tekstina

RecordStatus

Väli Tüüp Kirjeldus
status string | null Staatus
statusAsText string | null Staatus tekstina
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

ForeignParentCompany

Väli Tüüp Kirjeldus
legalEntityName array[RecordString] Kohustuslik. Ärinimi
location array[RecordShortAddress] Kohustuslik. Asukohad
legalForm array[RecordDescription] Kohustuslik. Õiguslik vorm
similarToEstoniaLegalForm array[RecordDescription] Kohustuslik. Sarnane Eesti õiguslik vorm
similarToEstoniaLegalFormNote array[RecordDescription] Kohustuslik. Märkus sarnase Eesti õigusliku vormi kohta
lawCountry array[RecordDescription] Kohustuslik. Riik, mille õiguse alusel tegutsetakse
lawCountryNote array[RecordDescription] Kohustuslik. Märkus riigi kohta, mille õiguse alusel tegutsetakse
registry array[RecordDescription] Kohustuslik. Register
registrationNumber array[RecordDescription] Kohustuslik. Registrinumber
obligationToDiscloseReport array[RecordDescription] Kohustuslik. Aruande avalikustamise kohustus

RecordString

Väli Tüüp Kirjeldus
content string | null Sisu
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

RecordShortAddress

Väli Tüüp Kirjeldus
country string Kohustuslik. Riik
countryAsText string Kohustuslik. Riik tekstina
address string Kohustuslik. Aadress
postalCode string | null Postiindeks
cardNumber integer (int64) Kohustuslik. Kaardi number
cardType string Kohustuslik. Kaardi tüüp
entryNumber integer (int64) Kohustuslik. Kande number
recordId integer (int64) Kohustuslik. ID
startDate string (date) Kohustuslik. Alguskuupäev
endDate string (date) | null Lõppkuupäev

RecordDescription

Väli Tüüp Kirjeldus
contentAsText string | null Sisu tekstina
content string Kohustuslik. Sisu
cardNumber integer (int64) Kohustuslik. Kaardi number
cardType string Kohustuslik. Kaardi tüüp
entryNumber integer (int64) Kohustuslik. Kande number
recordId integer (int64) Kohustuslik. ID
startDate string (date) Kohustuslik. Alguskuupäev
endDate string (date) | null Lõppkuupäev

RecordFullAddress

Väli Tüüp Kirjeldus
address FullAddress Kohustuslik. Täisaadress
cardNumber integer (int64) Kohustuslik. Kaardi number
cardType string Kohustuslik. Kaardi tüüp
entryNumber integer (int64) Kohustuslik. Kande number
recordId integer (int64) Kohustuslik. ID
startDate string (date) Kohustuslik. Alguskuupäev
endDate string (date) | null Lõppkuupäev

FullAddress

Väli Tüüp Kirjeldus
country string | null Riik
countryAsText string | null Riik tekstina
address string | null Aadress
postalCode string | null Postiindeks
ehak string | null EHAK kood
ehakAsText string | null EHAK tekstina
adsAdobId string | null Aadressi ADOBID
adsNormalizedFullAddressSuffix string | null Normaliseeritud ADS-aadressi tekstiline täiendus (nt postkasti number)
adsType string | null Aadressi tüüp: 0 – täielik ADS, 1 – osaline ADS, 2 – ADS-ita
adsOid string | null Aadressi ADS OID
adrId integer | null Aadressi ADR ID
adsNormalizedFullAddress string | null ADS-i normaliseeritud täisaadress
adsCodeAddress string | null Aadressi ADS-kood
loadingDate string (date) | null Andmete KR-ist laadimise kuupäev

PropertyAddress

Väli Tüüp Kirjeldus
adsOid string | null Aadressi ADS OID
adrId integer | null Aadressi ADR ID
adsNormalizedFullAddress string | null ADS-i normaliseeritud täisaadress
adsCodeAddress string | null Aadressi ADS-kood
loadingDate string (date) | null Andmete KR-ist laadimise kuupäev

ImmovableProperty

Väli Tüüp Kirjeldus
propertyNumber integer (int64) | null Kinnistu number
propertyDepartment integer (int64) | null Kinnistu osakond
address FullAddress | null
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

DetailDataLegalForm

Väli Tüüp Kirjeldus
contentNumber integer (int64) | null Sisu arvuna
contentAsText string | null Sisu tekstina
content string | null Sisu
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

RecordCapital

Väli Tüüp Kirjeldus
size number (double) | null Suurus
currency string | null Valuuta
currencyAsText string | null Valuuta tekstina
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

NoParValueShare

Väli Tüüp Kirjeldus
number integer (int64) | null Nimiväärtuseta aktsiate arv
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

RecordType

Väli Tüüp Kirjeldus
type string | null Tüüp
typeAsText string | null Tüüp tekstina
content string | null Sisu
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

FinancialYear

Väli Tüüp Kirjeldus
financialYearStartDate string | null Majandusaasta alguskuupäev
financialYearEndDate string | null Majandusaasta lõppkuupäev
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

AssociationArticle

Väli Tüüp Kirjeldus
approvalDate string (date) | null Kinnitamise kuupäev
modifiedDate string (date) | null Muutmise kuupäev
explanation string | null Selgitus
containsSpecialRights boolean Kohustuslik. Põhikiri sisaldab eriõigusi
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

ForeignAgreementDate

Väli Tüüp Kirjeldus
effectiveDate string (date) | null Välislepingu jõustumise kuupäev
releaseNote string | null Avaldamismärkus
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

RecordColumnNumber

Väli Tüüp Kirjeldus
columnNumber integer (int64) | null Veeru number
type string | null Tüüp
typeAsText string | null Tüüp tekstina
content string | null Sisu
cardNumber integer (int64) | null Kaardi number
cardType string | null Kaardi tüüp
entryNumber integer (int64) | null Kande number
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

ReportedActivityArea

Väli Tüüp Kirjeldus
emtakCode string | null Tegevusala kood EMTAK-i järgi
emtakAsText string | null EMTAK-i kood tekstina
emtakVersion integer (int64) | null EMTAK-i versioon
emtakVersionAsText string | null EMTAK-i versioon tekstina
naceCode string | null NACE kood
isMainBusinessArea boolean | null Kas on põhitegevusala
recordId integer (int64) | null ID
startDate string (date) | null Alguskuupäev
endDate string (date) | null Lõppkuupäev

ReportInfo

Väli Tüüp Kirjeldus
recordId integer (int64) | null ID
periodStartDate string (date) | null Perioodi alguskuupäev
periodEndDate string (date) | null Perioodi lõppkuupäev
employeesNumber integer (int64) | null Töötajate arv
address string | null Aadress
activityAreaEmtakCode string | null Tegevusala kood EMTAK-i järgi
activityAreaEmtakAsText string | null EMTAK-i kood tekstina
activityAreaEmtakVersion integer (int64) | null EMTAK-i versioon
activityAreaEmtakVersionAsText string | null EMTAK-i versioon tekstina
activityAreaNaceCode string | null NACE kood

Vastused

200 OK (Active Company - OÜ)

Edukas päring – tagastab registreeritud osaühingu üldandmed.

{
 "legalEntityName": "NÄIDIS OÜ",
 "registryCode": 12345678,
 "companyId": 987654,
 "vatID": null,
 "generalData": {
 "companyRegistryNumber": 12345678,
 "einvoiceProvider": null,
 "hasUndeclaredReports": false,
 "firstEntryTime": "2024-05-15",
 "deletionDate": null,
 "isFIEOperating": null,
 "isFIEOperatingAsText": null,
 "isCSDRegistered": false,
 "entryCSDRegistrationDate": null,
 "status": {
 "status": "R",
 "statusAsText": "Registrisse kantud",
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 12345,
 "startDate": "2024-05-15",
 "endDate": null
 },
 "legalEntityNames": [
 {
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 12345,
 "startDate": "2024-05-15",
 "endDate": null,
 "content": "NÄIDIS OÜ"
 }
 ],
 "additionalNames": null,
 "addresses": [
 {
 "address": {
 "address": "Näidistänav 1, Näidislinn"
 },
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 12345,
 "startDate": "2024-05-15"
 }
 ],
 "boardLocationAddresses": null,
 "contactPersonAddresses": null,
 "legalForm": [
 {
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 12347,
 "startDate": "2024-05-15",
 "endDate": null,
 "content": "5",
 "contentNumber": 5,
 "contentAsText": "Osaühing"
 }
 ],
 "legalFormSubtypes": null,
 "capitals": [
 {
 "currency": "EUR",
 "currencyAsText": "euro",
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 12348,
 "startDate": "2024-05-15",
 "endDate": null,
 "size": 2500
 }
 ],
 "noParValueShares": null,
 "financialYears": [
 {
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 12349,
 "startDate": "2024-05-15",
 "endDate": null,
 "financialYearStartDate": "2024-01-01",
 "financialYearEndDate": "2024-12-31"
 }
 ],
 "associationArticles": [
 {
 "approvalDate": "2024-05-10",
 "modifiedDate": null,
 "explanation": null,
 "containsSpecialRights": false,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 12350,
 "startDate": "2024-05-15",
 "endDate": null
 }
 ],
 "commMeans": [
 {
 "type": "EMAIL",
 "typeAsText": "Elektronposti aadress",
 "cardNumber": null,
 "cardType": null,
 "entryNumber": null,
 "recordId": 12353,
 "startDate": "2024-05-15",
 "endDate": null,
 "content": "[email protected]"
 },
 {
 "type": "TEL",
 "typeAsText": "Telefon",
 "cardNumber": null,
 "cardType": null,
 "entryNumber": null,
 "recordId": 12354,
 "startDate": "2024-05-15",
 "endDate": null,
 "content": null
 },
 {
 "type": "WWW",
 "typeAsText": "Interneti WWW aadress",
 "cardNumber": null,
 "cardType": null,
 "entryNumber": null,
 "recordId": 12355,
 "startDate": "2024-05-15",
 "endDate": null,
 "content": "https://example.invalid"
 }
 ],
 "reportedActivities": null,
 "infoFinancialYearFromReports": null,
 "isFoundedWithoutPayment": false,
 "hasAbandonedFormReqs": false,
 "isAccountingLiable": null,
 "isRequiredtoProvideBeneficiaries": true,
 "isHDRCompetentAuthority": null
 }
}
200 OK (FIE - Sole Trader)

Edukas päring – tagastab FIE (füüsilisest isikust ettevõtja) üldandmed.

{
 "legalEntityName": "NÄIDIS ETTEVÕTJA FIE",
 "registryCode": 11223344,
 "companyId": 876543,
 "vatID": null,
 "generalData": {
 "companyRegistryNumber": 11223344,
 "einvoiceProvider": null,
 "hasUndeclaredReports": null,
 "firstEntryTime": "2024-03-01",
 "deletionDate": null,
 "isFIEOperating": true,
 "isFIEOperatingAsText": "Tegutseb",
 "isCSDRegistered": null,
 "entryCSDRegistrationDate": null,
 "status": {
 "status": "R",
 "statusAsText": "Registrisse kantud",
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 22345,
 "startDate": "2024-03-01",
 "endDate": null
 },
 "legalEntityNames": [
 {
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 22345,
 "startDate": "2024-03-01",
 "endDate": null,
 "content": "NÄIDIS ETTEVÕTJA FIE"
 }
 ],
 "additionalNames": null,
 "addresses": [
 {
 "address": {
 "address": "Näidistänav 1, Näidislinn"
 },
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 12345,
 "startDate": "2024-03-01"
 }
 ],
 "legalForm": [
 {
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 22347,
 "startDate": "2024-03-01",
 "endDate": null,
 "content": "3",
 "contentNumber": 3,
 "contentAsText": "Füüsilisest isikust ettevõtja"
 }
 ],
 "capitals": null,
 "financialYears": null,
 "commMeans": null,
 "reportedActivities": null,
 "isFoundedWithoutPayment": false,
 "isRequiredtoProvideBeneficiaries": false
 }
}
403 Forbidden

Juurdepääs teenusele keelatud. Vastuse sisu ei ole OpenAPI-s määratud.

404 Not Found

Ettevõtet antud registrikoodiga ei leitud. Illustreeriv vastuse näide: 4041 on lubatud APIError väärtus, kuid OpenAPI ei määra selle tähendust ega seosta seda konkreetse olukorraga.

{
 "message": "Company with registry code 99999999 not found",
 "code": 4041,
 "id": "abc123-def456"
}
422 Validation Error

Vigane päring – parameetrid ei vasta nõuetele.

{
 "detail": [
 {
 "loc": [
 "path",
 "registryCode"
 ],
 "msg": "value is not a valid integer",
 "type": "type_error.integer"
 }
 ]
}