Company annual reports

Method: GET /company/documents/reports/financialYear

OpenAPI/Swagger: https://ar-rest.rik.ee/docs#/Company/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"
 }
 }
 }
}