This article lists the Kjarni URLs you can use when creating synced lists.

If you're not sure what a synced list is or how to set one up, please read our article about Synced lists first.

Before you start

Every URL below starts with https://COMPANY-api.starfsmenn.is/. Replace COMPANY with your own company's name as it appears in your Kjarni web address.

For example, if you log into Kjarni at acme.starfsmenn.is, your URL becomes https://acme-api.starfsmenn.is/...

🏢 Organisation structure

Companies (Fyrirtæki)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/OrgCompanies

Returns the companies in your Kjarni setup.

Divisions (Skipulagseining eða svið)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/OrgCompanyUnits?&%24filter=Disabled%20eq%20false%20and%20IsDivision%20eq%20true

Returns top-level units only.

Departments (Skipulagseining eða deild)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/OrgCompanyUnits?&%24filter=Disabled%20eq%20false%20and%20IsDivision%20eq%20false

Returns units that sit below division level.

Job titles (Starfsheiti)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/OrgCompanyUnitPositions?&%24filter=Disabled%20eq%20false

Only returns active job titles and positions.

Job classifications (Starfsflokkun)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/OrgJobs

Cost centers (Kostnaðarlykill)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/OrgCompanyCostCenters

Employment types (Tegund ráðningar)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/HrEmployeeGroupEnums

Reasons for leaving (Ástæður starfsloka)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/HrEmployeeStatusReasons

📝 Pay, pensions and unions

General pension funds (Lífeyrissjóðir, almennir)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/PayPensions?&%24filter=PayPensionType%20eq%20'General'

Private pension funds (Lífeyrissjóðir, séreign)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/PayPensions?&%24filter=PayPensionType%20eq%20'Private'

Unions, general (Stéttarfélög, almenn)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/PayUnions?&%24filter=IsNotUnion%20eq%20false

Unions, other (Stéttarfélög, annað)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/PayUnions?&%24filter=IsNotUnion%20eq%20true

Entries recorded alongside unions that aren't actually unions.

Holiday handling rules (Meðhöndlun orlofs)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/PayHolidayRuleTypeEnums

👤 Personal details

Useful when you're asking a new hire to fill in their own information.

Postal codes (Póstnúmer)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/SysPostalCodes

Nationalities (Þjóðerni)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/SysCountries

Gender (Kyn)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/SysGenderTypeEnums

Next of kin relationship types (Tengsl aðstandanda)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/RelativeAssociationEnums

Bank branches (Bankaútibú)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/SysBankBranches

📚 Education

Kjarni needs to grant access to these three for your company before they'll work.

Schools (Námsstofnanir)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/HrSchools

Degrees (Gráður)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/HrDegrees

Branches of study (Námsleiðir)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/HrBranchOfStudies

📄 Documents

Document owner (Eigandi skjals)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/FileRepositoryEntityOwnerTypes

Whether a document belongs to the employee record or the payroll record. This needs to be specified when uploading a file to a folder in Kjarni.

Document folders (Skjalaskúffur)

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/FileRepositoryObjectDocumentTypes

👥 Employees

All employees

https://COMPANY-api.starfsmenn.is/api/HrData/Employees

Applying filters

Some of the URLs above have a filter on the end, after the ?. You don't need to touch these, but if you want to build your own filters, here's how they work.

Web addresses can't contain spaces or certain symbols, so they get written as codes: %20 means a space and %24 means $. So this:

?&%24filter=Disabled%20eq%20false%20and%20IsDivision%20eq%20true

is really saying:

$filter=Disabled eq false and IsDivision eq true

In other words: only give me entries that aren't disabled, and that are divisions.

Kjarni's API follows a standard called OData. odata.org's tutorial covers the full set of filters and sorting options. It's written for developers, but the examples are readable.

Can't find what you need?

Kjarni has one URL that lists everything available in your setup:

https://COMPANY-api.starfsmenn.is/kjarni/api/v2/

The simplest way to see it is to set it up as a synced list of its own. It returns the names of every entity Kjarni exposes: SysBankBranches, PayUnions, and so on.

Once you've spotted an entity that looks promising, add it to the end of the base URL and set that up as a synced list to see what comes back. For example: