Method: GET /company/{registryCode}/commercialPledgeData

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

Returns the company’s commercial pledge data – pledge rights, pledgees, pledge amounts, rankings and validity periods. A commercial pledge is a pledge over movable property that allows a company to use its assets as collateral for a loan without transferring possession. The service is suitable for credit analysis and collateral checks.

Path parameters

Parameter	Type	Required	Description
registryCode	integer	Required	Company registry code.

Query parameters

Parameter	Type	Required	Description
onlyValid	boolean	Optional	Returns only valid data. Default: true. Use false to include historical data.

Header parameters

Parameter	Type	Required	Description
apiVersion	ApiVersions	Optional	API version. Allowed and supported value: V1. Default: V1.
acceptLanguage	AcceptLanguage	Optional	Language of classifier translations: est – Estonian, eng – English. Default: est.

Response schema

Fields marked Required must be present. Other fields may be omitted; null is allowed only where the type includes null.

CompanyCommercialPledgeDataResponse

Field	Type	Description
legalEntityName	string	Required. Company Business Name
registryCode	integer	Required. Company registration code
companyId	integer	Required. Internal Company ID
vatID	string | null	VAT identification number
commercialPledgeData	array[CommercialPledge] | null	Commercial Pledge data

CommercialPledge

Field	Type	Description
id	integer (int64) | null	Pledge ID
number	integer | null	Pledge number
status	string | null	Pledge status
statusAsText	string | null	Pledge status as text
rank	integer | null	Pledge rank
rankAsText	string | null	Pledge rank as text
amount	string | null	Pledge value
currency	string | null	Pledge currency
currencyAsText	string | null	Pledge currency as text
rankings	array[RecordString] | null	Commercial pledge rankings
amounts	array[RecordCapital] | null	Commercial pledge amounts
pledgees	array[CommercialPledgePledgee] | null	Commercial pledgees
notes	array[RecordColumnNumber] | null	Commercial pledge notes
cardNumber	integer (int64) | null	Card number
cardType	string | null	Card type
entryNumber	integer (int64) | null	Entry number
recordId	integer (int64) | null	ID
startDate	string (date) | null	Start date
endDate	string (date) | null	Ending date

RecordString

Field	Type	Description
content	string | null	Content
cardNumber	integer (int64) | null	Card number
cardType	string | null	Card type
entryNumber	integer (int64) | null	Entry number
recordId	integer (int64) | null	ID
startDate	string (date) | null	Start date
endDate	string (date) | null	Ending date

RecordCapital

Field	Type	Description
size	number (double) | null	Size
currency	string | null	Currency
currencyAsText	string | null	Currency as text
cardNumber	integer (int64) | null	Card number
cardType	string | null	Card type
entryNumber	integer (int64) | null	Entry number
recordId	integer (int64) | null	ID
startDate	string (date) | null	Start date
endDate	string (date) | null	Ending date

CommercialPledgePledgee

Field	Type	Description
personType	string | null	Type of Pledgee Person
name	string | null	Pledgee Name
code	string | null	Pledgee Code
country	string | null	Country of the pledgee
countryAsText	string | null	Country of the pledgee as text
ehak	string | null	Pledgee location EHAK
ehakAsText	string | null	Pledgee location EHAK as text
fraction	string | null	Pledgee fraction of pledge
cardNumber	integer (int64) | null	Card number
cardType	string | null	Card type
entryNumber	integer (int64) | null	Entry number
recordId	integer (int64) | null	ID
startDate	string (date) | null	Start date
endDate	string (date) | null	Ending date

RecordColumnNumber

Field	Type	Description
columnNumber	integer (int64) | null	Column number
type	string | null	Type
typeAsText	string | null	Type as text
content	string | null	Content
cardNumber	integer (int64) | null	Card number
cardType	string | null	Card type
entryNumber	integer (int64) | null	Entry number
recordId	integer (int64) | null	ID
startDate	string (date) | null	Start date
endDate	string (date) | null	Ending date

CustomValidationError

Field	Type	Description
message	string	Required. Error message.
code	APIError	Required. Error code. Allowed values: 2001, 4030, 4041, 4042, 4043, 4044, 4045, 4046, 4047, 4048, 4049.
id	string | null	Required. Error identifier.
timestamp	string (date-time)	Error timestamp.

HTTPValidationError

Field	Type	Description
detail	array[ValidationError]	List of validation errors.

ValidationError

Field	Type	Description
loc	array[string | integer]	Required. Location of the error in the request.
msg	string	Required. Error message.
type	string	Required. Validation error type.
input	any	Input that caused the validation error.
ctx	object	Additional context for the validation error.

Responses

Successful request – returns the company’s commercial pledge data.

{
 "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": "Estonia",
 "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
 }
 ]
}

Successful request – the company has multiple commercial pledges with different pledgees.

{
 "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": "Estonia",
 "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": "Remarks on the commercial pledge",
 "content": "Pledge agreement concluded on 15 January 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": "Estonia",
 "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
 }
 ]
}

Successful request – the company has no commercial pledges.

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

Successful request with historical data (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": "Estonia",
 "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"
 }
 ]
}

Access to the service is forbidden.

Not found. Illustrative error response:

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

Invalid request – registry code does not meet the requirements.

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