TIC
Sign in to Lens

Companies

Get beneficial owners for a company

Returns the Bolagsverket beneficial-owner notifications for the company, with owners, representatives, govern codes, and any flagged suspect notifications. Pro tier has personal identity numbers masked.

Pro+ tier
GEThttps://lens-api.tic.io/companies/{id}/beneficial-owners

Authorization

x-api-keystringheaderrequired

Your API key, sent in the x-api-key header.

Path parameters

idintegerrequired

Internal company ID

format: int32

Responses

List of beneficial-owner notifications · application/json

bolagsverket_BeneficialOwnerNotificationIdinteger

format: int32

registrationstring | null

format: uuid

notificationDatestring | null

format: date-time

fromDatestring | null

format: date-time

caseNumberinteger | null

format: int32

caseYearinteger | null

format: int32

registrationNumberstring | null
companyNamestring | null
companyCodestring | null
companyCodeDescriptionstring | null
statusCodestring | null
statusDescriptionstring | null
lastUpdatedAtUtcstring

format: date-time

bolagsverket_BeneficialOwnerSuspectNotificationIdinteger | null

format: int32

companyIdinteger | null

format: int32

bolagsverket_BeneficialOwnerBeneficialOwner_Dto[] | null
Hide child attributes
bolagsverket_BeneficialOwnerIdinteger

format: int32

bolagsverket_BeneficialOwnerNotificationIdinteger

format: int32

personIdinteger | null

format: int32

personalIdentityNumberstring | null
fallbackPersonalIdentityNumberstring | nullread-only
firstNamestring | null
middleNamestring | null
lastNamestring | null
fallbackNamestring | nullread-only
citizenshipCountryCodestring | null
countryOfResidenceCodestring | null
extentCodestring | null
extentDescriptionstring | null
bolagsverket_BeneficialOwnerGovernBeneficialOwnerGovern_Dto[] | null
Show child attributes
bolagsverket_BeneficialOwnerGovernIdinteger

format: int32

bolagsverket_BeneficialOwnerIdinteger

format: int32

governCodestring | null
governDescriptionstring | null
namestring | null
registrationNumberstring | null
companyIdinteger | null

format: int32

personPerson_Dto
Show child attributes
personIdinteger

format: int32

nationalityCountryCodeAlpha2string | null
personalIdentityNumberstring | null
givenNamestring | null
firstNamestring | null
middleNamestring | null
lastNamestring | null
fullNamestring | null
isProtectedboolean | null
citizenshipCountryCodestring | null
countryOfResidenceCodestring | null
fallbackNamestring | nullread-only
fallbackPersonalIdentityNumberstring | nullread-only
isMarriedboolean | null
sexstring

One of: male female

isCoordinationNumberboolean | null
birthdaystring | null
ageinteger | nullread-only

format: int32

kivraUpdatedAtstring | null

format: date-time

kivraboolean | null
personAddressPersonAddress_Dto[] | null
Show child attributes
personAddressIdinteger

format: int32

personIdinteger

format: int32

addressTypestring

One of: populationRegisterAddress contactAddress internationalAddress particularAddress particularInternationalAddress contactInternationalAddress

addressTypeDescriptionstring | nullread-only
labelstring | null
houseNumberstring | null
costring | null
streetstring | null
postalCodestring | null
citystring | null
statestring | null
countystring | null
districtstring | null
countryNamestring | null
countryCodeAlpha3string | null
localitystring | null
localityTypestring | null
positionGeometry
Show child attributes
factoryGeometryFactory

Nested structure omitted at this depth.

userDataany
sridinteger

format: int32

geometryTypestring | nullread-only
ogcGeometryTypestring

One of: point lineString polygon multiPoint multiLineString multiPolygon geometryCollection circularString compoundCurve curvePolygon multiCurve multiSurface curve surface polyhedralSurface tin

precisionModelPrecisionModel

Nested structure omitted at this depth.

coordinateCoordinate

Nested structure omitted at this depth.

coordinatesCoordinate[] | nullread-only
numPointsintegerread-only

format: int32

numGeometriesintegerread-only

format: int32

isSimplebooleanread-only
isValidbooleanread-only
isEmptybooleanread-only
areanumberread-only

format: double

lengthnumberread-only

format: double

centroidPoint

Nested structure omitted at this depth.

interiorPointPoint

Nested structure omitted at this depth.

pointOnSurfacePoint

Nested structure omitted at this depth.

dimensionstring

One of: point curve a collapse dontcare true false

boundaryGeometryrecursive
boundaryDimensionstring

One of: point curve a collapse dontcare true false

envelopeGeometryrecursive
envelopeInternalEnvelope

Nested structure omitted at this depth.

isRectanglebooleanread-only
lastUpdatedAtUtcstring

format: date-time

foundAtUtcstring

format: date-time

companyDataSourceTypestring

One of: bolt dash flux pixel quark spark vector cipher delta omega nova apex zenith pulse nexus helix prism vertex ion codec vortex matrix byte glitch echo rune sync axiom core node nano photon orbit tensor kernel beacon crypto proxy lumen strobe neutron radix

companyDataSourceTypeDescriptionstring | nullread-only
countryLocalizedstring | nullread-only
orginalLabelstring | null
fileIdinteger | null

format: int64

orginalAddressHashstring | null
countyCodestring | null
municipalityCodestring | null
belagenhetsadressObjektIdentitetstring | null

format: uuid

lastSeenAtUtcstring | null

format: date-time

addressIdinteger | null

format: int32

addressIntelligenceAddressIntelligence_Dto[] | null
Show child attributes
addressIntelligenceIdinteger

format: int32

addressIdinteger

format: int32

addressIntelligenceTypestring

One of: unknownAddress personsRegistered companyBankruptcies apartments propertyForfeited vulnerableArea

addressIntelligenceTypeDescriptionstring | nullread-only
addressIntelligenceSubTypestring | null
addressIntelligenceSubTypeDescriptionstring | nullread-only
addressIntelligencePolicyIdinteger | null

format: int32

notesstring | null
notesEnstring | null
notesSvstring | null
scoreinteger | null

format: int32

firstSeenAtUtcstring | null

format: date-time

lastSeenAtUtcstring | null

format: date-time

lastUpdatedAtUtcstring

format: date-time

intelligenceNotesTypeinteger | null

format: int32

notesValue1string | null
notesValue2string | null
notesValue3string | null
notesValue4string | null
personEventPersonEvent_Dto[] | null
Show child attributes
personEventIdinteger

format: int32

personIdinteger

format: int32

eventDatestring | null

format: date-time

eventTypestring

One of: changePopulationRegisterAddress changeName changeContactAddress deregistered changeInternationalAddress changeParticularAddress changeParticularInternationalAddress changeContactInternationalAddress relationshipCreated relationshipDeleted

eventDescriptionstring | nullread-only
eventMetadatastring | null
lastUpdatedAtUtcstring

format: date-time

personBanPursueBusinessPersonBanPursueBusiness_Dto[] | null
Show child attributes
personBanPursueBusinessIdinteger

format: int32

personIdinteger

format: int32

banCodestring | null
courtCodeinteger | null

format: int32

decisionDatestring | null

format: date-time

typeOfDecisionstring | null
decisionDateForTemporaryBanstring | null

format: date-time

followUpDatestring | null

format: date-time

banFromDatestring | null

format: date-time

banToDatestring | null

format: date-time

windedUpOperationsUntilDatestring | null

format: date-time

exemptionFromDatestring | null

format: date-time

exemptionToDatestring | null

format: date-time

recalledExemptionDatestring | null

format: date-time

repealedDatestring | null

format: date-time

hasCeasedDueToDeceasedboolean | null
notesstring | null
isRemovedboolean | null
companyDataSourceTypestring

One of: bolt dash flux pixel quark spark vector cipher delta omega nova apex zenith pulse nexus helix prism vertex ion codec vortex matrix byte glitch echo rune sync axiom core node nano photon orbit tensor kernel beacon crypto proxy lumen strobe neutron radix

firstSeenAtUtcstring | null

format: date-time

lastUpdatedAtUtcstring

format: date-time

fileIdinteger | null

format: int64

personCreditQuestionPersonCreditQuestion_Dto[] | null
Show child attributes
personCreditQuestionIdinteger

format: int32

personIdinteger

format: int32

questionerstring | null
amountnumber | null

format: double

iso4217CurrencyCode3string | null
firstSeenAtUtcstring | null

format: date-time

lastUpdatedAtUtcstring | null

format: date-time

personIdentityNumberPersonIdentityNumber_Dto[] | null
Show child attributes
personIdentityNumberIdinteger

format: int32

personIdinteger

format: int32

personIdentityNumberTypestring

One of: swedishPersonalIdentityNumber swedishCoordinationNumber swedishImmunityNumber

personIdentityNumberTypeDescriptionstring | nullread-only
personalIdentityNumberstring | null
isBlockedboolean | null
companyDataSourceTypestring

One of: bolt dash flux pixel quark spark vector cipher delta omega nova apex zenith pulse nexus helix prism vertex ion codec vortex matrix byte glitch echo rune sync axiom core node nano photon orbit tensor kernel beacon crypto proxy lumen strobe neutron radix

firstSeenAtUtcstring | null

format: date-time

lastUpdatedAtUtcstring

format: date-time

fileIdinteger | null

format: int64

spar_NotificationRecordIdinteger | null

format: int32

blockedByReasonstring | null
blockedByReasonDescriptionstring | nullread-only
bolagsverket_BeneficialOwnerRepresentativeBeneficialOwnerRepresentative_Dto[] | null
Hide child attributes
bolagsverket_BeneficialOwnerRepresentativeIdinteger

format: int32

bolagsverket_BeneficialOwnerNotificationIdinteger

format: int32

personIdinteger | null

format: int32

personalIdentityNumberstring | null
firstNamestring | null
middleNamestring | null
lastNamestring | null
citizenshipCountryCodestring | null
countryOfResidenceCodestring | null
bolagsverket_BeneficialOwnerSuspectNotificationBeneficialOwnerSuspectNotification_Dto
Hide child attributes
bolagsverket_BeneficialOwnerSuspectNotificationIdinteger

format: int32

registrationDatestring | null

format: date-time

caseNumberinteger | null

format: int32

caseYearinteger | null

format: int32

originCaseNumberinteger | null

format: int32

originCaseYearinteger | null

format: int32

suspectCodeinteger | null

format: int32

lastUpdatedAtUtcstring

format: date-time