TIC
Sign in to Lens

Companies

List the positions several companies hold in other companies (AG Grid)

The positions that any of the given companies holds in other companies, in one list: for an audit firm group, every company where one of its firms is the elected auditor (positionTypes REV), for a completeness check against its client register. Holders: 1 to 50 organisationsnummer (with or without the dash, or twelve digits with the 16 prefix). Position codes: REV (revisor; an audit firm holds REV), REVH (huvudansvarig revisor), REVS (revisorssuppleant), KP, BO, FÖ ...; none keeps every position. Status: current (default, no end date), ended or all. Each row is the row of POST /companies/{id}/assignments with the holder (h_LegalName, a_RoleByCompanyRegistrationNumber) and the indications that the company is a public interest entity (företag av allmänt intresse): p_RegulatedMarket, the MICs of the regulated markets its shares are admitted to (ESMA FIRDS: Nasdaq Stockholm, NGM's regulated market, Nasdaq Helsinki and Copenhagen, Oslo Børs; First North, Spotlight and Nordic SME are MTFs, not regulated markets); p_IsRegulatedIssuer, in Finansinspektionen's register of issuers on a regulated market, shares or bonds, with a periodic report this or last year; p_FinancialPermit, Bolagsverket's permit for bank or insurance business or kreditmarknadsbolag; p_IsPublicCompany, publikt aktiebolag; p_IsPublicInterestEntity, any of the first three (a foreign bank's Swedish branch excepted). The indication is read from the registers, not a ruling. The request body is the AG Grid server-side request with holders, positionTypes, status, excludeCeased and publicInterestOnly; column ids are prefixed a_ (the position), c_ (the company's summary), d_ (the company), r_ (the acting person), h_ (the holder) and p_ (the public interest indications). Newest position first.

Enterprise+ tier
POSThttps://lens-api.tic.io/companies/assignments
Enterprise+ tier

Returns, in one list, the positions that any of up to 50 companies holds in other companies. An audit firm group gives the organisation numbers of its firms and positionTypes: ["REV"] and gets every company where one of its firms is the elected auditor, to check its client register for completeness. One row per position, newest first; the same list as one file is the CSV export. For one company’s positions, see roles in other companies.

The request body is the grid request described in Pagination, with these fields added:

Field Description
holders The organisation numbers of the companies holding the positions, 1 to 50, with or without the hyphen (556677-8899 or 5566778899)
positionTypes The position codes to keep, for example REV (auditor; an audit firm holds REV), REVH (auditor in charge), REVS (deputy auditor), KP or BO. Leave it out to keep every position
status current (the default) for the positions without an end date, ended for the ended ones, newest end first, or all for both
excludeCeased true to leave out the companies that have ceased
publicInterestOnly true to keep only the companies indicated as public interest entities, see below 
curl -X POST "https://lens-api.tic.io/companies/assignments" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "holders": ["556677-8899", "559900-1122"],
    "positionTypes": ["REV"],
    "excludeCeased": true,
    "startRow": 0,
    "endRow": 100
  }'

A holder that is not a valid organisation number, more than 50 holders, a position code that is not letters or an unknown status gives 400 with a code: invalid_holder, holders_required, too_many_holders, invalid_position_type, too_many_position_types or invalid_status.

Columns

The columns of roles in other companies (prefixes a_, c_, d_ and r_), and these. Sort and filter on the ids.

Column Description
h_LegalName The name of the company holding the position, its current name in the register
a_RoleByCompanyRegistrationNumber Its organisation number; roleByCompanyRegistrationNumberFormatted has the hyphen
p_RegulatedMarket The markets, as MIC codes, where the company’s shares are admitted to trading on a regulated market: XSTO Nasdaq Stockholm, XNGM Nordic Growth Market, XHEL Nasdaq Helsinki, XCSE Nasdaq Copenhagen, XOSL Oslo Børs. regulatedMarketName gives the names. First North, Spotlight and Nordic SME are multilateral trading facilities, not regulated markets
p_IsRegulatedIssuer The company is in Finansinspektionen’s register of issuers whose shares or bonds are admitted to trading on a regulated market, and filed a periodic report there this year or last year
p_FinancialPermit The company’s permit, registered with Bolagsverket, to carry on bank or insurance business, or as a credit market company (kreditmarknadsbolag)
p_IsPublicCompany The company is a public limited company (publikt aktiebolag)
p_IsPublicInterestEntity The indication that the company is a public interest entity (företag av allmänt intresse), see below

Public interest entities

A public interest entity is a company whose transferable securities, shares or bonds, are admitted to trading on a regulated market, a credit institution or an insurance company. Its audit has stricter rules, such as audit firm rotation. p_IsPublicInterestEntity is true when the company has shares on a regulated market (p_RegulatedMarket), is an issuer with Finansinspektionen (p_IsRegulatedIssuer, which covers bonds) or has a bank or insurance permit (p_FinancialPermit). A foreign bank’s Swedish branch is left out: it is part of the foreign institution. Being a public limited company does not by itself make a company a public interest entity.

The indication is read from the registers and is not a ruling. Check it against your own assessment, especially for a company that was listed or delisted during the year.

Authorization

x-api-keystringheaderrequired

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

Bodyapplication/json

holdersstring[] | null
positionTypesstring[] | null
statusstring | null
excludeCeasedboolean
publicInterestOnlyboolean
startRowinteger

format: int32

endRowinteger

format: int32

rowGroupColsRowGroupModel[] | null
Hide child attributes
idstring | null
displayNamestring | null
fieldstring | null
groupKeysstring[] | null
filterModelFilterModel[] | null
Hide child attributes
columnNamestring | null
columnNameWithAliasstring | nullread-only
filterTypestring | null
sortModelSortModel[] | null
Hide child attributes
sortstring

One of: asc desc

colIdstring | null

Responses

AG Grid page of CompanyHolderAssignment_Dto rows

Try it with a grid

A server-side data grid bound to this endpoint through the proxy. Sort and filter columns and watch the request body the grid sends; the response arrives as rows with lastrow.

Grid playgroundrequests: 0 · Fill in the parameters and run the query.
Authorization

Stored in this browser only (until you forget it) and sent as the x-api-key header through the documentation proxy.

Enter your API key to load the grid.

Last request body
{ "startRow": 0, "endRow": 50, "sortModel": [], "filterModel": {} }
Response

Sort or filter a column and the request body updates; the response arrives as rows and lastrow.