--- title: "List the positions several companies hold in other companies (AG Grid)" description: "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." url: https://docs.tic.io/api-lens/companies/list-the-positions-several-companies-hold-in-other-companies-ag-grid lastmod: 2026-11-14T11:28:57.000Z --- # 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. ```http POST https://lens-api.tic.io/companies/assignments ``` **Requires:** Enterprise+ tier **Authentication:** API key in the `x-api-key` header. ## Request body (application/json) ```json { "holders": [ "" ], "positionTypes": [ "" ], "status": "", "excludeCeased": true, "publicInterestOnly": true, "startRow": 123, "endRow": 123, "rowGroupCols": [ { "id": "", "displayName": "", "field": "" } ], "groupKeys": [ "" ], "filterModel": [ { "columnName": "", "filterType": "" } ], "sortModel": [ { "sort": "asc", "colId": "" } ] } ``` ## Responses ### 200 AG Grid page of CompanyHolderAssignment_Dto rows ### 400 No holder, more than 50, one that is no organisationsnummer, a position code that is no code, or an unknown status 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](/api-lens/companies/export-the-positions-several-companies-hold-in-other-companies-as-csv). For one company's positions, see [roles in other companies](/api-lens/companies/list-companies-where-the-company-holds-a-role-ag-grid). The request body is the grid request described in [Pagination](/api-lens/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 | ```bash 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](/api-lens/companies/list-companies-where-the-company-holds-a-role-ag-grid) (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.