---
title: "Bruke API for å hente ansatte fra Capitech"
url: "https://help.capitech.no/nb/article/5a4c9ffd-f472-416d-ac96-ed8650a1520a"
language: "nb"
last_updated: "2026-06-11T10:42:44.208Z"
---

# Bruke API for å hente ansatte fra Capitech

Her finner du informasjon om hvordan API kan benyttes for å hente ut ansatte fra Capitech for gjenbruk i andre systemer.

## **EmployeeAPI - getPersonalInformation**

I dette API endepunktet kan en hente ut ansatte for angitt klient (firma) og evt. andre andre filter en ønsker å avgrense på.

Endepunktet er api/public/v1/Employee/getPersonalInformation

![](https://cdn-assets.productfruits.com/4ae1ebf5-4cd1-4908-bc0b-a84e2706bb69)

  

**Beskrivelse av Request parametere**

Her er en beskrivelse og forklaring av hvilke parametre en kan benytte for å hente ut fravær. En kan få mer detaljer via mouseover på hhv. request parameter og retur felter i API oversikt.

| **Parameter** | **Påkrevd** | **Beskrivelse** | **Merknad** |
| --- | --- | --- | --- |
| accessToken | Ja | Token fra Login. | Kreves for å få svar på API request |
| clientId | Ja | Klientnummer for hvilket firma en skal hente ansatte fra |  |
| departmentIdFilter | Nei | Filter for å hente kun ansatte på angitte avdelingsnr |  |
| includeTimeActive | Nei | Filter for å inkludere kun ansatte som er aktiv i Tid | True / False  <br>Default er True |
| includeTimePassive | Nei | Filter for å inkludere kun ansatte som er passiv i Tid | True / False  <br>Default er False |
| includeAbsenceActive | Nei | Filter for å inkludere kun ansatte som er aktiv i Fravær | True / False  <br>Default er True |
| includeAbsencePassive | Nei | Filter for å inkludere kun ansatte som er passiv i Fravær | True / False  <br>Default er True |
| includePlanActive | Nei | Filter for å inkludere kun ansatte som er aktiv i Plan | True / False  <br>Default er True |
| includePlanPassive | Nei | Filter for å inkludere kun ansatte som er passiv i Plan | True / False  <br>Default er True |
| genderFilter | Nei | Filter for å inkludere kun ansatte av et kjønn | K = Kvinner  <br>M = Menn  <br>Null = Alle (Default) |
| wageGroupIdFilter | Nei | Filter for å inkludere kun ansatte som er med i en av angitte lønnsgruppenr | Ansatt kan kun være medlem i en lønnsgruppe |
| costCarrierIdFilter | Nei | Filter for å inkludere kun ansatte som har en av angitte bærernr |  |
| statisticsGroupCodeFilter | Nei | Filter for å inkludere kun ansatte av en gitt type | A = Arbeider  <br>F = Funksjonær  <br>Null = Alle (Default) |

**Returdata**

Her er en beskrivelse og forklaring av returdata en får fra dette fravær API og hva det i praksis kan benyttes til.

| **Felt** | **Beskrivelse** | **Eksempel** | **Merknad** |
| --- | --- | --- | --- |
| clientid | Klientnr | 100 | Klientnr er et unikt nr for hvert enkelt firma. For konsernkunder kjøres en request for hvert enkelt firma. |
| employeeid | Ansattnr | 155 | Ansattnr |
| departmentId | Avdelingsnr | 50 | Nr på standard avdeling om det er angitt på den ansatte |
| firstname | Fornavn | Ola | Det finnes bare ett felt for navn. Fornavn og etternavn avledes slik:  <br>Alle bortsett fra siste navn i navnefelt  <br>Dersom komma i navnefelt, alle navn etter komma |
| lastname | Etternavn | Danielsen | Det finnes bare ett felt for navn. Fornavn og etternavn avledes slik:  <br>Siste navn fra navnefelt  <br>Dersom komma i navnefelt, alle navn før komma |
| address1 | Adresse 1 | Berghammeren 14 |  |
| address2 | Adresse 2 |  |  |
| countrycode | Landkode | NO | Lankode for postnr / adresse |
| zipCode | Postnr | 6500 |  |
| phoneNumber | Telefonnr |  |  |
| cellphonenumber | Mobilnr | 90012345 |  |
| emailaddress | epostadresse | [ola@bedriften.no](mailto:ola@bedriften.no) |  |
| isTimeActive | Er aktiv i Tid | true | Capitech Tid modul. true eller false |
| isAbsenceActive | Er aktiv i Fravær | true | Capitech Fravær modul. true eller false |
| isPlanActive | Er aktiv i Plan | true | Capitech Plan modul. true eller false |
| phoneNumber2 | Telefonnr 2 |  |  |
| gender | Kjønn | M | K = Kvinne  <br>M = Mann |
| birthdate | Fødselsdato | 100756 | Format ddmmyy |
| employeeStartDate | Ansatt startdato | 2021-07-05 T00:00:00+02:00 | Format yyyy-mm-ddTHH:MM:SS inkludert tidssone |
| employeeEndDate | Ansatt sluttdato |  | Format yyyy-mm-ddTHH:MM:SS inkludert tidssone |
| employeeSeniorityDate | Ansatt ansiennitetsdato |  | Format yyyy-mm-ddTHH:MM:SS inkludert tidssone |
| externalId | ekstern id |  | Id fra eksternt system som kan benyttes ved innlegging av ansatte inn til Capitech via API |
| wageGroupId | Lønnsgruppenr | 10 | Nr på lønnsgruppe den ansatte tilhører |
| taskId | Arbeidsoppgavenr | 25 | Nr på standard arbeidsoppgave om det er angitt på den ansatte |
| projectId | Prosjektnr |  | Nr på standard prosjekt om det er angitt på den ansatte |
| subprojectId | Underprosjektnr |  | Nr på standard underprosjekt om det er angitt på den ansatte |
| phaseId | Fasenr |  | Nr på standard fase om det er angitt på den ansatte |
| orderId | Ordenr |  | Nr på standard ordre om det er angitt på den ansatte |
| freedimension1Id | Fri dimensjon 1 nr |  | Nr på standard fri dimensjon 1 om det er angitt på den ansatte |
| freedimension2Id | Fri dimensjon 2 nr |  | Nr på standard fri dimensjon 2 om det er angitt på den ansatte |
| costCarrierId | Bærernr |  | Nr på standard kostnadsbærer om det er angitt på den ansatte |
| statisticsGroupCode | Ansatt type | F | A = Arbeider  <br>F = Funksjonær |
| registrationAccess | Registreringstilgang | 3 | Tilgang til registrering i Min Capitech<br>\-2 = Ingen registrering, kun visning  <br>\-1 = Registrere inn og ut (her og nå)  <br>0 = Registrering i dag  <br>X = Flere dager med etterregistrering (hvor x er antall dager og større enn 0)  <br>  <br>Eksempel:  <br>Om registrationaccess = 3 betyr det at den ansatte har tilgang til å etterregistrere timer for opptil 3 dager bakover fra i dag. |
| cardNumber | kortnr | 188 | Kortnummer om det er angitt på den ansatte. (F.eks strekkode eller magnet kort) |
| RFID | RFIDnr | 45677844944746 | Nummer på RFID kort om det er angitt på den ansatte. |
| hmsCardId | hmskortnr |  | Id fra HMS kort dersom dette er lagret på den ansatte. |
| authenticationId | ekstern brukerid | [ola@bedriften.no](mailto:ola@bedriften.no) | Ekstern brukerid som benyttes ved bruk av ekstern pålogging, f.eks Azure AD |
| nearestLeaderUserId | Nærmeste leder brukernavn | OleH | Brukernavn for nærmeste leder |
| nearestLeaderName | Nærmeste leder navn | Ole Hansen | Navn på nærmeste leder |
| nearestLeaderEmail | Nærmeste leder E-post | [ole.hansen@bedriften.com](mailto:ole.hansen@bedriften.com) | E-post adresse til nærmeste leder |
| countryCodeCellphone | Landkode mobilnr | 47 | Landkode for den ansattes mobilnr |
| willRegisterTime | Skal registrere tid | true | Den ansatte skal registrere tid |
| isFlexitimeActive | Er aktiv i fleksitid | true | Capitech fleksitid modul. true eller false |
| isSmsActive | Er aktiv i sms | true | Capitech sms modul. true eller false |
| isManualAdditionsActive | Er manuelle tillegg aktivert | true | Manuelle tillegg aktivert. true eller false |
| id | Unik id | 854 | Unik id for denne ansatte |

**Tips**

Du kan se mer detaljer om API parametere og returdata i en demoløsning her [Demosalg.capitech.no/API](http://demosalg.capitech.no/API)