> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tic.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Beneficial owners

> Gets current and historic beneficial owner records and any exempts from registration of beneficial owners

This endpoint is specific for Swedish companies since it contain details about current and historic beneficial owners and
any exempts from registration of beneficial owners.


## OpenAPI

````yaml get /datasets/companies/{companyId}/se/beneficial-owners
openapi: 3.0.4
info:
  title: TIC API
  description: ''
  version: v1
servers:
  - url: https://api.tic.io/
security:
  - ApiKey: []
tags:
  - name: BolagsverketStatistics
  - name: Companies
  - name: Companies_SE_
  - name: DocumentDelivery
  - name: EuropeanCommission
  - name: FinancialDocuments
  - name: Finansinspektionen
  - name: Free
  - name: ICA
  - name: ICAStatistics
  - name: Lists
  - name: Media
  - name: Persons
  - name: Persons_SE_
  - name: Properties_SE_
  - name: PTSPortings
  - name: Reseller
  - name: SearchBankruptciesReports
  - name: SearchCompanies
  - name: SearchCompaniesReports
  - name: SearchCompanyWorkplaces
  - name: SearchPerson
  - name: SearchProperties_SE_
  - name: SearchVehicles
  - name: TeamDocumentOrders
  - name: Teams
  - name: User
  - name: Vehicles_SE_
  - name: WatchLists
paths:
  /datasets/companies/{companyId}/se/beneficial-owners:
    get:
      tags:
        - Companies_SE_
      summary: Beneficial owners
      description: >-
        Gets current and historic beneficial owner records and any exempts from
        registration of beneficial owners
      operationId: CompanyBeneficialOwners
      parameters:
        - name: companyId
          in: path
          description: The company id
          required: true
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_CompanyBeneficialOwnerSv_Dto
components:
  schemas:
    Ormeo_WebAPI_Models_Datasets_Company_CompanyBeneficialOwnerSv_Dto:
      type: object
      properties:
        notifications:
          type: array
          items:
            $ref: >-
              #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwnerNotification_Dto
          nullable: true
        exempts:
          type: array
          items:
            $ref: >-
              #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_CompanyBeneficiaryExempt_Dto
          nullable: true
      additionalProperties: false
    Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwnerNotification_Dto:
      type: object
      properties:
        bolagsverket_BeneficialOwnerNotificationId:
          type: integer
          format: int32
        registration:
          type: string
          format: uuid
          nullable: true
        notificationDate:
          type: string
          format: date-time
          nullable: true
        fromDate:
          type: string
          format: date-time
          nullable: true
        caseNumber:
          type: integer
          format: int32
          nullable: true
        caseYear:
          type: integer
          format: int32
          nullable: true
        registrationNumber:
          type: string
          nullable: true
        companyName:
          type: string
          nullable: true
        companyCode:
          type: string
          nullable: true
        companyCodeDescription:
          type: string
          nullable: true
        statusCode:
          type: string
          nullable: true
        statusDescription:
          type: string
          nullable: true
        lastUpdatedAtUtc:
          type: string
          format: date-time
        bolagsverket_BeneficialOwnerSuspectNotificationId:
          type: integer
          format: int32
          nullable: true
        companyId:
          type: integer
          format: int32
          nullable: true
        bolagsverket_BeneficialOwner:
          type: array
          items:
            $ref: >-
              #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwner_Dto
          nullable: true
        bolagsverket_BeneficialOwnerRepresentative:
          type: array
          items:
            $ref: >-
              #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwnerRepresentative_Dto
          nullable: true
        bolagsverket_BeneficialOwnerSuspectNotification:
          $ref: >-
            #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwnerSuspectNotification_Dto
      additionalProperties: false
    Ormeo_WebAPI_Models_Datasets_Company_CompanyBeneficiaryExempt_Dto:
      type: object
      properties:
        from:
          type: string
          format: date-time
          nullable: true
        to:
          type: string
          format: date-time
          nullable: true
      additionalProperties: false
    Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwner_Dto:
      type: object
      properties:
        bolagsverket_BeneficialOwnerId:
          type: integer
          format: int32
        bolagsverket_BeneficialOwnerNotificationId:
          type: integer
          format: int32
        personId:
          type: integer
          format: int32
          nullable: true
        personalIdentityNumber:
          type: string
          nullable: true
        fallbackPersonalIdentityNumber:
          type: string
          nullable: true
          readOnly: true
        firstName:
          type: string
          nullable: true
        middleName:
          type: string
          nullable: true
        lastName:
          type: string
          nullable: true
        fallbackName:
          type: string
          nullable: true
          readOnly: true
        citizenshipCountryCode:
          type: string
          nullable: true
        countryOfResidenceCode:
          type: string
          nullable: true
        extentCode:
          type: string
          nullable: true
        extentDescription:
          type: string
          nullable: true
        bolagsverket_BeneficialOwnerGovern:
          type: array
          items:
            $ref: >-
              #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwnerGovern_Dto
          nullable: true
        person:
          $ref: '#/components/schemas/Ormeo_WebAPI_Models_Datasets_Persons_Person_Dto'
      additionalProperties: false
    Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwnerRepresentative_Dto:
      type: object
      properties:
        bolagsverket_BeneficialOwnerRepresentativeId:
          type: integer
          format: int32
        bolagsverket_BeneficialOwnerNotificationId:
          type: integer
          format: int32
        personId:
          type: integer
          format: int32
          nullable: true
        personalIdentityNumber:
          type: string
          nullable: true
        firstName:
          type: string
          nullable: true
        middleName:
          type: string
          nullable: true
        lastName:
          type: string
          nullable: true
        citizenshipCountryCode:
          type: string
          nullable: true
        countryOfResidenceCode:
          type: string
          nullable: true
      additionalProperties: false
    Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwnerSuspectNotification_Dto:
      type: object
      properties:
        bolagsverket_BeneficialOwnerSuspectNotificationId:
          type: integer
          format: int32
        registrationDate:
          type: string
          format: date-time
          nullable: true
        caseNumber:
          type: integer
          format: int32
          nullable: true
        caseYear:
          type: integer
          format: int32
          nullable: true
        originCaseNumber:
          type: integer
          format: int32
          nullable: true
        originCaseYear:
          type: integer
          format: int32
          nullable: true
        suspectCode:
          type: integer
          format: int32
          nullable: true
        lastUpdatedAtUtc:
          type: string
          format: date-time
      additionalProperties: false
    Ormeo_WebAPI_Models_Datasets_Company_Bolagsverket_BeneficialOwnerGovern_Dto:
      type: object
      properties:
        bolagsverket_BeneficialOwnerGovernId:
          type: integer
          format: int32
        bolagsverket_BeneficialOwnerId:
          type: integer
          format: int32
        governCode:
          type: string
          nullable: true
        governDescription:
          type: string
          nullable: true
        name:
          type: string
          nullable: true
        registrationNumber:
          type: string
          nullable: true
        companyId:
          type: integer
          format: int32
          nullable: true
      additionalProperties: false
    Ormeo_WebAPI_Models_Datasets_Persons_Person_Dto:
      type: object
      properties:
        personId:
          type: integer
          format: int32
        nationalityCountryCodeAlpha2:
          type: string
          nullable: true
        personalIdentityNumber:
          type: string
          nullable: true
        isProtected:
          type: boolean
          nullable: true
        isMarried:
          type: boolean
          nullable: true
        givenName:
          type: string
          nullable: true
        firstName:
          type: string
          nullable: true
        middleName:
          type: string
          nullable: true
        lastName:
          type: string
          nullable: true
        fullName:
          type: string
          nullable: true
          readOnly: true
        sex:
          $ref: '#/components/schemas/Ormeo_Library_Entities_PersonSexType'
        isCoordinationNumber:
          type: boolean
          nullable: true
        birthday:
          type: string
          nullable: true
        age:
          type: integer
          format: int32
          nullable: true
          readOnly: true
      additionalProperties: false
    Ormeo_Library_Entities_PersonSexType:
      enum:
        - male
        - female
      type: string
  securitySchemes:
    ApiKey:
      type: apiKey
      name: x-api-key
      in: header

````