> ## 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.

# Payrolls

> Gets any historic known payrolls and includes a summary for each financial year

This endpoint containing the route /se/ intended for Swedish companies only. It contains monthly details
about employeer taxes for payrolls. It also delivers a yearly summary comparing details around the employeer taxes,
late reporting, tax surcharges and deviations.

## Time period

This endpoint delivers updated data each week up to 5 years of history for each company. Summary for financial reports
are calculated when the financial report has been registered.

## Requires elevated rights

To use this endpoint you need to contact [support@tic.io](mailto:support@tic.io) to be granted elevated rights. Such rights are only granted for users
that have specific needs for this information such as banks/lenders during credit check, bankruptcy trustee or system
integrators building systems tailored for similar industries.

## Refiling

The details for the payrolls will include a specific sequence number (9 digits) that is increased for each employee tax declaration submitted.
This means that there could be multiple entries with the same period but with different sequences which indicates a filing of
a change has been done. The result will include the differences between the amounts.

## Deviations

The summary will automatically compare the filed annual report for the business and identifty the payroll periods and use the
normal standard employer tax of 31.42%. Please note that this gives an estimate and personnel costs in the annual report
also contains other related personnel expenses. Deviations are in average +/- 10% but even up to +/- 30% occurs still
considered normal. Be careful to hightlight deviations around the interval of +/- 10-30%.

## Example and how to read the data

The following example shows a company having two financial years, 2022 and 2023. The first year 2022 has a deviation of 28,39%, e.g 330 775 SEK, with
one employee which could be considered normal. The following year 2023 the deviation is 89,07%, e.g 1 866 847 SEK, with 5 employees which is
considered very concerning. Also note that 9 periods has been filed with zero employee tax during 2023 which is also a very high number.

```bash json theme={null}
{
    "summary": [
        {
            "companyPayrollSummaryId": 528773,
            "periodStart": "2023-01-01T00:00:00",
            "periodEnd": "2023-12-31T00:00:00",
            "payrollPeriods": 12,
            "sumPayrollTax": 54786,
            "numberOfPeriods": 14,
            "numberOfPeriodsWithZero": 9,
            "personnelCostsInAnnualReport": 2096000,
            "calculatedPersonnelCosts": 229153,
            "deviationInCosts": 0.1093,
            "deviationInCostsChange": -0.8907,
            "deviationInAmount": -1866847.0,
            "numberOfEmployees": 5.00,
            "numberOfLateFeesForPeriod": 0,
            "taxSurchangeAmountForPeriod": 0,
            "lastUpdatedAtUtc": "2025-04-18T07:57:01"
        },
        {
            "companyPayrollSummaryId": 475181,
            "periodStart": "2022-01-01T00:00:00",
            "periodEnd": "2022-12-31T00:00:00",
            "payrollPeriods": 10,
            "sumPayrollTax": 199432,
            "numberOfPeriods": 10,
            "numberOfPeriodsWithZero": 0,
            "personnelCostsInAnnualReport": 1164936,
            "calculatedPersonnelCosts": 834161,
            "deviationInCosts": 0.7161,
            "deviationInCostsChange": -0.2839,
            "deviationInAmount": -330775.0,
            "numberOfEmployees": 1.00,
            "numberOfLateFeesForPeriod": 0,
            "taxSurchangeAmountForPeriod": 0,
            "lastUpdatedAtUtc": "2025-04-18T07:57:01"
        }
    ],
    "details": [
        {
            "companyPayrollDetailId": 18107908,
            "period": 202501,
            "amount": 0,
            "sequenceNumber": 479788872,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18107203,
            "period": 202412,
            "amount": 19637,
            "sequenceNumber": 479785950,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161986,
            "period": 202411,
            "amount": 19961,
            "sequenceNumber": 480019364,
            "changeFromSamePeriodLastSequence": 19961
        },
        {
            "companyPayrollDetailId": 16756588,
            "period": 202411,
            "amount": 0,
            "sequenceNumber": 474046356,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161987,
            "period": 202410,
            "amount": 19935,
            "sequenceNumber": 480019368,
            "changeFromSamePeriodLastSequence": 19935
        },
        {
            "companyPayrollDetailId": 16346751,
            "period": 202410,
            "amount": 0,
            "sequenceNumber": 472288276,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161994,
            "period": 202409,
            "amount": 19763,
            "sequenceNumber": 480019396,
            "changeFromSamePeriodLastSequence": 19763
        },
        {
            "companyPayrollDetailId": 15268725,
            "period": 202409,
            "amount": 0,
            "sequenceNumber": 467731326,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161985,
            "period": 202408,
            "amount": 19527,
            "sequenceNumber": 480019360,
            "changeFromSamePeriodLastSequence": 19527
        },
        {
            "companyPayrollDetailId": 15268710,
            "period": 202408,
            "amount": 0,
            "sequenceNumber": 467731262,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161989,
            "period": 202407,
            "amount": 19841,
            "sequenceNumber": 480019376,
            "changeFromSamePeriodLastSequence": 19841
        },
        {
            "companyPayrollDetailId": 14586111,
            "period": 202407,
            "amount": 0,
            "sequenceNumber": 464883592,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161984,
            "period": 202406,
            "amount": 20011,
            "sequenceNumber": 480019356,
            "changeFromSamePeriodLastSequence": 20011
        },
        {
            "companyPayrollDetailId": 14586109,
            "period": 202406,
            "amount": 0,
            "sequenceNumber": 464883584,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161995,
            "period": 202405,
            "amount": 10305,
            "sequenceNumber": 480019400,
            "changeFromSamePeriodLastSequence": 10305
        },
        {
            "companyPayrollDetailId": 13773337,
            "period": 202405,
            "amount": 0,
            "sequenceNumber": 461479748,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161996,
            "period": 202404,
            "amount": 10337,
            "sequenceNumber": 480019404,
            "changeFromSamePeriodLastSequence": 10337
        },
        {
            "companyPayrollDetailId": 13017287,
            "period": 202404,
            "amount": 0,
            "sequenceNumber": 458268608,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161992,
            "period": 202403,
            "amount": 10557,
            "sequenceNumber": 480019388,
            "changeFromSamePeriodLastSequence": 10557
        },
        {
            "companyPayrollDetailId": 13017286,
            "period": 202403,
            "amount": 0,
            "sequenceNumber": 458268604,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161997,
            "period": 202402,
            "amount": 10180,
            "sequenceNumber": 480019408,
            "changeFromSamePeriodLastSequence": 10180
        },
        {
            "companyPayrollDetailId": 13017288,
            "period": 202402,
            "amount": 0,
            "sequenceNumber": 458268612,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 18161970,
            "period": 202401,
            "amount": 10211,
            "sequenceNumber": 480019298,
            "changeFromSamePeriodLastSequence": 10211
        },
        {
            "companyPayrollDetailId": 11525412,
            "period": 202401,
            "amount": 0,
            "sequenceNumber": 451898426,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 11510687,
            "period": 202312,
            "amount": 0,
            "sequenceNumber": 451832012,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 10839526,
            "period": 202311,
            "amount": 0,
            "sequenceNumber": 448923710,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 9935592,
            "period": 202310,
            "amount": 0,
            "sequenceNumber": 445082134,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 9746596,
            "period": 202309,
            "amount": 0,
            "sequenceNumber": 444272034,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 9143111,
            "period": 202308,
            "amount": 0,
            "sequenceNumber": 441727966,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 8804812,
            "period": 202307,
            "amount": 0,
            "sequenceNumber": 440292324,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 8233512,
            "period": 202306,
            "amount": 0,
            "sequenceNumber": 437913928,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 7392492,
            "period": 202305,
            "amount": 0,
            "sequenceNumber": 434338430,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 7284634,
            "period": 202304,
            "amount": 0,
            "sequenceNumber": 433874650,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 6878989,
            "period": 202303,
            "amount": 21404,
            "sequenceNumber": 432142666,
            "changeFromSamePeriodLastSequence": 2552
        },
        {
            "companyPayrollDetailId": 6405871,
            "period": 202303,
            "amount": 18852,
            "sequenceNumber": 430126298,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 6334129,
            "period": 202302,
            "amount": 11978,
            "sequenceNumber": 429797046,
            "changeFromSamePeriodLastSequence": -9426
        },
        {
            "companyPayrollDetailId": 5896383,
            "period": 202302,
            "amount": 21404,
            "sequenceNumber": 427950420,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 5378647,
            "period": 202301,
            "amount": 21404,
            "sequenceNumber": 425728230,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 4867707,
            "period": 202212,
            "amount": 21404,
            "sequenceNumber": 423536396,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 4356411,
            "period": 202211,
            "amount": 21404,
            "sequenceNumber": 421345580,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 3860894,
            "period": 202210,
            "amount": 21404,
            "sequenceNumber": 419231924,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 3384860,
            "period": 202209,
            "amount": 21404,
            "sequenceNumber": 417215584,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 2894349,
            "period": 202208,
            "amount": 21404,
            "sequenceNumber": 415142778,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 2331793,
            "period": 202207,
            "amount": 21404,
            "sequenceNumber": 412791498,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 1934797,
            "period": 202206,
            "amount": 17752,
            "sequenceNumber": 411137550,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 1432737,
            "period": 202205,
            "amount": 17752,
            "sequenceNumber": 408999166,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 960012,
            "period": 202204,
            "amount": 17752,
            "sequenceNumber": 406970412,
            "changeFromSamePeriodLastSequence": null
        },
        {
            "companyPayrollDetailId": 441497,
            "period": 202203,
            "amount": 17752,
            "sequenceNumber": 404752120,
            "changeFromSamePeriodLastSequence": null
        }
    ]
}
```


## OpenAPI

````yaml get /datasets/companies/{companyId}/se/payroll
openapi: 3.0.4
info:
  title: TIC API
  description: ''
  version: v1
servers:
  - url: https://api.tic.io/
security:
  - ApiKey: []
tags:
  - name: BolagsverketStatistics
  - name: Companies
  - name: Companies_SE_
  - name: DocumentDelivery
  - name: EuropeanCommission
  - name: FinancialDocuments
  - name: Finansinspektionen
  - name: Free
  - name: ICA
  - name: ICAStatistics
  - name: Lists
  - name: Media
  - name: Persons
  - name: Persons_SE_
  - name: Properties_SE_
  - name: PTSPortings
  - name: Reseller
  - name: SearchBankruptciesReports
  - name: SearchCompanies
  - name: SearchCompaniesReports
  - name: SearchCompanyWorkplaces
  - name: SearchPerson
  - name: SearchProperties_SE_
  - name: SearchVehicles
  - name: TeamDocumentOrders
  - name: Teams
  - name: User
  - name: Vehicles_SE_
  - name: WatchLists
paths:
  /datasets/companies/{companyId}/se/payroll:
    get:
      tags:
        - Companies_SE_
      summary: Payrolls
      description: >-
        Gets any historic known payrolls and includes a summary for each
        financial year
      operationId: CompanyPayrolls
      parameters:
        - name: companyId
          in: path
          description: The company id
          required: true
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_CompanyPayroll_Dto
components:
  schemas:
    Ormeo_WebAPI_Models_Datasets_Company_CompanyPayroll_Dto:
      type: object
      properties:
        summary:
          type: array
          items:
            $ref: >-
              #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_CompanyPayrollSummary_Dto
          nullable: true
        details:
          type: array
          items:
            $ref: >-
              #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_CompanyPayrollDetail_Dto
          nullable: true
      additionalProperties: false
    Ormeo_WebAPI_Models_Datasets_Company_CompanyPayrollSummary_Dto:
      type: object
      properties:
        companyPayrollSummaryId:
          type: integer
          format: int32
        periodStart:
          type: string
          format: date-time
          nullable: true
        periodEnd:
          type: string
          format: date-time
          nullable: true
        payrollPeriods:
          type: integer
          format: int32
          nullable: true
        sumPayrollTax:
          type: integer
          format: int64
          nullable: true
        numberOfPeriods:
          type: integer
          format: int32
          nullable: true
        numberOfPeriodsWithZero:
          type: integer
          format: int32
          nullable: true
        personnelCostsInAnnualReport:
          type: integer
          format: int64
          nullable: true
        calculatedPersonnelCosts:
          type: integer
          format: int64
          nullable: true
        deviationInCosts:
          type: number
          format: double
          nullable: true
        deviationInCostsChange:
          type: number
          format: double
          nullable: true
          readOnly: true
        deviationInAmount:
          type: number
          format: double
          nullable: true
          readOnly: true
        numberOfEmployees:
          type: number
          format: double
          nullable: true
        numberOfLateFeesForPeriod:
          type: integer
          format: int32
          nullable: true
        taxSurchangeAmountForPeriod:
          type: integer
          format: int32
          nullable: true
        lastUpdatedAtUtc:
          type: string
          format: date-time
          nullable: true
      additionalProperties: false
    Ormeo_WebAPI_Models_Datasets_Company_CompanyPayrollDetail_Dto:
      type: object
      properties:
        companyPayrollDetailId:
          type: integer
          format: int32
        period:
          type: integer
          format: int32
        amount:
          type: integer
          format: int32
          nullable: true
        sequenceNumber:
          type: integer
          format: int32
          nullable: true
        changeFromSamePeriodLastSequence:
          type: integer
          format: int32
          nullable: true
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: apiKey
      name: x-api-key
      in: header

````