Method: GET /company/documents/reports/financialYear
OpenAPI: get_company_financial_year
Returns company annual reports with audit statuses. Reports are available in PDF and, where available, XBRL and DDOC/BDOC formats. Reports can be searched by registry code, reporting year, document type and submission period.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| registryCode | integer | Optional | Registry code of the company |
| reportYear | integer | Optional | Reporting Year |
| documentType | string | Optional | Document type: A – PDF, D – BDOC/DDOC, X – XBRL. |
| submissionStartDate | string (date-time) | Optional | This parameter specifies the beginning date and time for the interval of submitted reports, with precision down to the time of day. |
| submissionEndDate | string (date-time) | Optional | This parameter specifies the ending date and time for the interval of submitted reports, with precision down to the time of day. |
| pageNumber | integer | Optional | Results Page Number. Default: 1; Maximum: 100000; Greater than: 0. |
| pageSize | integer | Optional | How many results on one page are desired. Default: 100; Maximum: 1000; Greater than: 0. |
Header parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| apiVersion | ApiVersions | Optional | API version. Allowed and supported value: V1. Default: V1. |
| acceptLanguage | AcceptLanguage | Optional | Classifier translation language: est – Estonian, eng – English. Default: est. |
Response schema
Fields marked required must be present. Other fields may be omitted; null is allowed only where shown in the type. A missing financial figure does not mean zero.
ReportResponse
| Field | Type | Description |
|---|---|---|
| total | integer (int64) | Required. The total number of entities. |
| list | array[FinancialYearReport] | Required. List of Financial Year Reports |
FinancialYearReport
| Field | Type | Description |
|---|---|---|
| documentId | integer (int64) | Required. Document ID of the annual report. |
| submissionDate | string (date) | Required. Date of submission |
| reportYear | integer | Required. Report Year |
| currency | string | null | Currency of the report |
| balanceSheet | integer (int64) | null | Balance Sheet Amount |
| revenue | integer (int64) | null | Revenue Amount |
| workers | integer (int64) | null | Number of Employees |
| status | string | Required. Report or document validity: K – valid, A – expired. |
| registryCode | integer | Required. Registry code of the company |
| reportStartDate | string (date) | Required. Beginning of Reporting period |
| reportEndDate | string (date) | null | End of Reporting period |
| isConsolidatedReport | boolean | null | Report consolidation flag |
| auditStatus | string | Required. Audit status. Responses include AUDITEERITUD and PUUDUB INFO AUDITEERIMISE KOHTA. OpenAPI describes PERFORMED, NOTPERFORMED and NOTAVAILABLE; this field is a string, not an enum. |
| relatedDocuments | array[ReportDocument] | null | Related Documents |
ReportDocument
| Field | Type | Description |
|---|---|---|
| id | integer | Required. Document ID. |
| name | string | Required. Document Name |
| type | string | Required. Document type. Responses include PDF and XBRL; the documentType query parameter uses separate codes A, D and X. |
| url | string | null | Reference to the document |
| status | string | Required. Report or document validity: K – valid, A – expired. |
CustomValidationError
| Field | Type | Description |
|---|---|---|
| message | string | Required. Error message. |
| code | APIError | Required. Error code (APIError). |
| id | string | null | Required. Error identifier. |
| timestamp | string (date-time) | Timestamp of the error |
HTTPValidationError
| Field | Type | Description |
|---|---|---|
| detail | array[ValidationError] | Validation errors. |
ValidationError
| Field | Type | Description |
|---|---|---|
| loc | array[string | integer] | Required. Location in the request. |
| msg | string | Required. Error message. |
| type | string | Required. Validation error type. |
| input | any | Input that caused the error. |
| ctx | object | Additional error context. |
Response codes
- 200 – Successful response.
- 204 – No annual reports found. No response body.
- 403 – Service access denied. OpenAPI does not specify a response body.
- 404 – Not found (CustomValidationError).
- 422 – Request validation error (HTTPValidationError).
Examples
200 – Reports with PDF and XBRL documents
GET /company/documents/reports/financialYear?registryCode=12345678
{
"total": 2,
"list": [
{
"documentId": 9000000001,
"submissionDate": "2024-06-18",
"reportYear": 2023,
"currency": "EUR",
"balanceSheet": 1250000,
"revenue": 2400000,
"workers": 18,
"status": "K",
"registryCode": 12345678,
"reportStartDate": "2023-01-01",
"reportEndDate": "2023-12-31",
"isConsolidatedReport": false,
"auditStatus": "AUDITEERITUD",
"relatedDocuments": [
{
"id": 9000000001,
"name": "Majandusaasta aruanne PDF",
"type": "PDF",
"url": "https://ariregister.rik.ee/est/company/12345678/file/9000000001",
"status": "K"
},
{
"id": 9000000001,
"name": "Majandusaasta aruanne XBRL",
"type": "XBRL",
"url": "https://ariregister.rik.ee/est/company/12345678/file/9000000001?document_type=xbrl",
"status": "K"
}
]
},
{
"documentId": 9000000002,
"submissionDate": "2002-06-27",
"reportYear": 2001,
"status": "K",
"registryCode": 12345678,
"reportStartDate": "2001-01-01",
"reportEndDate": "2001-12-31",
"auditStatus": "PUUDUB INFO AUDITEERIMISE KOHTA",
"relatedDocuments": []
}
]
}
200 – XBRL document query
GET /company/documents/reports/financialYear?registryCode=12345678&reportYear=2023&documentType=X
{
"total": 1,
"list": [
{
"documentId": 9000000001,
"submissionDate": "2024-06-18",
"reportYear": 2023,
"currency": "EUR",
"balanceSheet": 1250000,
"revenue": 2400000,
"workers": 18,
"status": "K",
"registryCode": 12345678,
"reportStartDate": "2023-01-01",
"reportEndDate": "2023-12-31",
"isConsolidatedReport": false,
"auditStatus": "AUDITEERITUD",
"relatedDocuments": [
{
"id": 9000000001,
"name": "Majandusaasta aruanne XBRL",
"type": "XBRL",
"url": "https://ariregister.rik.ee/est/company/12345678/file/9000000001?document_type=xbrl",
"status": "K"
}
]
}
]
}
404 – Error response example
This example illustrates the error response structure; OpenAPI does not specify the meaning of code 4041.
{
"message": "Not found",
"code": 4041,
"id": null,
"timestamp": "2024-07-01T10:00:00Z"
}
422 – Validation error example
GET /company/documents/reports/financialYear?pageNumber=0
{
"detail": [
{
"loc": [
"query",
"pageNumber"
],
"msg": "Input should be greater than 0",
"type": "greater_than",
"input": 0,
"ctx": {
"gt": 0
}
}
]
}
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$ref": "#/components/schemas/ReportResponse",
"components": {
"schemas": {
"ApiVersions": {
"type": "string",
"enum": [
"V1"
],
"title": "ApiVersions"
},
"AcceptLanguage": {
"type": "string",
"enum": [
"est",
"eng"
],
"title": "AcceptLanguage"
},
"ReportResponse": {
"properties": {
"total": {
"type": "integer",
"format": "int64",
"title": "Total",
"description": "The total number of entities.",
"examples": [
1
]
},
"list": {
"items": {
"$ref": "#/components/schemas/FinancialYearReport"
},
"type": "array",
"title": "List",
"description": "List of Financial Year Reports"
}
},
"type": "object",
"required": [
"total",
"list"
],
"title": "ReportResponse"
},
"FinancialYearReport": {
"properties": {
"documentId": {
"type": "integer",
"format": "int64",
"title": "Documentid",
"description": "Document ID of the annual report (menetlused_dokumendid.id)"
},
"submissionDate": {
"type": "string",
"format": "date",
"title": "Submissiondate",
"description": "Date of submission"
},
"reportYear": {
"type": "integer",
"title": "Reportyear",
"description": "Report Year"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Currency",
"description": "Currency of the report"
},
"balanceSheet": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"format": "int64",
"title": "Balancesheet",
"description": "Balance Sheet Amount"
},
"revenue": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"format": "int64",
"title": "Revenue",
"description": "Revenue Amount"
},
"workers": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"format": "int64",
"title": "Workers",
"description": "Number of Employees"
},
"status": {
"type": "string",
"title": "Status",
"description": "Validity(K – valid, A – expired)"
},
"registryCode": {
"type": "integer",
"title": "Registrycode",
"description": "Registry code of the company"
},
"reportStartDate": {
"type": "string",
"format": "date",
"title": "Reportstartdate",
"description": "Beginning of Reporting period"
},
"reportEndDate": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Reportenddate",
"description": "End of Reporting period"
},
"isConsolidatedReport": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Isconsolidatedreport",
"description": "Report consolidation flag"
},
"auditStatus": {
"type": "string",
"title": "Auditstatus",
"description": "NOTAVAILABLE - not available audit information, NOTPERFORMED - audit not performed, PERFORMED - audit performed"
},
"relatedDocuments": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/ReportDocument"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Relateddocuments",
"description": "Related Documents"
}
},
"type": "object",
"required": [
"documentId",
"submissionDate",
"reportYear",
"status",
"registryCode",
"reportStartDate",
"auditStatus"
],
"title": "FinancialYearReport"
},
"ReportDocument": {
"properties": {
"id": {
"type": "integer",
"title": "Id",
"description": "Document ID. Document ID, can be used as an input in the service arireg.toimikuDokument."
},
"name": {
"type": "string",
"title": "Name",
"description": "Document Name"
},
"type": {
"type": "string",
"title": "Type",
"description": "Document Type. A - annual reports in PDF, D - annual reports in BDOC, DDOC, X - annual reports in XBRL."
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"description": "Reference to the document"
},
"status": {
"type": "string",
"title": "Status",
"description": "Validity(K – valid, A – expired)"
}
},
"type": "object",
"required": [
"id",
"name",
"type",
"status"
],
"title": "ReportDocument"
},
"CustomValidationError": {
"properties": {
"message": {
"type": "string",
"title": "Message"
},
"code": {
"$ref": "#/components/schemas/APIError"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Id"
},
"timestamp": {
"type": "string",
"format": "date-time",
"title": "Timestamp",
"description": "Timestamp of the error"
}
},
"type": "object",
"required": [
"message",
"code",
"id"
],
"title": "CustomValidationError"
},
"APIError": {
"type": "integer",
"enum": [
2001,
4030,
4041,
4042,
4043,
4044,
4045,
4046,
4047,
4048,
4049
],
"title": "APIError"
},
"HTTPValidationError": {
"properties": {
"detail": {
"items": {
"$ref": "#/components/schemas/ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
},
"ValidationError": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
},
"input": {
"title": "Input"
},
"ctx": {
"type": "object",
"title": "Context"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
}
}
}
}