GET
/
organizations
/
{organization_id}
/
employees
/
{employee_id}
Get Employee
curl --request GET \
  --url https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id} \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id}")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "id": "<string>",
  "organization_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "employee_data": {
    "birth_date": "2023-12-25",
    "personal_data": {
      "employee_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "id": 123,
      "employee_name": {
        "family_name": "<string>",
        "given_name": "<string>",
        "family_name_prefix": "<string>",
        "given_name_suffix": "<string>",
        "birth_name": "<string>",
        "birth_family_name_prefix": "<string>",
        "birth_given_name_suffix": "<string>",
        "title": "<string>"
      },
      "employment_country": "DE",
      "nationality": "<string>",
      "residence_address": "<string>",
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25"
    },
    "related_persons": {
      "employee_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "id": 123,
      "persons": [
        {}
      ],
      "employment_country": "DE",
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25"
    },
    "job_details": {
      "employee_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "employment_country": "DE",
      "is_seasonal_worker": true,
      "job_title": "<string>",
      "job_description": "<string>",
      "occupation_code": "<string>",
      "contracted_weekly_hours": 40,
      "contracted_weekdays": [],
      "contracted_to_other_company": false,
      "worksite_id": "<string>",
      "department": "<string>",
      "other_jobs": [
        {
          "employment_country": "DE",
          "employer_name": "<string>",
          "employment_start_date": "2023-12-25",
          "monthly_gross_income": "<string>"
        }
      ],
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25"
    },
    "insurance_details": {
      "employee_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "employment_country": "DE",
      "insurance_number": "<string>",
      "contribution_group": "<string>",
      "insurance_provider": "<string>",
      "alternate_collection_agency": "<string>",
      "private_insurance_health_monthly": "0",
      "private_insurance_care_monthly": "0",
      "care_insurance_children": 0,
      "u1_exempt": false,
      "u2_exempt": false,
      "uv_risk_tariff": [
        {
          "tariff_code": "<string>",
          "tariff_description": "<string>",
          "tariff_percentage": "0"
        }
      ],
      "pension_details": {
        "employment_country": "DE",
        "received_mining_adjustment_payments": false,
        "pension_start_date": "2023-12-25",
        "waiver_declaration_status": "default",
        "waiver_receipt_date": "2023-12-25",
        "waiver_validity_date": "2023-12-25"
      },
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25"
    },
    "tax_details": {
      "employee_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "tax_id": "<string>",
      "employment_country": "DE",
      "child_allowances": "0.0",
      "factor_procedure": false,
      "factor": 123,
      "tax_allowance_amount": "0.00",
      "additional_taxable_amount": "0.00",
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25",
      "church_member": false
    },
    "employment_country": "DE",
    "external_ref": "<string>",
    "start_date": "2023-12-25",
    "end_date": "2023-12-25",
    "birth_place": "<string>",
    "birth_country": "<string>",
    "personal_email": "jsmith@example.com",
    "work_email": "jsmith@example.com",
    "phone_numbers": [
      {
        "phone_number": "<string>",
        "is_primary": false
      }
    ],
    "previous_employee_id": "<string>",
    "next_employee_id": "<string>"
  },
  "bank_accounts": [
    {
      "financial_institution_name": "<string>",
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "account_number": "DE: DE89370400440532013000",
      "routing_number": "DE: 370400440",
      "iban": "DE: DE89370400440532013000",
      "swift_code": "DE: COBADEFFXXX",
      "account_details": {},
      "is_active": true,
      "is_primary": false
    }
  ],
  "pay_group_id": "<string>"
}
{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}

Authorizations

Authorization
string
header
required

Get token from Auth0 and paste it here

Path Parameters

organization_id
required
employee_id
required

Response

Successful Response

Employee response model with metadata fields.

id
string
required

Unique employee identifier

organization_id
string
required

Employee's organization

created_at
string<date-time> | null
required

Employee record creation timestamp

updated_at
string<date-time> | null
required

Employee record last update timestamp

employee_data
DEEmployeeResponse · object
required

Country-specific employee data with IDs and timestamps

bank_accounts
BankAccountResponse · object[]
required

Employee bank accounts

pay_group_id
string | null

Pay group ID for the employee