Skip to main content
GET
Get Employee Insurance Details History

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

organization_id
required
employee_id
required

Response

Successful Response

Response model for insurance details with metadata fields.

employee_id
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
id
required
employment_country
string
default:DE
Allowed value: "DE"
insurance_number
string | null
contribution_group
string | null
person_group
enum<integer> | null

An IntEnum representing the key numbers ('Schlüsselzahlen') for person groups in German social insurance notifications (DEÜV).

Available options:
101,
102,
103,
104,
105,
106,
107,
108,
109,
110,
111,
112,
113,
114,
116,
117,
118,
119,
120,
121,
122,
123,
124,
127,
190,
140,
141,
142,
143,
144,
149,
150,
203,
204,
207,
208,
209,
210,
301,
302,
303,
304,
305,
306,
307
insurance_provider
string | null
alternate_collection_agency
string | null
private_insurance_health_monthly
string | null
default:0

EN:Private health insurance monthly|DE:Private Krankenversicherung monatlich

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$
private_insurance_care_monthly
string | null
default:0

EN: Private care insurance monthly | DE: Private Pflegeversicherung monatlich

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$
care_insurance_children
integer | null
default:0
u1_exempt
boolean | null
default:false
u2_exempt
boolean | null
default:false
uv_risk_tariff
RiskTariff · object[] | null
pension_details
PensionDetails · object | null

Pension details for German employees according to Annex 04a specification. Required for extended plausibility checks of employed pensioners.

valid_from
string<date> | null

EN: Valid from date | DE: Gültig ab Datum

valid_to
string<date> | null

EN: Valid to date | DE: Gültig bis Datum