Estonian e-Business Register (RIK)

Estonian e-Business Register (RIK) Beneficial Owners API

The beneficialOwners API from Estonian e-Business Register (RIK) — 1 operation(s) for beneficialowners.

GitHub OpenAPI

Operations 1

GET /beneficialOwners/vip_level Get VIP level for a physical or juridical entity #

Documentation

📖
Documentation
https://ar-rest.rik.ee/docs

Specifications

⚙
OpenAPI
https://artifacts.apis.io/ariregister-rik-ee/openapi/ariregister-rik-ee-beneficialowners-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ariregister-rik-ee:ariregister-rik-ee-beneficialowners-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ariregister-rik-ee-beneficialowners-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Ariregister Rik Ee Beneficial Owners API
  version: 1.4.0
  description: 'Operations tagged beneficialOwners across 2 of this provider''s published API definitions: ariregister-rik-ee-ar-rest-openapi.json, ariregister-rik-ee-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://ar-rest.rik.ee
  description: Production (named in the provider docs at avaandmed.ariregister.rik.ee, which link https://ar-rest.rik.ee/docs)
security:
- OAuth2PasswordBearer: []
tags:
- name: beneficialOwners
paths:
  /beneficialOwners/vip_level:
    get:
      tags:
      - beneficialOwners
      summary: Get VIP level for a physical or juridical entity
      description: 'Returns the VIP level for a physical or juridical entity based on the provided personal code or company code and country.

        If permission is granted, the exact VIP level is returned. Otherwise, only VIP status is returned.'
      operationId: vip_level
      parameters:
      - name: personType
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/PersonType'
          description: 'Person Type: J - Juridical, P - Physical'
          default: P
        description: 'Person Type: J - Juridical, P - Physical'
      - name: entityCode
        in: query
        required: true
        schema:
          type: string
          description: Personal code or Company Code
          title: Entitycode
        description: Personal code or Company Code
      - name: entityCodeCountry
        in: query
        required: true
        schema:
          type: string
          description: Country of the Entity Code (ISO 3166-1 alpha-3)
          title: Entitycodecountry
        description: Country of the Entity Code (ISO 3166-1 alpha-3)
      - name: apiVersion
        in: header
        required: false
        schema:
          $ref: '#/components/schemas/ApiVersions'
          description: Api version header
          supported_versions:
          - V1
          default: V1
        description: Api version header
      - name: acceptLanguage
        in: header
        required: false
        schema:
          $ref: '#/components/schemas/AcceptLanguage'
          description: Language of translations of classifiers (est-Estonian, eng-English)
          default: est
        description: Language of translations of classifiers (est-Estonian, eng-English)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BOVipLevelResponse'
        '403':
          description: Service access denied.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomValidationError'
          description: Not Found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ApiVersions:
      type: string
      enum:
      - V1
      title: ApiVersions
    PersonType:
      type: string
      enum:
      - J
      - P
      title: PersonType
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AcceptLanguage:
      type: string
      enum:
      - est
      - eng
      title: AcceptLanguage
    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
    APIError:
      type: integer
      enum:
      - 2001
      - 4030
      - 4041
      - 4042
      - 4043
      - 4044
      - 4045
      - 4046
      - 4047
      - 4048
      - 4049
      title: APIError
    BOVipLevelResponse:
      properties:
        level:
          anyOf:
          - type: string
            enum:
            - VIP1
            - VIP2
            - VIP3
          - type: string
          - type: 'null'
          title: Level
        isVIP:
          type: boolean
          title: Isvip
          description: Indicates if the entity has a VIP level
      type: object
      required:
      - level
      - isVIP
      title: BOVipLevelResponse
  securitySchemes:
    OAuth2PasswordBearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-refined-from:
- ariregister-rik-ee-ar-rest-openapi.json
- ariregister-rik-ee-openapi.yml