Employment

Details of an employment

Activity name : <a href="https://developer.loket.nl/Activities/GetEmploymentByEmploymentId" target="_blank">GetEmploymentByEmploymentId</a>

Get the details for an employment

get/v2/providers/employers/employees/employments/{employmentId}

Request

  • Base URL
    https://api.loket.nl
  • URL
    https://api.loket.nl/v2/providers/employers/employees/employments/{employmentId}
  • Auth
    none required

Path parameters

employmentIdstring uuid required

The unique identifier of the employment

Headers

Authorizationstring required
Example:Bearer <TOKEN>

A valid Bearer token for authorizing the request.

Acceptstring required
Example:application/json;version=2018-01-01

The accept header is used to influence what type of output is returned and in most cases the version of the output

Response

OK

Example response

{
  "version": {
    "resourceVersion": "2018-12-31"
  },
  "messages": [
    {
      "type": "Warning",
      "description": "<some warning>",
      "id": "904d6856-6034-4624-bcbc-886188c115c5",
      "code": 12
    }
  ],
  "content": {
    "employee": {
      "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
      "employeeNumber": 156,
      "firstName": "Susan",
      "initials": "S.L.",
      "prefix": "van",
      "lastName": "Bergen",
      "prefixPartner": "van de",
      "lastNamePartner": "Wiel",
      "formattedName": "Wiel - van Bergen S.L. van de",
      "dateOfBirth": "1995-05-21",
      "photo": "https://api.loket.nl/v2/v2/providers/employers/employees/{employeeId}/photo/{version}"
    },
    "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "startDate": "2018-01-01",
    "historicalStartDate": "2012-05-01",
    "commissionUntilDate": "2019-01-01",
    "endDate": "2018-10-23",
    "endOfEmploymentReason": {
      "key": 1,
      "value": "VUT"
    },
    "endOfEmploymentReasonTaxAuthorities": {
      "key": 1,
      "value": "Beëindiging arbeidsovereenkomst met wederzijds goedvinden op initiatief van de werkgever."
    },
    "payrollAdministration": {
      "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
      "name": "ABC accountants",
      "clientNumber": 1234,
      "description": "Bakker",
      "cla": {
        "value": "Agriculture"
      },
      "wageModel": {
        "value": "Foresting monthly payrolling"
      }
    },
    "nonPayrollAdministration": {
      "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
      "name": "HR only employees",
      "description": "Bakker"
    },
    "administration": {
      "id": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
      "name": "ABC accountants",
      "clientNumber": 1234,
      "description": "Bakker"
    },
    "typeOfEmployee": {
      "key": 1,
      "value": "Werknemer"
    },
    "employmentCategoryType": {
      "key": 1,
      "value": "Ouderschapsverlof"
    },
    "linkedEmployment": "b14acd0d-75d7-4fc8-8b22-4a3924585cab",
    "employmentDurationType": {
      "key": 1,
      "value": "Contract of indefinite duration"
    },
    "startDateContractOfIndefiniteDuration": "2018-05-08",
    "employmentContractType": {
      "key": 1,
      "value": "Arbeidsovereenkomst (excl BBL)"
    },
    "vacationCoupons": {
      "key": 1,
      "value": "n.v.t."
    },
    "sendToExternalParty": {
      "key": 1,
      "value": "n.v.t."
    },
    "deviatingCLAExternalParty": 2,
    "deviatingCLATaxReturn": 2,
    "incomeRelationshipNumber": 12,
    "employeeProfileId": {
      "key": 1,
      "value": "Profiel full-timers"
    },
    "professionCode": 4,
    "typeOfParticipation": {
      "value": "n.vt."
    },
    "valueOfParticipation": {
      "value": "n.v.t."
    },
    "essMutationSet": {
      "key": 1,
      "value": "Standaard"
    },
    "exemptionInsuranceObligation": {
      "value": "Geen uitzondering."
    },
    "specialIncomeRatio": {
      "value": "n.v.t."
    },
    "emailLeaveRequest": "api@loket.nl",
    "temporaryTaxExemption": {
      "key": 2,
      "value": "Nee."
    },
    "periodPayGradeAdjustment": 2,
    "commissionUntilDate1": "2018-05-31",
    "commissionUntilDate2": "2018-05-31",
    "commissionUntilDate3": "2018-05-31",
    "commissionUntilDate4": "2018-05-31",
    "commissionUntilDate5": "2018-05-31",
    "commissionUntilDate6": "2018-05-31",
    "isOnCallEmployment": true,
    "hasOnCallAppearanceObligation": true,
    "isGemoedsbezwaardNationalInsurance": true,
    "isGemoedsbezwaardEmployeeInsurance": true,
    "isAnonymousEmployee": true,
    "cancellationPeriodEmployee": 1,
    "cancellationPeriodEmployer": 1,
    "cancellationPeriodTimeUnit": {
      "key": 4,
      "value": "Maand(en)"
    },
    "cancellationNoticeDate": "2018-05-31",
    "startCancellationNoticePeriod": "2018-06-01",
    "payrollId": 2,
    "namePayslip": "Steve Jobs",
    "calculateWorkingHours": true,
    "writtenEmploymentContract": true
  }
}

Changes

No recorded changes to this operation across all 6 revisions of this API.