Meetod: GET /company/{registryCode}/commercialPledgeData

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

Tagastab ettevõtte kommertspandiandmed – pandiõigused, pandipidajad, pandi summad, järjekohad ja kehtivusperioodid.

Tee parameetrid

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

Päringu parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
onlyValid	boolean	Valikuline	Tagastab ainult kehtivad andmed. Vaikimisi: true. Ajalooliste andmete kaasamiseks kasuta false.

Päise parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
apiVersion	ApiVersions	Valikuline	API versioon. Lubatud ja toetatud väärtus: V1. Vaikimisi: V1.
acceptLanguage	AcceptLanguage	Valikuline	Klassifikaatorite tõlgete keel: est – eesti, eng – inglise. Vaikimisi: est.

Vastuse skeem

Kohustuslikuks märgitud väljad peavad vastuses sisalduma. Muud väljad võivad puududa; null on lubatud ainult siis, kui see on välja tüübis kirjas.

CompanyCommercialPledgeDataResponse

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
commercialPledgeData	array[CommercialPledge] | null	Kommertspandiandmed

CommercialPledge

Väli	Tüüp	Kirjeldus
id	integer (int64) | null	Pandi ID
number	integer | null	Pandi number
status	string | null	Pandi staatus
statusAsText	string | null	Pandi staatus tekstina
rank	integer | null	Pandi järjekoht
rankAsText	string | null	Pandi järjekoht tekstina
amount	string | null	Pandi väärtus
currency	string | null	Pandi valuuta
currencyAsText	string | null	Pandi valuuta tekstina
rankings	array[RecordString] | null	Kommertspandi järjekohad
amounts	array[RecordCapital] | null	Kommertspandi summad
pledgees	array[CommercialPledgePledgee] | null	Kommertspandi pandipidajad
notes	array[RecordColumnNumber] | null	Kommertspandi märkused
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

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

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

CommercialPledgePledgee

Väli	Tüüp	Kirjeldus
personType	string | null	Pandipidaja isiku tüüp
name	string | null	Pandipidaja nimi
code	string | null	Pandipidaja kood
country	string | null	Pandipidaja riik
countryAsText	string | null	Pandipidaja riik tekstina
ehak	string | null	Pandipidaja asukoha EHAK
ehakAsText	string | null	Pandipidaja asukoha EHAK tekstina
fraction	string | null	Pandipidaja pandiosa
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

CustomValidationError

Väli	Tüüp	Kirjeldus
message	string	Kohustuslik. Veateade.
code	APIError	Kohustuslik. Veakood. Lubatud väärtused: 2001, 4030, 4041, 4042, 4043, 4044, 4045, 4046, 4047, 4048, 4049.
id	string | null	Kohustuslik. Vea identifikaator.
timestamp	string (date-time)	Vea ajatempel.

HTTPValidationError

Väli	Tüüp	Kirjeldus
detail	array[ValidationError]	Valideerimisvigade loend.

ValidationError

Väli	Tüüp	Kirjeldus
loc	array[string | integer]	Kohustuslik. Vea asukoht päringus.
msg	string	Kohustuslik. Veateade.
type	string	Kohustuslik. Valideerimisvea tüüp.
input	any	Valideerimisvea põhjustanud sisend.
ctx	object	Valideerimisvea lisakontekst.

Vastused

Edukas päring – tagastab ettevõtte kommertspandiandmed.

{
 "legalEntityName": "Kaseoru Tööstus OÜ",
 "registryCode": 12345678,
 "companyId": 987654,
 "vatID": null,
 "commercialPledgeData": [
 {
 "id": 1001,
 "number": 1,
 "status": null,
 "statusAsText": null,
 "rank": null,
 "rankAsText": null,
 "amount": "100000.00",
 "currency": "EUR",
 "currencyAsText": "euro",
 "rankings": null,
 "amounts": [
 {
 "currency": "EUR",
 "currencyAsText": "euro",
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 111002,
 "startDate": "2024-01-15",
 "endDate": null,
 "size": 100000.0
 }
 ],
 "pledgees": [
 {
 "personType": "J",
 "name": "Kuldoru Finantseerimine OÜ",
 "code": "10000001",
 "country": "EST",
 "countryAsText": "Eesti",
 "ehak": null,
 "ehakAsText": null,
 "fraction": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 111003,
 "startDate": "2024-01-15",
 "endDate": null
 }
 ],
 "notes": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 111000,
 "startDate": "2024-01-15",
 "endDate": null
 }
 ]
}

Edukas päring – ettevõttel mitu kommertspanti erinevate pandipidajatega.

{
 "legalEntityName": "Pihlakalda Tootmine OÜ",
 "registryCode": 12345679,
 "companyId": 123456,
 "vatID": null,
 "commercialPledgeData": [
 {
 "id": 2001,
 "number": 1,
 "status": null,
 "statusAsText": null,
 "rank": null,
 "rankAsText": null,
 "amount": "500000.00",
 "currency": "EUR",
 "currencyAsText": "euro",
 "rankings": null,
 "amounts": [
 {
 "currency": "EUR",
 "currencyAsText": "euro",
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 222002,
 "startDate": "2024-01-15",
 "endDate": null,
 "size": 500000.0
 }
 ],
 "pledgees": [
 {
 "personType": "J",
 "name": "Pihlapuu Kapital OÜ",
 "code": "10000002",
 "country": "EST",
 "countryAsText": "Eesti",
 "ehak": null,
 "ehakAsText": null,
 "fraction": "1/1",
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 222003,
 "startDate": "2024-01-15",
 "endDate": null
 }
 ],
 "notes": [
 {
 "columnNumber": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 222004,
 "startDate": "2024-01-15",
 "endDate": null,
 "type": "KMARK",
 "typeAsText": "Kommertspandi märkused",
 "content": "Pandileping sõlmitud 15. jaanuaril 2024."
 }
 ],
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 222000,
 "startDate": "2024-01-15",
 "endDate": null
 },
 {
 "id": 2002,
 "number": 2,
 "status": null,
 "statusAsText": null,
 "rank": null,
 "rankAsText": null,
 "amount": "200000.00",
 "currency": "EUR",
 "currencyAsText": "euro",
 "rankings": null,
 "amounts": [
 {
 "currency": "EUR",
 "currencyAsText": "euro",
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 2,
 "recordId": 222012,
 "startDate": "2025-03-15",
 "endDate": null,
 "size": 200000.0
 }
 ],
 "pledgees": [
 {
 "personType": "J",
 "name": "Vahtramäe Laenud OÜ",
 "code": "10000003",
 "country": "EST",
 "countryAsText": "Eesti",
 "ehak": null,
 "ehakAsText": null,
 "fraction": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 2,
 "recordId": 222013,
 "startDate": "2025-03-15",
 "endDate": null
 }
 ],
 "notes": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 2,
 "recordId": 222010,
 "startDate": "2025-03-15",
 "endDate": null
 }
 ]
}

Edukas päring – ettevõttel pole kommertspante.

{
 "legalEntityName": "Nurmevälja Teenused OÜ",
 "registryCode": 11112222,
 "companyId": 333444,
 "vatID": null,
 "commercialPledgeData": null
}

Edukas päring koos ajalooliste andmetega (onlyValid=false).

{
 "legalEntityName": "Sirelioru Kaubandus OÜ",
 "registryCode": 99887766,
 "companyId": 111222,
 "vatID": null,
 "commercialPledgeData": [
 {
 "id": 3001,
 "number": 1,
 "status": null,
 "statusAsText": null,
 "rank": null,
 "rankAsText": null,
 "amount": "50000.00",
 "currency": "EUR",
 "currencyAsText": "euro",
 "rankings": null,
 "amounts": [
 {
 "currency": "EUR",
 "currencyAsText": "euro",
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 333001,
 "startDate": "2024-01-15",
 "endDate": "2025-06-30",
 "size": 50000.0
 }
 ],
 "pledgees": [
 {
 "personType": "J",
 "name": "Sarapiku Kapital OÜ",
 "code": "10000004",
 "country": "EST",
 "countryAsText": "Eesti",
 "ehak": null,
 "ehakAsText": null,
 "fraction": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 333002,
 "startDate": "2024-01-15",
 "endDate": "2025-06-30"
 }
 ],
 "notes": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 333000,
 "startDate": "2024-01-15",
 "endDate": "2025-06-30"
 }
 ]
}

Juurdepääs teenusele keelatud.

Ei leitud. Illustratiivne veavastus:

{
 "message": "Not found",
 "code": 4041,
 "id": null,
 "timestamp": "2026-01-15T10:30:00Z"
}

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

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