Journeys can pull data straight out of Kjarni so you don't have to maintain the same lists in two places. Once a synced list is set up, Journeys refreshes it once a day, automatically.

This article lists the Kjarni URLs you can use and what each one returns. If you're not sure what a synced list is or how to set one up, start with Synced lists first.

Before you start

Swap in your own company name. 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

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

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

These three need to be switched on for you by Kjarni before they'll return anything. If a list comes back empty, that's usually why.

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.

Document folders / Skjalaskúffur

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

Employees

All employees

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

Narrowing a list down

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, SysGenderTypeEnums, 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: