Skip to main content
GET
Get Employee Tax Details

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 tax details with metadata fields.

employee_id
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
id
required
tax_id
string
required
Required string length: 11
tax_class
enum<string>
required

Steuerklasse (STKL)

Available options:
1,
2,
3,
4,
5,
6
employment_country
string
default:DE
Allowed value: "DE"
child_allowances
string
default:0.0
Pattern: ^(?!^[-+.]*$)[+-]?0*(?:\d{0,1}|(?=[\d.]{1,3}0*$)\d{0,1}\.\d{0,1}0*$)
church_confession
enum<string> | null

German church tax confessions as defined in ELSTAM API

Available options:
AK,
EV,
FA,
FB,
FG,
FM,
FR,
FS,
IB,
IH,
IL,
IS,
IW,
JD,
JH,
LT,
RF,
RK,
NA,
KEINE
church_confession_partner
enum<string> | null

Konfession des Partners - ELSTAM: kirchensteuer_partner

Available options:
AK,
EV,
FA,
FB,
FG,
FM,
FR,
FS,
IB,
IH,
IL,
IS,
IW,
JD,
JH,
LT,
RF,
RK,
NA,
KEINE
factor_procedure
boolean
default:false
factor
integer | null
tax_allowance_amount
string | null
default:0.00
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
additional_taxable_amount
string | null
default:0.00
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
valid_from
string<date> | null

Gültig ab Datum - ELSTAM: gueltig_ab

valid_to
string<date> | null

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

church_member
boolean
default:false
church_tax_state
enum<string> | null

German states (Bundesländer) with their official names

Available options:
Baden-Württemberg,
Bayern,
Berlin,
Brandenburg,
Bremen,
Hamburg,
Hessen,
Mecklenburg-Vorpommern,
Niedersachsen,
Nordrhein-Westfalen,
Rheinland-Pfalz,
Saarland,
Sachsen,
Sachsen-Anhalt,
Schleswig-Holstein,
Thüringen