TIC
Sign in to Lens

Companies

Export the positions several companies hold in other companies as CSV

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. Every row without paging, newest position first, as a semicolon separated UTF-8 CSV with a Content-Disposition header. Holders and position codes are given comma separated or as repeated parameters: ?holders=556260-2747,556291-8473&positionTypes=REV.

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

Every row of roles of several companies as one CSV file, without paging, newest position first. Give the holders’ organisation numbers, and the position codes, comma separated or as repeated parameters. status, excludeCeased and publicInterestOnly work as in the grid request.

The file is UTF-8 with semicolons between the fields, and the Content-Disposition header gives its name. The company holding the position comes after the position’s end, and the public interest columns come last: regulated market, issuer with Finansinspektionen, bank or insurance permit, public limited company, and the public interest entity indication.

Every company where one of two audit firms is the elected auditor, leaving out ceased companies:

curl "https://lens-api.tic.io/companies/assignments/export?holders=556677-8899,559900-1122&positionTypes=REV&excludeCeased=true" \
  -H "x-api-key: YOUR_API_KEY" \
  -o auditor-assignments.csv

Authorization

x-api-keystringheaderrequired

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

Query parameters

holdersstring[]required

The holders' organisationsnummer, 1 to 50, comma separated or repeated

positionTypesstring[]

Position codes to keep, e.g. REV; none keeps every position

statusstring

current (default): the positions without an end date; ended: the ended ones; all: both

excludeCeasedboolean

Leave out the companies that have ceased. Default false

publicInterestOnlyboolean

Only the companies indicated as public interest entities. Default false

Responses

CSV download · text/csv

string