> ## 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 owner

> Gets a list of companies where the person has beneficiary owner entries

Lists all companies where the person has current of historic beneficial owner entries. Please note that
the default page size is 100 but this endpoint allows up to 1000 records
per page.

The result is flattened meaning it can include multiple lines for each registered case number and
year that specifies extent codes, extent descriptions, govern codes and govern descriptions. Also
it can include multiple results for each company depending on changes of beneficiary entries.

Includes a summary for the beneficial owner company but if the entry is governed through another
company we include company id, registration number and legal name.


## OpenAPI

````yaml get /datasets/persons/se/{personId}/beneficial-owner
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/persons/se/{personId}/beneficial-owner:
    get:
      tags:
        - Persons_SE_
      summary: Beneficial owner
      description: Gets a list of companies where the person has beneficiary owner entries
      operationId: PersonBeneficialOwner
      parameters:
        - name: personId
          in: path
          description: The person id
          required: true
          schema:
            type: integer
            format: int32
        - name: lastItemId
          in: query
          description: Take records after the id
          schema:
            type: integer
            format: int32
            default: 0
        - name: pageSize
          in: query
          description: Page size
          schema:
            type: integer
            format: int32
            default: 100
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Ormeo_Library_Dtos_PersonBolagsverketBeneficialOwnerItemsPagination
components:
  schemas:
    Ormeo_Library_Dtos_PersonBolagsverketBeneficialOwnerItemsPagination:
      type: object
      properties:
        pageSize:
          type: integer
          format: int32
        lastItemId:
          type: integer
          format: int64
        totalItems:
          type: integer
          format: int32
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_PersonBolagsverketBeneficialOwner
          nullable: true
      additionalProperties: false
    Ormeo_Library_Dtos_PersonBolagsverketBeneficialOwner:
      type: object
      properties:
        bolagsverket_BeneficialOwnerId:
          type: integer
          format: int32
        companyId:
          type: integer
          format: int32
        companyRegistrationNumber:
          type: string
          nullable: true
        legalName:
          type: string
          nullable: true
        extentCode:
          type: string
          nullable: true
        extentDescription:
          type: string
          nullable: true
        fromDate:
          type: string
          format: date-time
          nullable: true
        untilDate:
          type: string
          format: date-time
          nullable: true
        caseNumber:
          type: integer
          format: int32
          nullable: true
        caseYear:
          type: integer
          format: int32
          nullable: true
        governCode:
          type: string
          nullable: true
        governDescription:
          type: string
          nullable: true
        governThroughCompanyId:
          type: integer
          format: int32
          nullable: true
        governThroughCompanyRegistrationNumber:
          type: string
          nullable: true
        governThroughCompanyLegalName:
          type: string
          nullable: true
        companySummary:
          $ref: '#/components/schemas/Ormeo_Library_Dtos_CompanySummary_Dto'
      additionalProperties: false
    Ormeo_Library_Dtos_CompanySummary_Dto:
      type: object
      properties:
        companyId:
          type: integer
          format: int32
        companySummaryId:
          type: integer
          format: int32
        legalName:
          type: string
          nullable: true
        purpose:
          type: string
          nullable: true
        sniCodes:
          type: string
          nullable: true
        sniCodes2025:
          type: string
          nullable: true
        sniCodesList:
          type: object
          additionalProperties:
            type: string
            nullable: true
          nullable: true
        sniCodes2025List:
          type: object
          additionalProperties:
            type: string
            nullable: true
          nullable: true
        visitingAddressStreet:
          type: string
          nullable: true
        visitingAddressPostalCode:
          type: string
          nullable: true
        visitingAddressCity:
          type: string
          nullable: true
        visitingAddressCountryCodeAlpha3:
          type: string
          nullable: true
        visitingAddressPosition:
          type: array
          items:
            type: number
            format: double
          nullable: true
        isVistingAddressEmpty:
          type: boolean
          readOnly: true
        isVisitingAddressMissing:
          type: boolean
          readOnly: true
        visitingAddressPositionLatitude:
          type: number
          format: double
          nullable: true
        visitingAddressPositionLongitude:
          type: number
          format: double
          nullable: true
        mailingAddressStreet:
          type: string
          nullable: true
        mailingAddressPostalCode:
          type: string
          nullable: true
        mailingAddressCity:
          type: string
          nullable: true
        mailingAddressCountryCodeAlpha3:
          type: string
          nullable: true
        isMailingAddressEmpty:
          type: boolean
          readOnly: true
        isMailingAddressMissing:
          type: boolean
          readOnly: true
        mailingAddressPosition:
          type: array
          items:
            type: number
            format: double
          nullable: true
        mailingAddressPositionLatitude:
          type: number
          format: double
          nullable: true
        mailingAddressPositionLongitude:
          type: number
          format: double
          nullable: true
        numberOfWorkplaces:
          type: integer
          format: int32
          nullable: true
        registeredOfficeMunicipalityCode:
          type: string
          nullable: true
        registeredOfficeCountyCode:
          type: string
          nullable: true
        registeredVAT:
          type: boolean
          nullable: true
        registeredFTax:
          type: boolean
          nullable: true
        registeredPayroll:
          type: boolean
          nullable: true
        scB_NumberOfEmployeesInterval:
          type: integer
          format: int32
          nullable: true
        scB_NumberOfEmployeesIntervalDescription:
          type: string
          nullable: true
          readOnly: true
        scB_OwnershipType:
          type: integer
          format: int32
          nullable: true
        scB_OwnershipTypeDescription:
          type: string
          nullable: true
          readOnly: true
        scB_TurnoverInterval:
          type: integer
          format: int32
          nullable: true
        scB_TurnoverIntervalDescription:
          type: string
          nullable: true
          readOnly: true
        scB_PrivPublType:
          type: integer
          format: int32
          nullable: true
        scB_PrivPublTypeDescription:
          type: string
          nullable: true
          readOnly: true
        scB_TradeExportInterval:
          type: integer
          format: int32
          nullable: true
        scB_TradeExportIntervalDescription:
          type: string
          nullable: true
          readOnly: true
        scB_TradeImportInterval:
          type: integer
          format: int32
          nullable: true
        scB_TradeImportIntervalDescription:
          type: string
          nullable: true
          readOnly: true
        scB_PropertyTaxationInterval:
          type: integer
          format: int32
          nullable: true
        scB_PropertyTaxationIntervalDescription:
          type: string
          nullable: true
          readOnly: true
        period1:
          type: integer
          format: int32
          nullable: true
        period1_IS_NetSalesK:
          type: integer
          format: int32
          nullable: true
        period1_FN_NumberOfEmployees:
          type: number
          format: double
          nullable: true
        period1_IS_OperatingProfitOrLossK:
          type: integer
          format: int32
          nullable: true
        period1_IsAudited:
          type: boolean
          nullable: true
        period1_Lines:
          type: array
          items:
            type: string
          nullable: true
          readOnly: true
        period2:
          type: integer
          format: int32
          nullable: true
        period2_IS_NetSalesK:
          type: integer
          format: int32
          nullable: true
        period2_FN_NumberOfEmployees:
          type: number
          format: double
          nullable: true
        period2_IS_OperatingProfitOrLossK:
          type: integer
          format: int32
          nullable: true
        period2_IsAudited:
          type: boolean
          nullable: true
        period3:
          type: integer
          format: int32
          nullable: true
        period3_IS_NetSalesK:
          type: integer
          format: int32
          nullable: true
        period3_FN_NumberOfEmployees:
          type: number
          format: double
          nullable: true
        period3_IS_OperatingProfitOrLossK:
          type: integer
          format: int32
          nullable: true
        period3_IsAudited:
          type: boolean
          nullable: true
        intelligenceScoreTotal:
          type: integer
          format: int32
          nullable: true
        intelligenceNumberOfMax:
          type: integer
          format: int32
          nullable: true
        numberOfEmailAddresses:
          type: integer
          format: int32
          nullable: true
        lastCompanyActivityStatus:
          $ref: '#/components/schemas/Ormeo_Library_Entities_CompanyStatusType'
        lastCompanyActivityStatusDescription:
          type: string
          nullable: true
          readOnly: true
        lastCompanyStatusType:
          $ref: '#/components/schemas/Ormeo_Library_Entities_CompanyStatusType'
        lastCompanyStatusDescription2:
          $ref: '#/components/schemas/Ormeo_Library_Common_CompanyStatusListType'
        lastCompanyStatusDate:
          type: string
          format: date-time
          nullable: true
        lastCompanyStatusDescription:
          type: string
          nullable: true
        lastUpdatedAtUtc:
          type: string
          format: date-time
          nullable: true
        hasAuditor:
          type: boolean
          nullable: true
        companyRepresentativeBornYear:
          type: integer
          format: int32
          nullable: true
        kfM_DebtBalanceTotalAmountInSEK:
          type: number
          format: double
          nullable: true
        kfM_RecordOfNonPaymentNumberOfCases:
          type: integer
          format: int32
          nullable: true
        registeredAML:
          type: boolean
          nullable: true
        shouldBeRegisteredAML:
          type: boolean
          nullable: true
          readOnly: true
        mailingAddressLantmaterietLocatedOnPropertyId:
          type: string
          format: uuid
          nullable: true
        mailingAddressLantmaterietLocationalAddressId:
          type: string
          format: uuid
          nullable: true
        visitingAddressLantmaterietLocatedOnPropertyId:
          type: string
          format: uuid
          nullable: true
        visitingAddressLantmaterietLocationalAddressId:
          type: string
          format: uuid
          nullable: true
        visitingAddressCO:
          type: string
          nullable: true
        mailingAddressCO:
          type: string
          nullable: true
        visitingAddressId:
          type: integer
          format: int32
          nullable: true
        mailingAddressId:
          type: integer
          format: int32
          nullable: true
      additionalProperties: false
    Ormeo_Library_Entities_CompanyStatusType:
      enum:
        - reorganizationOfBusinessCommenced
        - bankruptcyTerminatedWithSurplus
        - dissolvedByCompanyDemerger
        - liquidationTerminated
        - mergerProcedureCommenced
        - acquisitionByCompanyDemerger
        - acquisitionByMerger
        - dissolvedByMergerProcedure
        - liquidationDecided
        - bankruptcyProceedingsCommenced
        - bankruptcyProceedingsTerminated
        - mergerPermitted
        - unused1
        - unused2
        - unused3
        - liquidationContinues
        - struckOffRegisterCrossBorderMerger
        - bankruptcyRepealedByCourt
        - liquidationEnds
        - liquidationRepealedByCourt
        - companyStruckOff
        - reorganizationOfBusinessEnded
        - reorganizationOfBusinessRepealedByCourt
        - resolutionCommenced
        - resolutionTerminated
        - resolutionRepealedByCourt
        - companyStruckOffTradeRegisterAct
        - deregisteredNewHolder
        - deregistered
        - reintroduced
        - companyStruckOffOwnRequest
        - companyStruckOffByRegistrationOffice
        - companyStruckOffReenteredAsJointStock
        - branchStruckOffForeignLiquidationOrBankruptcy
        - branchStruckOffOperationsCeased
        - branchStruckOffMissingCEO
        - branchStruckOffCourtOrder
        - branchStruckOffAnnualReportMissing
        - isActive
        - isNoLongerActive
        - hasNeverBeenActive
        - taxAuthorityStatus
        - companyDemergerCommenced
        - settlementNegotiationsCommenced
        - settlementNegotiationsTerminated
        - settlementNegotiationsRepealedByCourt
        - acquisitionExpired
        - acquisitionTerminated
        - acquisitionByMultipleMergers
        - acquisitionRepealedByCourt
        - mergerExpired
        - mergerRepealedByCourt
        - other
      type: string
    Ormeo_Library_Common_CompanyStatusListType:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/Ormeo_Library_Entities_CompanyStatusType'
        name_EN:
          type: string
          nullable: true
        name_SE:
          type: string
          nullable: true
        bolagsverketCode:
          type: string
          nullable: true
        isCeased:
          type: boolean
          nullable: true
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: apiKey
      name: x-api-key
      in: header

````