Companies
Get the company report (företagsupplysning) as PDF
The company report (företagsupplysning) as a PDF, A4 portrait: company information, creditworthiness and risk class, the board, compliance and annual reports risk, the real-time and network risk, debts at Kronofogden, the financial summary, and the board, representatives and beneficial owners with their personal identity numbers, then the chosen sections. sections is a comma-separated list of section keys from GET /companies/company-report/sections (timeline, signals, financials, debts, status, registrations, businessMortgages, group, properties, vehicles, servingPermits, workplaces); left out, the default selection (timeline, signals, financials, as the plan includes them); empty, the main part alone. Not for an enskild firma registered on its owner's personnummer. Shares the limit of 30 requests a minute with GET /companies/{id}/risks.
The company report, företagsupplysning in TIC LENS, as a PDF: a report on a Swedish company in the way the credit bureaus lay theirs out, produced on request from the same data as the company page and its risk panel. Unlike the other PDF reports it is not one view. It brings together the company’s facts, its creditworthiness and risks, its debts, its accounts and its people, and you choose what else goes in.
The pages are A4 portrait, numbered “Page 1 of 7”. The first page is a summary.
What every report holds
| Part | Contents | From |
|---|---|---|
| Company information | Name, organisation number, legal form, status, registration date, registered office, postal address, industry, share capital, employees, net sales, F-tax, VAT and employer registration, parent company, pending cases at Bolagsverket and open liquidation orders | Core company details |
| Creditworthiness | The credit score, or why it cannot be determined, with the risk class and risk forecast; the board, compliance and annual reports risk; the real-time risk and the network risk | Risk & credit score |
| Debts and payment remarks | Payment orders, payment remarks, the debt balance and active distraints at Kronofogden | Risk & credit score |
| Behind the creditworthiness | What the credit rules found; for a score that cannot be determined, what to check before a decision | Risk & credit score |
| Board, compliance and annual reports | Up to five remarks each, as the risk panel in TIC LENS shows them | Risk & credit score |
| Financial summary | The latest four fiscal years: net sales, operating profit, profit after financial items, total assets, employees, margins, equity ratio and net sales change, in thousands of SEK | Core company details |
| Board and representatives | The current board, management, auditors and other positions, and those who left in the last three years: position, name, personal identity number (organisation number for a company, such as an audit firm), start and end; the signatory rule | Representatives |
| Beneficial owners | The current registration: each owner’s name, personal identity number, nationality, the extent of control and how it is exercised, with the companies it runs through and their organisation numbers | Beneficial owners |
The risk gauges show the level (low, moderate, high, very high), as TIC LENS does. A protected identity is shown without a personal identity number, as in the JSON endpoints.
Optional sections
| Key | Section | Default | Same as |
|---|---|---|---|
timeline |
The company’s story and the model’s view: the model’s 12-month probability of bankruptcy month by month over 36 months, the events per month and the credit rating’s forecast, with a table of the months that brought new events | Yes | Risk timeline |
signals |
Real-time risk: every signal with its level, date and note | Yes | Risk & credit score |
financials |
Annual reports: income statement, balance sheet and key metrics for the latest four fiscal years | Yes | Full annual report financials |
debts |
Debts at Kronofogden in detail | No | Debts |
status |
Status history | No | Status history |
registrations |
F-tax, VAT and employer registrations | No | Tax registrations |
businessMortgages |
Business mortgages with their register cases and entries | No | Business mortgages |
group |
The group structure | No | Group structure |
properties |
Real estate | No | Properties |
vehicles |
Current vehicles: registration number, role, model and type, year and status, acquisition date, leasing, credit purchase and stolen. Owner and user names are not included | No | Current vehicles |
servingPermits |
Serving permits | No | Serving permits |
workplaces |
Workplaces | No | Workplaces |
Each section needs the plan of the endpoint it comes from. Company report sections lists the keys with what your plan includes.
Choosing sections
sections |
The report holds |
|---|---|
| Left out | The main part and the default sections your plan includes |
timeline,financials,group |
The main part and those sections, in the report’s order whatever order they are given in |
Empty (sections=) |
The main part alone |
An unknown key returns 400 with the known keys. A section your plan does not include returns 403 with the plans that include it in features.
Access and limits
- The report needs the Max, Enterprise or Government plan, and its main part the plans of the company page and the credit score (Pro, Max or Enterprise).
- An enskild firma registered on its owner’s personnummer has no company report (
400): a report on it is a credit check on the person. - The report shares the limit of Risk & credit score: at most 30 requests per minute per user or API key, the two endpoints together. More get
429 Too Many Requests. - It is produced on request, usually within a second or two, and is neither stored nor an order.
Example
curl "https://lens-api.tic.io/companies/12345/company-report/pdf?sections=timeline,signals,financials,group&lang=sv" \
-H "x-api-key: YOUR_API_KEY" \
-o foretagsupplysning.pdfThe file is named after the report and the organisation number, for example TIC foretagsupplysning 556677-8899.pdf in Swedish and TIC company report 556677-8899.pdf in English. See PDF reports for the language.
Authorization
x-api-keystringheaderrequiredYour API key, sent in the x-api-key header.
Path parameters
idintegerrequiredInternal company ID
Query parameters
sectionsstringComma-separated optional sections, e.g. `timeline,signals,financials`; empty for the main part alone. Default: the default selection the plan includes.
langstringReport language, `sv` or `en`. Defaults to the caller's locale.
Responses
PDF report · application/pdf
string
Unknown section, or an enskild firma on its owner's personnummer
The plan does not include the report or a requested section
Company not found or not accessible
More than 30 requests in the last minute, together with GET /companies/{id}/risks