> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tic.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Compare key figures with the industry

> Compares the company's annual-report key figures, fiscal year by fiscal year, with Statistics Sweden's industry quartiles (branschnyckeltal) for the same industry, size class and year.

<Badge color="yellow" size="sm">Enterprise+ tier</Badge>

Compares the company's key figures with its industry (Statistics Sweden's industry key figures, *branschnyckeltal*), fiscal year by fiscal year. For each year and key figure you get the company's value, the industry's lower quartile, median and upper quartile, and where the company falls among them.

`years` sets how many fiscal years are returned, newest first (1-10, default 5). With an API key, names (`name`, `group.sniName`) are in Swedish.

## Key figures

The company's figures are calculated from its annual report with Statistics Sweden's definitions and closing balances, so they are comparable with the industry's quartiles. They can differ from the key figures in the [annual report financials](/api-lens/companies/get-full-annual-report-financials), which follow other definitions.

| `keyFigure` | `unit` | Calculated as |
| - | - | - |
| `EquityRatio` | `percent` | Adjusted equity / total assets |
| `ReturnOnEquity` | `percent` | Net result / adjusted equity |
| `ReturnOnAssets` | `percent` | (Operating result + financial income) / total assets |
| `OperatingMargin` | `percent` | Operating result / net sales |
| `NetMargin` | `percent` | Net result / net sales |
| `QuickRatio` | `percent` | (Current assets - inventories) / current liabilities |
| `DebtEquityRatio` | `times` | (Provisions + long-term and current liabilities + deferred tax on untaxed reserves) / adjusted equity |
| `NetSalesPerEmployee` | `thousandSek` | Net sales / number of employees |

* Adjusted equity is equity plus untaxed reserves after corporate tax. Net result is the result after financial items, after corporate tax.
* `value` is null when the annual report lacks an item or a denominator is zero or negative.
* `higherIsBetter` is false only for `DebtEquityRatio`, where a lower value is stronger.

## Position and group

* `position` is `BelowLowerQuartile`, `LowerQuartileToMedian`, `MedianToUpperQuartile` or `AboveUpperQuartile`. It is null when the company has no value or the industry has no figure.
* `group` (per key figure) describes the companies compared with:
  * the SNI version and code;
  * the size class by employees (`minEmployees` and `maxEmployees`; both null means all sizes, and `maxEmployees` null means at least `minEmployees`);
  * the year and the number of companies.
* The code is the company's main industry code when the fiscal year ended. A figure the industry key figures do not have for the 5-digit code is compared with its 4, 3 or 2-digit group, so `sniDigits` can differ between key figures. The size class is the narrowest one holding the year's `employees`, otherwise all sizes.

## Years

* A fiscal year is compared with the industry figures for the calendar year it ended in (`scbYear`).
* A fiscal year newer than the latest published year (`latestScbYear`) is compared with that latest year, and `scbYearIsFiscalYear` is false.
* The industry figures describe companies with net sales. A year without net sales has `comparable` false: its figures are returned, without positions.
* `covered` is false, with `notCoveredReason`, for legal forms without industry key figures, such as sole traders and partnerships.


## OpenAPI

````yaml get /companies/{id}/industry-comparison
openapi: 3.1.1
info:
  title: TIC Lens API
  description: "The TIC Lens API provides programmatic access to company, person, property, vehicle, and order data.\r\n\r\n## Authentication\r\n\r\nAll requests require an API key passed via the `x-api-key` header:\r\n\r\n```bash\r\ncurl -H \"x-api-key: YOUR_API_KEY\" https://lens-api.tic.io/companies/123\r\n```\r\n\r\nAPI keys are managed through the TIC Lens web application under **Settings → API Keys**.\r\n\r\n## Base URL\r\n\r\n| Environment | URL |\r\n|-------------|-----|\r\n| Production  | `https://lens-api.tic.io` |\r\n\r\n## Feature Access\r\n\r\nEndpoints are gated by your subscription plan. If your plan does not include a feature, the endpoint will return `403 Forbidden`.\r\n\r\n## Rate Limits\r\n\r\nRate limits are applied per API key. If you exceed the limit, requests will return `429 Too Many Requests`.\r\n\r\n## Response Format\r\n\r\nAll responses are JSON. Null values are omitted from responses.\r\n"
  version: v1
servers:
  - url: https://lens-api.tic.io
security:
  - ApiKey: []
tags:
  - name: Addresses
  - name: Bolagsverket
  - name: Brf
  - name: Companies
  - name: CompanyReports
  - name: Documents
  - name: FlightImages
  - name: Free
  - name: Orders
  - name: OrdersExports
  - name: PaymentControl
  - name: PaymentControlImport
  - name: Persons
  - name: Properties
  - name: PublicSearch
  - name: Screening
  - name: SearchAutocomplete
  - name: Sentinel
  - name: ServingPermits
  - name: Team
  - name: Teams
  - name: Vehicles
  - name: WatchList
paths:
  /companies/{id}/industry-comparison:
    get:
      tags:
        - Companies
      summary: Compare key figures with the industry
      description: >-
        Compares the company's annual-report key figures, fiscal year by fiscal
        year, with Statistics Sweden's industry quartiles (branschnyckeltal) for
        the same industry, size class and year.
      operationId: GetCompanyIndustryComparison
      parameters:
        - name: id
          in: path
          description: Internal company ID
          required: true
          schema:
            type: integer
            format: int32
        - name: years
          in: query
          description: Number of fiscal years, newest first (1-10, default 5)
          schema:
            type: integer
            format: int32
            default: 5
      responses:
        '200':
          description: Key figures and industry quartiles per fiscal year
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Ormeo_Library_Dtos_CompanyIndustryComparison_Dto
        '404':
          description: Company not found or not accessible
components:
  schemas:
    Ormeo_Library_Dtos_CompanyIndustryComparison_Dto:
      type: object
      properties:
        covered:
          type: boolean
        notCoveredReason:
          type:
            - 'null'
            - string
        latestScbYear:
          type:
            - 'null'
            - integer
          format: int32
        years:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_CompanyIndustryComparisonYear_Dto
      additionalProperties: false
    Ormeo_Library_Dtos_CompanyIndustryComparisonYear_Dto:
      type: object
      properties:
        period:
          type: integer
          format: int32
        periodStart:
          type:
            - 'null'
            - string
          format: date-time
        periodEnd:
          type:
            - 'null'
            - string
          format: date-time
        employees:
          type:
            - 'null'
            - integer
          format: int32
        scbYear:
          type:
            - 'null'
            - integer
          format: int32
        scbYearIsFiscalYear:
          type: boolean
        comparable:
          type: boolean
        figures:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_CompanyIndustryComparisonFigure_Dto
      additionalProperties: false
    Ormeo_Library_Dtos_CompanyIndustryComparisonFigure_Dto:
      type: object
      properties:
        keyFigure:
          type:
            - 'null'
            - string
        name:
          type:
            - 'null'
            - string
        unit:
          type:
            - 'null'
            - string
        higherIsBetter:
          type: boolean
        value:
          type:
            - 'null'
            - number
          format: double
        lowerQuartile:
          type:
            - 'null'
            - number
          format: double
        median:
          type:
            - 'null'
            - number
          format: double
        upperQuartile:
          type:
            - 'null'
            - number
          format: double
        position:
          type:
            - 'null'
            - string
        group:
          $ref: >-
            #/components/schemas/Ormeo_Library_Dtos_CompanyIndustryComparisonGroup_Dto
      additionalProperties: false
    Ormeo_Library_Dtos_CompanyIndustryComparisonGroup_Dto:
      type: object
      properties:
        sniVersion:
          type:
            - 'null'
            - string
        sni:
          type:
            - 'null'
            - string
        sniName:
          type:
            - 'null'
            - string
        sniDigits:
          type: integer
          format: int32
        minEmployees:
          type:
            - 'null'
            - integer
          format: int32
        maxEmployees:
          type:
            - 'null'
            - integer
          format: int32
        year:
          type: integer
          format: int32
        companies:
          type:
            - 'null'
            - integer
          format: int32
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: apiKey
      name: x-api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.