Join us at Fortnox App Market today!

Employees

List all employees

URL

https://api.fortnox.se/3/employees

Method

GET

Description

Retrieve employment information for all employees.

Filters

active

inactive

Response

{
  "MetaInformation": {
    "@TotalResources": 2,
    "@TotalPages": 1,
    "@CurrentPage": 1
  },
  "Employees": [
    {
      "@url": "https://api.fortnox.se/3/employees/2",
      "EmployeeId": "2",
      "PersonalIdentityNumber": "",
      "FirstName": "Arthur",
      "LastName": "Doglas",
      "FullName": "Arthur Doglas",
      "Address1": "",
      "Address2": "Klarälvsvägen 98",
      "PostCode": "44135",
      "City": "ALINGSÅS",
      "Country": "Sweden",
      "Phone1": "0322-36802",
      "Phone2": "",
      "Email": "",
      "EmploymentDate": "2003-01-05",
      "EmploymentForm": "TV",
      "SalaryForm": "MAN",
      "JobTitle": "Marknadschef",
      "PersonelType": "TJM",
      "ScheduleId": "HEL",
      "ForaType": "-",
      "MonthlySalary": "45000",
      "HourlyPay": null,
      "TaxAllowance": "HUV",
      "TaxTable": "33",
      "TaxColumn": 1,
      "AutoNonRecurringTax": "true",
      "NonRecurringTax": "30",
      "Inactive": false,
      "ClearingNo": "",
      "BankAccountNo": "",
      "AverageWeeklyHours": "",
      "AverageHourlyWage": "",
      "EmployedTo": null
    },
    {
      "@url": "https://api.fortnox.se/3/employees/3",
      "EmployeeId": "3",
      "PersonalIdentityNumber": "",
      "FirstName": "Birgitta",
      "LastName": "Berg",
      "FullName": "Birgitta Berg",
      "Address1": "",
      "Address2": "Garverigatan 2",
      "PostCode": "447 34",
      "City": "VÅRGÅRDA",
      "Country": "",
      "Phone1": "0322-25833",
      "Phone2": "",
      "Email": "",
      "EmploymentDate": "2000-03-05",
      "EmploymentForm": "TV",
      "SalaryForm": "MAN",
      "JobTitle": "Ekonomichef",
      "PersonelType": "ARB",
      "ScheduleId": "HEL",
      "ForaType": "-",
      "MonthlySalary": "40000",
      "HourlyPay": null,
      "TaxAllowance": "EXT",
      "TaxTable": null,
      "TaxColumn": null,
      "AutoNonRecurringTax": "true",
      "NonRecurringTax": null,
      "Inactive": true,
      "ClearingNo": "",
      "BankAccountNo": "",
      "AverageWeeklyHours": "",
      "AverageHourlyWage": "",
      "EmployedTo": null
    }
  ]
}
<?xml version="1.0" encoding="UTF-8"?>
<Employees TotalResources="2" TotalPages="1" CurrentPage="1">
    <EmployeeSubset url="https://api-fn3-sl.utv.fortnox.local/3/employees/2">
        <EmployeeId>2</EmployeeId>
        <PersonalIdentityNumber/>
        <FirstName>Arthur</FirstName>
        <LastName>Doglas</LastName>
        <FullName>Arthur Doglas</FullName>
        <Address1/>
        <Address2>Klarälvsvägen 98</Address2>
        <PostCode>44135</PostCode>
        <City>ALINGSÅS</City>
        <Country>Sweden</Country>
        <Phone1>0322-36802</Phone1>
        <Phone2/>
        <Email/>
        <EmploymentDate>2003-01-05</EmploymentDate>
        <EmploymentForm>TV</EmploymentForm>
        <SalaryForm>MAN</SalaryForm>
        <JobTitle>Marknadschef</JobTitle>
        <PersonelType>TJM</PersonelType>
        <ScheduleId>HEL</ScheduleId>
        <ForaType>-</ForaType>
        <MonthlySalary>45000</MonthlySalary>
        <HourlyPay/>
        <TaxAllowance>HUV</TaxAllowance>
        <TaxTable>33</TaxTable>
        <TaxColumn>1</TaxColumn>
        <AutoNonRecurringTax>true</AutoNonRecurringTax>
        <NonRecurringTax>30</NonRecurringTax>
        <Inactive>false</Inactive>
        <ClearingNo/>
        <BankAccountNo/>
        <AverageWeeklyHours/>
        <AverageHourlyWage/>
        <EmployedTo>null</EmployedTo>
    </EmployeeSubset>
    <EmployeeSubset url="https://api-fn3-sl.utv.fortnox.local/3/employees/3">
        <EmployeeId>3</EmployeeId>
        <PersonalIdentityNumber/>
        <FirstName>Birgitta</FirstName>
        <LastName>Berg</LastName>
        <FullName>Birgitta Berg</FullName>
        <Address1/>
        <Address2>Garverigatan 2</Address2>
        <PostCode>447 34</PostCode>
        <City>VÅRGÅRDA</City>
        <Country/>
        <Phone1>0322-25833</Phone1>
        <Phone2/>
        <Email/>
        <EmploymentDate>2000-03-05</EmploymentDate>
        <EmploymentForm>TV</EmploymentForm>
        <SalaryForm>MAN</SalaryForm>
        <JobTitle>Ekonomichef</JobTitle>
        <PersonelType>ARB</PersonelType>
        <ScheduleId>HEL</ScheduleId>
        <ForaType>-</ForaType>
        <MonthlySalary>40000</MonthlySalary>
        <HourlyPay/>
        <TaxAllowance>EXT</TaxAllowance>
        <TaxTable/>
        <TaxColumn/>
        <AutoNonRecurringTax>true</AutoNonRecurringTax>
        <NonRecurringTax/>
        <Inactive>true</Inactive>
        <ClearingNo/>
        <BankAccountNo/>
        <AverageWeeklyHours/>
        <AverageHourlyWage/>
        <EmployedTo>null</EmployedTo>
    </EmployeeSubset>
</Employees>

Retrieve an employee

URL

https://api.fortnox.se/3/employees/{EmployeeId}

Method

GET

Description

Retrieves employment information for specified employee.

Response

{
  "Employee": {
    "EmployeeId": "2",
    "PersonalIdentityNumber": "",
    "FirstName": "Arthur",
    "LastName": "Doglas",
    "FullName": "Arthur Doglas",
    "Address1": "",
    "Address2": "Klarälvsvägen 98",
    "PostCode": "44135",
    "City": "ALINGSÅS",
    "Country": "Sweden",
    "Phone1": "0322-36802",
    "Phone2": "",
    "Email": "",
    "EmploymentDate": "2003-01-05",
    "EmploymentForm": "TV",
    "SalaryForm": "MAN",
    "JobTitle": "Marknadschef",
    "PersonelType": "TJM",
    "ScheduleId": "HEL",
    "ForaType": "-",
    "MonthlySalary": "45000",
    "HourlyPay": null,
    "TaxAllowance": "HUV",
    "TaxTable": "33",
    "TaxColumn": 1,
    "AutoNonRecurringTax": "true",
    "NonRecurringTax": "30",
    "Inactive": false,
    "ClearingNo": "",
    "BankAccountNo": "",
    "AverageWeeklyHours": "",
    "AverageHourlyWage": "",
    "EmployedTo": null
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>3</EmployeeId>
    <PersonalIdentityNumber/>
    <FirstName>Birgitta</FirstName>
    <LastName>Berg</LastName>
    <FullName>Birgitta Berg</FullName>
    <Address1/>
    <Address2>Garverigatan 2</Address2>
    <PostCode>447 34</PostCode>
    <City>VÅRGÅRDA</City>
    <Country/>
    <Phone1>0322-25833</Phone1>
    <Phone2/>
    <Email/>
    <EmploymentDate>2000-03-05</EmploymentDate>
    <EmploymentForm>TV</EmploymentForm>
    <SalaryForm>MAN</SalaryForm>
    <JobTitle>Ekonomichef</JobTitle>
    <PersonelType>ARB</PersonelType>
    <ScheduleId>HEL</ScheduleId>
    <ForaType>-</ForaType>
    <MonthlySalary>40000</MonthlySalary>
    <HourlyPay/>
    <TaxAllowance>EXT</TaxAllowance>
    <TaxTable/>
    <TaxColumn/>
    <AutoNonRecurringTax>true</AutoNonRecurringTax>
    <NonRecurringTax/>
    <Inactive>true</Inactive>
    <ClearingNo/>
    <BankAccountNo/>
    <AverageWeeklyHours/>
    <AverageHourlyWage/>
    <EmployedTo/>
</Employee>

Create an employee

URL

https://api.fortnox.se/3/employees

Method

POST

Description

Creates a new employee.

Request

{
  "Employee": {
    "EmployeeId": "9978",
    "PersonalIdentityNumber": "19730222-9989",
    "FirstName": "Karin",
    "LastName": "Brovall",
    "FullName": "Karin Brovall",
    "Address1": "",
    "Address2": "Båtsmansvägen 7",
    "PostCode": "441 50",
    "City": "ALINGSÅS",
    "Country": "",
    "Phone1": "0322-36844",
    "Phone2": "",
    "Email": "",
    "EmploymentDate": "1997-10-01",
    "EmploymentForm": "TV",
    "SalaryForm": "TIM",
    "JobTitle": "Försäljning",
    "PersonelType": "ARB",
    "ScheduleId": "HEL",
    "ForaType": "-",
    "MonthlySalary": 0,
    "HourlyPay": 125,
    "TaxAllowance": "TMP",
    "TaxTable": 34,
    "TaxColumn": 1,
    "AutoNonRecurringTax": "true",
    "NonRecurringTax": 30,
    "Inactive": false,
    "ClearingNo": "",
    "BankAccountNo": "",
    "AverageWeeklyHours": "",
    "AverageHourlyWage": "",
    "EmployedTo": null
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>9978</EmployeeId>
    <PersonalIdentityNumber>19730222-9989</PersonalIdentityNumber>
    <FirstName>Karin</FirstName>
    <LastName>Brovall</LastName>
    <FullName>Karin Brovall</FullName>
    <Address1/>
    <Address2>Båtsmansvägen 7</Address2>
    <PostCode>441 50</PostCode>
    <City>ALINGSÅS</City>
    <Country/>
    <Phone1>0322-36844</Phone1>
    <Phone2/>
    <Email/>
    <EmploymentDate>1997-10-01</EmploymentDate>
    <EmploymentForm>TV</EmploymentForm>
    <SalaryForm>TIM</SalaryForm>
    <JobTitle>Försäljning</JobTitle>
    <PersonelType>ARB</PersonelType>
    <ScheduleId>HEL</ScheduleId>
    <ForaType>-</ForaType>
    <MonthlySalary>0</MonthlySalary>
    <HourlyPay>125</HourlyPay>
    <TaxAllowance>TMP</TaxAllowance>
    <TaxTable>34</TaxTable>
    <TaxColumn>1</TaxColumn>
    <AutoNonRecurringTax>true</AutoNonRecurringTax>
    <NonRecurringTax>30</NonRecurringTax>
    <Inactive>false</Inactive>
    <ClearingNo/>
    <BankAccountNo/>
    <AverageWeeklyHours/>
    <AverageHourlyWage/>
</Employee>

Response

{
  "Employee": {
    "EmployeeId": "9978",
    "PersonalIdentityNumber": "19730222-9989",
    "FirstName": "Karin",
    "LastName": "Brovall",
    "FullName": "Karin Brovall",
    "Address1": "",
    "Address2": "Båtsmansvägen 7",
    "PostCode": "441 50",
    "City": "ALINGSÅS",
    "Country": "",
    "Phone1": "0322-36844",
    "Phone2": "",
    "Email": "",
    "EmploymentDate": "1997-10-01",
    "EmploymentForm": "TV",
    "SalaryForm": "TIM",
    "JobTitle": "Försäljning",
    "PersonelType": "ARB",
    "ScheduleId": "HEL",
    "ForaType": "-",
    "MonthlySalary": 0,
    "HourlyPay": 125,
    "TaxAllowance": "TMP",
    "TaxTable": 34,
    "TaxColumn": 1,
    "AutoNonRecurringTax": "true",
    "NonRecurringTax": 30,
    "Inactive": false,
    "ClearingNo": "",
    "BankAccountNo": "",
    "AverageWeeklyHours": "",
    "AverageHourlyWage": "",
    "EmployedTo": null
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>9978</EmployeeId>
    <PersonalIdentityNumber>19730222-9989</PersonalIdentityNumber>
    <FirstName>Karin</FirstName>
    <LastName>Brovall</LastName>
    <FullName>Karin Brovall</FullName>
    <Address1/>
    <Address2>Båtsmansvägen 7</Address2>
    <PostCode>441 50</PostCode>
    <City>ALINGSÅS</City>
    <Country/>
    <Phone1>0322-36844</Phone1>
    <Phone2/>
    <Email/>
    <EmploymentDate>1997-10-01</EmploymentDate>
    <EmploymentForm>TV</EmploymentForm>
    <SalaryForm>TIM</SalaryForm>
    <JobTitle>Försäljning</JobTitle>
    <PersonelType>ARB</PersonelType>
    <ScheduleId>HEL</ScheduleId>
    <ForaType>-</ForaType>
    <MonthlySalary>0</MonthlySalary>
    <HourlyPay>125</HourlyPay>
    <TaxAllowance>TMP</TaxAllowance>
    <TaxTable>34</TaxTable>
    <TaxColumn>1</TaxColumn>
    <AutoNonRecurringTax>true</AutoNonRecurringTax>
    <NonRecurringTax>30</NonRecurringTax>
    <Inactive>false</Inactive>
    <ClearingNo/>
    <BankAccountNo/>
    <AverageWeeklyHours/>
    <AverageHourlyWage/>
    <EmployedTo/>
</Employee>

Update an employee

URL

https://api.fortnox.se/3/employees/{EmployeeId}

Method

PUT

Description

Updates employment information.

Request

{
  "Employee": {
    "EmployeeId": "9978",
    "HourlyPay": 500
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>9978</EmployeeId>
    <HourlyPay>500</HourlyPay>
</Employee>

Response

{
  "Employee": {
    "EmployeeId": "9978",
    "PersonalIdentityNumber": "19730222-9989",
    "FirstName": "Karin",
    "LastName": "Brovall",
    "FullName": "Karin Brovall",
    "Address1": "",
    "Address2": "Båtsmansvägen 7",
    "PostCode": "441 50",
    "City": "ALINGSÅS",
    "Country": "",
    "Phone1": "0322-36844",
    "Phone2": "",
    "Email": "",
    "EmploymentDate": "1997-10-01",
    "EmploymentForm": "TV",
    "SalaryForm": "TIM",
    "JobTitle": "Försäljning",
    "PersonelType": "ARB",
    "ScheduleId": "HEL",
    "ForaType": "-",
    "MonthlySalary": "0",
    "HourlyPay": "500",
    "TaxAllowance": "TMP",
    "TaxTable": "34",
    "TaxColumn": 1,
    "AutoNonRecurringTax": "true",
    "NonRecurringTax": "30",
    "Inactive": false,
    "ClearingNo": "",
    "BankAccountNo": "",
    "AverageWeeklyHours": "",
    "AverageHourlyWage": "",
    "EmployedTo": null
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>9978</EmployeeId>
    <PersonalIdentityNumber>19730222-9989</PersonalIdentityNumber>
    <FirstName>Karin</FirstName>
    <LastName>Brovall</LastName>
    <FullName>Karin Brovall</FullName>
    <Address1/>
    <Address2>Båtsmansvägen 7</Address2>
    <PostCode>441 50</PostCode>
    <City>ALINGSÅS</City>
    <Country/>
    <Phone1>0322-36844</Phone1>
    <Phone2/>
    <Email/>
    <EmploymentDate>1997-10-01</EmploymentDate>
    <EmploymentForm>TV</EmploymentForm>
    <SalaryForm>TIM</SalaryForm>
    <JobTitle>Försäljning</JobTitle>
    <PersonelType>ARB</PersonelType>
    <ScheduleId>HEL</ScheduleId>
    <ForaType>-</ForaType>
    <MonthlySalary>0</MonthlySalary>
    <HourlyPay>500</HourlyPay>
    <TaxAllowance>TMP</TaxAllowance>
    <TaxTable>34</TaxTable>
    <TaxColumn>1</TaxColumn>
    <AutoNonRecurringTax>true</AutoNonRecurringTax>
    <NonRecurringTax>30</NonRecurringTax>
    <Inactive>false</Inactive>
    <ClearingNo/>
    <BankAccountNo/>
    <AverageWeeklyHours/>
    <AverageHourlyWage/>
    <EmployedTo/>
</Employee>

Properties

Field Type Access Description
EmployeeId  String (15) RW Unique employee-id. Can never be changed once an employee has been created
PersonalIdentityNumber String RW Personal identity number
FirstName String RW First name
LastName String RW Last name
FullName String R Full name
Address1 String RW Address
Address2 String RW Address
PostCode String RW Post code
City String RW City
Country String RW Country
Phone1 String RW Phone number
Phone2 String RW Phone number 2
Email String RW Email address
EmploymentDate Date RW Startdate of employment
EmploymentForm String (3) RW Type of employment. Validates against allowed values specified below.
SalaryForm String (3) RW Type of salary form. Validates against allowed values specified below.
JobTitle String RW Job title
PersonelType String (3) RW Personel type. Validates against allowed values specified below.
Inactive Boolean RW True if employee is inactive
ScheduleId String (10) RW Schedule ID for scheduletimes
ForaType String (3) RW Assigned fora type. Validates against allowed values specified below.
MonthlySalary Float RW Monthly salary
HourlyPay Float RW Hourly pay
TaxAllowance String RW Tax allowance. Validates against allowed values specified below.
TaxTable Float RW Tax table
TaxColumn Integer RW Tax column
AutoNonRecurringTax Boolean RW Auto non recurring tax
NonRecurringTax Float RW Non-recurring tax %
ClearingNo String RW Clearing number
BankAccountNo String RW Bankaccount number
AverageWeeklyHours Float RW Average weekly hours
AverageHourlyWage Float RW Average hourly wage
EmployedTo Date RW Enddate of employment

Allowed values

EmploymentForm

Value Description
TV Post with conditional tenure
PRO Probationary appointment
TID Temporary employment
VIK Cover staff
PRJ Project employment
PRA Work experience
FER Holiday work
SES Seasonal employment
NEJ Not employed

SalaryForm

Value Description
MAN Monthly salary
TIM Hourly pay

PersonelType

Value Description
TJM Salaried employee
ARB Worker

ForaType

Value Description
Not signed
A Worker
A11
Worker, Staffing companies
A12
Worker, The construction agreement
A13
Worker, Dalsland’s canal
A14 Worker, Retail
A15
Worker, The construction machinery agreement
A16
Worker, The glazier agreement
A17
Worker, Göta canal company AB
A18
Worker, The stock agreement
A19
Worker, The stock och e-commerce agreement
A20
Worker, Warehouse staff at ice cream companies, branches and depot warehouses as well as direct sellers
A21
Worker, The alarm and security technology agreement
A22
Worker, The machine operator agreement
A23
Worker, The sheet metal and ventilation agreement
A24
Worker, The private theater agreement (employee agreement) (\\)
A25
Worker, The cleaning agreement
A26
Worker, Technical installation HVAC, Sanitation, and Refrigerator
A27
Worker, Restaurant and café employees
A28
Worker, Archipelago traffic ASL
A29
Worker, Securities
A3
Workers, Painters
A3
Workers, Painters
A30
Worker, The road and track agreement
A41
Worker, TRIA School & Care
A42
Worker, STANLEY Security
A51
Worker, Technology Agreement IF Metall
A52
Worker, TEKO Agreement
A53
Worker, Food Production Agreement
A54
Worker, Tobacco Industry
A55
Worker, Company Agreement for V&S Vin & Sprit AB
A56
Worker, Coffee Roasters and Spice Factories
A57
Worker, Construction Materials Industry
A58
Worker, Bottle Glass Industry
A59
Worker, Motor Industry Agreement
A60
Worker, Industry Agreement
A61
Worker, Leather & Sporting Goods
A62
Worker, Chemical Factories
A63
Worker, Glass Industry
A64
Worker, Common Metals
A65
Worker, Explosive Materials Industry
A66
Worker, Allochemical Industry
A67
Worker, Recycling Company
A68
Worker, Laundy Industry
A69
Worker, Quarrying Industry
A70
Worker, Oil Refineries
A71
Worker, Sugar Industry (Nordic Sugar AB)
A72
Worker, IMG Agreement
A73
Worker, Sawmill Agreement
A74
Worker, Forestry Agreement
A75
Worker, Scaling of timber
A76
Worker, Upholstery Industry
A77
Worker, Wood Industry
A78
Worker, The infomedia Agreement
A79
Worker, The packaging agreement
A80
Worker, Ahlsell GeliaSv. FoderTeknosan
A81
Worker, Handels- & Metallavtalet
A82
Worker, Studsviksavtalet
A83
Worker, Flight technician with type certificate (employee agreement)
A84
Worker, Massa- och pappersindustrin
A85
Worker, Steel and metal industry blue agreement
A86
Worker, The newspaper agreement
A91
Worker, Electrician – Installation plant contract
A91
Worker, Electrician – Installation plant contract
A92
Worker, Electrician – Power plant contract
A92
Worker, Electrician – Power plant contract
A93
Worker, Electrician – Elektroskandia contract
A93
Worker, Electrician – Elektroskandia contract
T
Salaried employee
T6
Salaried employee, Employed CEO

TaxAllowance

Value Description
HUV Main employer
EXT Extra income or short-time work
TMP Short-time work less than one week
STU Student without tax deduction
EJ Not tax allowance
??? Unknown tax circumstances