Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Body
application/json · EmployeeRequest · object[]
Response
Successful Response
The response is of type any
.
curl --request POST \
--url https://sandbox.intermezzo.ai/organizations/{organization_id}/employees \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[
{
"employeeData": {
"employmentCountry": "DE",
"externalRef": "<string>",
"startDate": "2023-12-25",
"endDate": "2023-12-25",
"birthDate": "2023-12-25",
"birthPlace": "<string>",
"birthCountry": "<string>",
"personalEmail": "jsmith@example.com",
"workEmail": "jsmith@example.com",
"phoneNumbers": [
{
"phoneNumber": "<string>",
"phoneType": "mobile",
"isPrimary": true
}
],
"personalData": {
"employmentCountry": "DE",
"employeeName": {
"familyName": "<string>",
"givenName": "<string>",
"familyNamePrefix": "<string>",
"givenNameSuffix": "<string>",
"birthName": "<string>",
"birthFamilyNamePrefix": "<string>",
"birthGivenNameSuffix": "<string>",
"title": "<string>"
},
"gender": "M",
"maritalStatus": "Single",
"nationality": "German",
"residenceAddress": "Taigschuster 11, 82380 Peissenberg, Germany",
"statusIndicator": "managing_partner_gmbh_ug",
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"relatedPersons": {
"employmentCountry": "DE",
"persons": [
{
"dependentName": {
"familyName": "<string>",
"givenName": "<string>",
"familyNamePrefix": "<string>",
"givenNameSuffix": "<string>",
"birthName": "<string>",
"birthFamilyNamePrefix": "<string>",
"birthGivenNameSuffix": "<string>",
"title": "<string>"
},
"dependentBirthDate": "2023-12-25",
"relationshipProof": "<string>"
}
],
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"jobDetails": {
"employmentCountry": "DE",
"jobType": "Full Time Indefinite Term",
"employmentStatus": "Employee",
"isSeasonalWorker": true,
"jobTitle": "<string>",
"jobDescription": "<string>",
"schoolEducation": "Ohne Schulabschluss",
"professionalEducation": "Ohne beruflichen Ausbildungsabschluss",
"occupationCode": "<string>",
"contractedWeeklyHours": 123,
"contractedToOtherCompany": false,
"worksiteId": "<string>",
"department": "<string>",
"otherJobs": [
{
"employmentCountry": "DE",
"employerName": "<string>",
"employmentStartDate": "2023-12-25",
"monthlyGrossIncome": 1
}
],
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"insuranceDetails": {
"employmentCountry": "DE",
"insuranceNumber": "12345678A123",
"contributionGroup": "<string>",
"personGroup": 101,
"insuranceProvider": "<string>",
"alternateCollectionAgency": "<string>",
"privateInsuranceHealthMonthly": 1,
"privateInsuranceCareMonthly": 1,
"careInsuranceChildren": 2,
"u1Exempt": true,
"u2Exempt": true,
"uvRiskTariff": [
{
"tariffCode": "<string>",
"tariffDescription": "<string>",
"tariffPercentage": 123
}
],
"pensionDetails": {
"employmentCountry": "DE",
"receivedMiningAdjustmentPayments": false,
"pensionType": "full_old_age_pension_eu_eea_sva",
"pensionStartDate": "2023-12-25",
"waiverDeclarationStatus": "default",
"waiverReceiptDate": "2023-12-25",
"waiverValidityDate": "2023-12-25"
},
"validFrom": "2023-12-25",
"validTo": "2023-12-25",
"birthDateContext": "2023-12-25"
},
"taxDetails": {
"employmentCountry": "DE",
"taxId": "<string>",
"taxClass": "1",
"childAllowances": 4.5,
"churchConfession": "AK",
"churchConfessionPartner": "AK",
"factorProcedure": false,
"factor": 499,
"taxAllowanceAmount": 1,
"additionalTaxableAmount": 1,
"validFrom": "2023-12-25",
"validTo": "2023-12-25",
"churchMember": false,
"churchTaxState": "Baden-Württemberg"
}
},
"bankAccounts": [
{
"financialInstitutionName": "Deutsche Bank",
"accountNumber": "DE89370400440532013000",
"routingNumber": "<string>",
"iban": "<string>",
"isActive": true,
"isPrimary": false
}
]
}
]'
"<any>"
curl --request POST \
--url https://sandbox.intermezzo.ai/organizations/{organization_id}/employees \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[
{
"employeeData": {
"employmentCountry": "DE",
"externalRef": "<string>",
"startDate": "2023-12-25",
"endDate": "2023-12-25",
"birthDate": "2023-12-25",
"birthPlace": "<string>",
"birthCountry": "<string>",
"personalEmail": "jsmith@example.com",
"workEmail": "jsmith@example.com",
"phoneNumbers": [
{
"phoneNumber": "<string>",
"phoneType": "mobile",
"isPrimary": true
}
],
"personalData": {
"employmentCountry": "DE",
"employeeName": {
"familyName": "<string>",
"givenName": "<string>",
"familyNamePrefix": "<string>",
"givenNameSuffix": "<string>",
"birthName": "<string>",
"birthFamilyNamePrefix": "<string>",
"birthGivenNameSuffix": "<string>",
"title": "<string>"
},
"gender": "M",
"maritalStatus": "Single",
"nationality": "German",
"residenceAddress": "Taigschuster 11, 82380 Peissenberg, Germany",
"statusIndicator": "managing_partner_gmbh_ug",
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"relatedPersons": {
"employmentCountry": "DE",
"persons": [
{
"dependentName": {
"familyName": "<string>",
"givenName": "<string>",
"familyNamePrefix": "<string>",
"givenNameSuffix": "<string>",
"birthName": "<string>",
"birthFamilyNamePrefix": "<string>",
"birthGivenNameSuffix": "<string>",
"title": "<string>"
},
"dependentBirthDate": "2023-12-25",
"relationshipProof": "<string>"
}
],
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"jobDetails": {
"employmentCountry": "DE",
"jobType": "Full Time Indefinite Term",
"employmentStatus": "Employee",
"isSeasonalWorker": true,
"jobTitle": "<string>",
"jobDescription": "<string>",
"schoolEducation": "Ohne Schulabschluss",
"professionalEducation": "Ohne beruflichen Ausbildungsabschluss",
"occupationCode": "<string>",
"contractedWeeklyHours": 123,
"contractedToOtherCompany": false,
"worksiteId": "<string>",
"department": "<string>",
"otherJobs": [
{
"employmentCountry": "DE",
"employerName": "<string>",
"employmentStartDate": "2023-12-25",
"monthlyGrossIncome": 1
}
],
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"insuranceDetails": {
"employmentCountry": "DE",
"insuranceNumber": "12345678A123",
"contributionGroup": "<string>",
"personGroup": 101,
"insuranceProvider": "<string>",
"alternateCollectionAgency": "<string>",
"privateInsuranceHealthMonthly": 1,
"privateInsuranceCareMonthly": 1,
"careInsuranceChildren": 2,
"u1Exempt": true,
"u2Exempt": true,
"uvRiskTariff": [
{
"tariffCode": "<string>",
"tariffDescription": "<string>",
"tariffPercentage": 123
}
],
"pensionDetails": {
"employmentCountry": "DE",
"receivedMiningAdjustmentPayments": false,
"pensionType": "full_old_age_pension_eu_eea_sva",
"pensionStartDate": "2023-12-25",
"waiverDeclarationStatus": "default",
"waiverReceiptDate": "2023-12-25",
"waiverValidityDate": "2023-12-25"
},
"validFrom": "2023-12-25",
"validTo": "2023-12-25",
"birthDateContext": "2023-12-25"
},
"taxDetails": {
"employmentCountry": "DE",
"taxId": "<string>",
"taxClass": "1",
"childAllowances": 4.5,
"churchConfession": "AK",
"churchConfessionPartner": "AK",
"factorProcedure": false,
"factor": 499,
"taxAllowanceAmount": 1,
"additionalTaxableAmount": 1,
"validFrom": "2023-12-25",
"validTo": "2023-12-25",
"churchMember": false,
"churchTaxState": "Baden-Württemberg"
}
},
"bankAccounts": [
{
"financialInstitutionName": "Deutsche Bank",
"accountNumber": "DE89370400440532013000",
"routingNumber": "<string>",
"iban": "<string>",
"isActive": true,
"isPrimary": false
}
]
}
]'
"<any>"
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Successful Response
The response is of type any
.
Was this page helpful?