KEX-Vorgang-Update-API

⚠️ You’ll find German domain-specific terms in the documentation, for translations and further explanations please refer to our glossary

General

APIs for updating data in KreditSmart-Vorgängen. The URL for this service is:

https://kex-vorgaenge.ratenkredit.api.europace.de/vorgaenge

All APIs documented here are GraphQL-APIs.

⚠️ This API is continuously developed. Therefore we expect all users to align with the “Tolerant Reader Pattern”, which requires clients to be tolerant towards compatible API changes when reading and processing the data. This means:

  1. unknown properties must not result in errors

  2. Strings with a restricted set of values (Enums) must support new unknown values

  3. sensible usage of HTTP status codes, even if they are not explicitly documented

Authentication

These APIs are secured by the OAuth 2.0 client credentials flow using the Authorization-API. To use these APIs your OAuth2-Client needs the following scopes:

ScopeLabel in PartnermanagementDescription
privatkredit:vorgang:schreibenKreditSmart-Vorgänge anlegen/verändernScope for updating a Vorgang

GraphQL-Requests

These APIs accept data with the content-type application/json with UTF-8 encoding. The fields inside a block can be sent in any order.

The APIs support all common GraphQL formats. More information can be found at https://graphql.org/learn/queries/.

The body of a GraphQL request contains the field query, which includes the GraphQL query as a String. Parameters can be set directly in the query or defined as variables. The variables can be sent in the variables field of the body as a key-value map. All our examples use variables.

{
  "query": "...",
  "variables": { ... }
}

Error Codes

One of the special features in GraphQL is that most errors are not reflected via HTTP error codes. In many cases you receive a status code 200, even though an error has occurred. These GraphQL errors can be found in the errors field of the response body. More information about error codes can be found here.

HTTP-Status Errors

Error CodeMessageDescription
401UnauthorizedAuthentication failed
403ForbiddenThe API client misses a scope
415Unsupported MediaTypeThe wrong content type was used

GraphQL Errors

Error CodeMessageDescription
400Bad RequestRequest format is invalid (mandatory fields are missing, wrong parameter names or values, …)
403ForbiddenThe authenticated user does not have sufficient rights
404Not FoundThe Vorgang does not exist
410GoneThe Vorgang was deleted in the meantime

Update data of Antragsteller

Hints

  • The Vorgang has to have the status=AKTIV, which means it must not be archived.
  • The authenticated user has to be the Bearbeiter of the Vorgang.
  • The antragstellerId has to refer to an existing Antragsteller in the Vorgang.
  • The Datenkontext (TESTUMGEBUNG|ECHTGESCHAEFT) has to be allowed for the authenticated user.
  • Values of fields, which do not have a default value and are not specified in the request, will be deleted.

Update Antragsteller

addAntragsteller ( vorgangsnummer: String!, antragsteller: Antragsteller! ) -> BasicResponse!

Add an Antragsteller to a Vorgang. The Response contains the id of the created Antragsteller. This id can be used to update or delete this Antragsteller.

Hints

  • A Vorgang can have at most two Antragsteller.
  • All fields within the Antragsteller are optional, if they are omitted an empty Antragsteller is created.

deleteAntragsteller ( vorgangsnummer: String!, id: String! ) -> BasicResponse!

Delete an existing Antragsteller. The Antragsteller is referenced by the id.

Hints

  • A Vorgang must always have at least one Antragsteller.

Update Personendaten

updatePersonendaten ( vorgangsnummer: String!, antragstellerId: String!, personendaten: Personendaten! ) -> BasicResponse!

This mutation is for updating the Personendaten for an Antragsteller of a Vorgang.

Example

POST Request
POST https://kex-vorgaenge.ratenkredit.api.europace.de/vorgaenge
Authorization: Bearer xxxx
Content-Type: application/json

{
  "query": "mutation personendaten($vorgangsnummer: String!, $antragstellerId: String!) {  
    updatePersonendaten(vorgangsnummer: $vorgangsnummer, antragstellerId: $antragstellerId, personendaten: { 
      vorname: "Max"
      nachname: "Mustermann"
    }) { 
      messages
    } 
  }",
  "variables": {
    "vorgangsnummer": "ABC123",
    "antragstellerId": "12345678-abcd-wxyz-0987-1234567890ab"
  }
}
POST Response
{
  "data": {
    "messages": []
  },
  "errors": []
}

Update Wohnsituation

updateWohnsituation ( vorgangsnummer: String!, antragstellerId: String!, wohnsituation: Wohnsituation! ) -> BasicResponse!

This mutation is for updating the Wohnsituation for an Antragsteller of a Vorgang.

Example

POST Request
POST https://kex-vorgaenge.ratenkredit.api.europace.de/vorgaenge
Authorization: Bearer xxxx
Content-Type: application/json

{
  "query": "mutation wohnsituation($vorgangsnummer: String!, $antragstellerId: String!) {  
    updateWohnsituation(vorgangsnummer: $vorgangsnummer, antragstellerId: $antragstellerId, wohnsituation: { 
      wohnart: ZUR_MIETE
      anzahlPersonenImHaushalt: 1
    }) { 
      messages
    } 
  }",
  "variables": {
    "vorgangsnummer": "ABC123",
    "antragstellerId": "12345678-abcd-wxyz-0987-1234567890ab"
  }
}

Update Herkunft

updateHerkunft ( vorgangsnummer: String!, antragstellerId: String!, herkunft: Herkunft! ) -> BasicResponse!

This mutation is for updating the Herkunft for an Antragsteller of a Vorgang.

Example

POST Request
POST https://kex-vorgaenge.ratenkredit.api.europace.de/vorgaenge
Authorization: Bearer xxxx
Content-Type: application/json

{
  "query": "mutation herkunft($vorgangsnummer: String!, $antragstellerId: String!) {  
    updateHerkunft(vorgangsnummer: $vorgangsnummer, antragstellerId: $antragstellerId, herkunft: { 
      staatsangehoerigkeit: DE
      steuerId: "11345678904"
    }) { 
      messages
    } 
  }",
  "variables": {
    "vorgangsnummer": "ABC123",
    "antragstellerId": "12345678-abcd-wxyz-0987-1234567890ab"
  }
}
POST Response
{
  "data": {
    "messages": []
  },
  "errors": []
}

Update Beschäftigung

updateBeschaeftigung ( vorgangsnummer: String!, antragstellerId: String!, beschaeftigung: Beschaeftigung! ) -> BasicResponse!

This mutation is for updating the Beschaeftigung for an Antragsteller of a Vorgang.

Hints

  • The Beschaeftigung is only taking one Beschäftigungsart into account and uses only the corresponding fields for the update.

Example

POST Request
POST https://kex-vorgaenge.ratenkredit.api.europace.de/vorgaenge
Authorization: Bearer xxxx
Content-Type: application/json

{
  "query": "mutation beschaeftigung($vorgangsnummer: String!, $antragstellerId: String!) {  
    updateBeschaeftigung(vorgangsnummer: $vorgangsnummer, antragstellerId: $antragstellerId, beschaeftigung: { 
      beschaeftigungsart:ARBEITER,
      arbeiter: {
        beschaeftigungsverhaeltnis: {
          nettoeinkommenMonatlich: 2345.67,
          befristung: UNBEFRISTET,
          beschaeftigtSeit: "2009-01-02",
          arbeitgeber: {
            name: "Firmenname",
            branche: INFORMATION_KOMMUNIKATION,
            anschrift: {
              ort: "Berlin"
            }
          }
        }
      }
    }) { 
      messages
    } 
  }",
  "variables": {
    "vorgangsnummer": "ABC123",
    "antragstellerId": "12345678-abcd-wxyz-0987-1234567890ab"
  }
}
POST Response
{
  "data": {
    "messages": []
  },
  "errors": []
}

Update Haushaltspositionen

Hints

  • The Vorgang has to have the status=AKTIV, which means it must not be archived.
  • The authenticated user has to be the Bearbeiter of the Vorgang.
  • Every entry in antragstellerIds has to correspond to an Antragsteller in the Vorgang.
  • The Datenkontext (TESTUMGEBUNG|ECHTGESCHAEFT) has to be allowed for the authenticated user.
  • Values of fields, which do not have a default value and are not specified in the request, will be deleted.
  • The value of the field id has to correspond to a Haushaltsposition in the Vorgang with the corresponding type.

Update Einkunft aus Nebentaetigkeit

Hints

  • The Haushaltsposition Einkunft aus einer Nebentätigkeit can only be related to one Antragsteller. If you provide more than one antragstellerId you will receive a GraphQL error with the error code 422 - UNPROCESSABLE ENTITY.

addEinkunftAusNebentaetigkeit ( vorgangsnummer String!, einkunftAusNebentaetigkeit EinkunftAusNebentaetigkeit! ) -> BasicCreatedResponse!

Add a Einkunft aus einer Nebentätigkeit to a Vorgang. The Response contains the id of the created Haushaltsposition. This id can be used to update or delete this Haushaltsposition.

updateEinkunftAusNebentaetigkeit ( vorgangsnummer: String!, id: String!, einkunftAusNebentaetigkeit EinkunftAusNebentaetigkeit! ) -> BasicResponse!

Update an existing Einkunft aus einer Nebentätigkeit. The Haushaltsposition is referenced by the id.

deleteEinkunftAusNebentaetigkeit ( vorgangsnummer: String!, id: String!) -> BasicResponse!

Delete an existing Einkunft aus einer Nebentätigkeit. The Haushaltsposition is referenced by the id.

Update Immobilie

addImmobilie ( vorgangsnummer: String!, immobilie: Immobilie! ) -> BasicCreatedResponse!

Add an Immobilie to a Vorgang. The Response contains the id of the created Haushaltsposition. This id can be used to update or delete this Haushaltsposition.

updateImmobilie ( vorgangsnummer: String!, id: String!, immobilie: Immobilie! ) -> BasicResponse!

Update an existing Immobilie. The Haushaltsposition is referenced by the id.

deleteImmobilie ( vorgangsnummer: String!, id: String!) -> BasicResponse!

Delete an existing Immobilie. The Haushaltsposition is referenced by the id.

Update Kind

addKind ( vorgangsnummer String!, kind Kind! ) -> BasicCreatedResponse!

Add a Kind to a Vorgang. The Response contains the id of the created Haushaltsposition. This id can be used to update or delete this Haushaltsposition.

updateKind ( vorgangsnummer: String!, id: String!, kind Kind! ) -> BasicResponse!

Update an existing Kind. The Haushaltsposition is referenced by the id.

deleteKind ( vorgangsnummer: String!, id: String!) -> BasicResponse!

Delete an existing Kind. The Haushaltsposition is referenced by the id.

Update Kontoverbindung

updateKontoverbindung ( vorgangsnummer: String!, kontoverbindung Kontoverbindung! ) -> BasicResponse!

Update the Kontoverbindung.

Hints

  • If iban or bic are invalid, the value will be ignored and set to null.

Update Mietausgabe

addMietausgabe ( vorgangsnummer String!, mietausgabe Mietausgabe! ) -> BasicCreatedResponse!

Add a Mietausgabe to a Vorgang. The Response contains the id of the created Haushaltsposition. This id can be used to update or delete this Haushaltsposition.

updateMietausgabe ( vorgangsnummer: String!, id: String!, mietausgabe Mietausgabe! ) -> BasicResponse!

Update an existing Mietausgabe. The Haushaltsposition is referenced by the id.

deleteMietausgabe ( vorgangsnummer: String!, id: String!) -> BasicResponse!

Delete an existing Mietausgabe. The Haushaltsposition is referenced by the id.

Update Private Krankenversicherung

Hints

  • The Haushaltsposition private Krankenversicherung can only be related to one Antragsteller. If you provide more than one antragstellerId you will receive a GraphQL error with the error code 422
    • UNPROCESSABLE ENTITY.

addPrivateKrankenversicherung ( vorgangsnummer String!, privateKrankenversicherung PrivateKrankenversicherung! ) -> BasicCreatedResponse!

Add a private Krankenversicherung to a Vorgang. The Response contains the id of the created Haushaltsposition. This id can be used to update or delete this Haushaltsposition.

updatePrivateKrankenversicherung ( vorgangsnummer: String!, id: String!, privateKrankenversicherung PrivateKrankenversicherung! ) -> BasicResponse!

Update an existing private Krankenversicherung. The Haushaltsposition is referenced by the id.

deletePrivateKrankenversicherung ( vorgangsnummer: String!, id: String!) -> BasicResponse!

Delete an existing private Krankenversicherung. The Haushaltsposition is referenced by the id.

Update Unterhaltsverpflichtung

addUnterhaltsverpflichtung ( vorgangsnummer String!, unterhaltsverpflichtung Unterhaltsverpflichtung! ) -> BasicCreatedResponse!

Add an Unterhaltsverpflichtung to a Vorgang. The Response contains the id of the created Haushaltsposition. This id can be used to update or delete this Haushaltsposition.

updateUnterhaltsverpflichtung ( vorgangsnummer: String!, id: String!, unterhaltsverpflichtung Unterhaltsverpflichtung! ) -> BasicResponse!

Update an existing Unterhaltsverpflichtung. The Haushaltsposition is referenced by the id.

deleteUnterhaltsverpflichtung ( vorgangsnummer: String!, id: String!) -> BasicResponse!

Delete an existing Unterhaltsverpflichtung. The Haushaltsposition is referenced by the id.

Update Finanzbedarf

Hints

  • The Vorgang has to have the status=AKTIV, which means it must not be archived.
  • The authenticated user has to be the Bearbeiter of the Vorgang.
  • The Datenkontext (TESTUMGEBUNG|ECHTGESCHAEFT) has to be allowed for the authenticated user.
  • Values of fields, which do not have a default value and are not specified in the request, will be deleted.

Update Finanzierungswunsch

updateFinanzierungswunsch ( vorgangsnummer: String!, finanzierungswunsch: Finanzierungswunsch! ) -> BasicResponse!

This mutation is for updating the Finanzierungswunsch of a Vorgang.

Hints

  • The field Finanzierungswunsch.rateMonatlich is only processed, if the field laufzeitInMonaten is not set.
  • If the field Finanzierungswunsch.ratenzahlungstermin is not specified, the default value MONATSENDE is used.

Example

POST Request
POST https://kex-vorgaenge.ratenkredit.api.europace.de/vorgaenge
Authorization: Bearer xxxx
Content-Type: application/json

{
  "query": "mutation finanzierungswunsch($vorgangsnummer: String!) {  
    updateFinanzierungswunsch(vorgangsnummer: $vorgangsnummer, finanzierungswunsch: { kreditbetrag: 10000 }){
      messages
    }
  }",
  "variables": {
    "vorgangsnummer": "ABC123"
  }
}
POST Response
{
  "data": {
    "messages": []
  },
  "errors": []
}

Update Ratenschutz

updateRatenschutz ( vorgangsnummer: String!, antragstellerId: String!, ratenschutz: Ratenschutz! ) -> BasicResponse!

This mutation is for updating the Ratenschutz for an Antragsteller of a Vorgang.

Hints

  • The antragstellerId has to refer to an existing Antragsteller in the Vorgang.
  • The agent must be allowed to sell payment protection insurances.

Kommentare hinzufügen

addKommentare ( vorgangsnummer: String!, kommentare: [String!]! ) -> BasicResponse!

This mutation is for adding one or more Kommentare to a Vorgang.

Hints

  • The Vorgang has to have the status=AKTIV, which means it must not be archived.
  • The authenticated user has to have Übernahmerechte to the Kundenbetreuer.
  • The Datenkontext (TESTUMGEBUNG|ECHTGESCHAEFT) has to be allowed for the authenticated user.
  • Empty Strings will be ignored.

Example

POST Request

POST https://kex-vorgaenge.ratenkredit.api.europace.de/vorgaenge
Authorization: Bearer xxxx
Content-Type: application/json

{
  "query": "mutation kommentare($vorgangsnummer: String!) {  
    addKommentare(vorgangsnummer: $vorgangsnummer, kommentare: ["kommentar 1", "kommentar 2"]){
      messages
    }
  }",
  "variables": {
    "vorgangsnummer": "ABC123"
  }
}

POST Response

{
  "data": {
    "messages": []
  },
  "errors": []
}

Request-Datentypen

Antragsteller

{
    "herkunft": Herkunft,
    "personendaten": Personendaten,
    "wohnsituation": Wohnsituation,
    "beschaeftigung": Beschaeftigung
}

Beschaeftigung

{
    "beschaeftigungsart": "ANGESTELLTER" | "ARBEITER" | "ARBEITSLOSER" | "BEAMTER" | "FREIBERUFLER" | "HAUSFRAU" | "RENTNER" | "SELBSTSTAENDIGER",
    "angestellter": Angestellter,
    "arbeiter": Arbeiter,              
    "arbeitsloser": Arbeitsloser,
    "beamter": Beamter,
    "freiberufler": Freiberufler,
    "hausfrau": Hausfrau,
    "rentner": Rentner,
    "selbststaendiger": Selbstständiger
}

The beschaeftigungsart determines which data is used. For example the beschaeftigungsart=ARBEITER means that all data of field arbeiter is used, for beschaeftigungsart=BEAMTER the data of field beamter is used. All other fields will be ignored. If there is no value for beschaeftigungsart or the corresponding field to a beschaeftigungsart is empty, all data is ignored.

Angestellter

{
    "beschaeftigungsverhaeltnis": {
        "arbeitgeber": Firma,   
        "berufsbezeichnung": String,
        "befristung": "BEFRISTET" | "UNBEFRISTET",
        "befristetBis": "YYYY-MM-DD",
        "beschaeftigtSeit": "YYYY-MM-DD",
        "inProbezeit": true | false,
        "nettoeinkommenMonatlich": BigDecimal
    },
    "vorherigesBeschaeftigungsverhaeltnis": {
        "arbeitgeber": Firma,
        "beschaeftigtSeit": "YYYY-MM-DD",
        "beschaeftigtBis": "YYYY-MM-DD"
    }
}

Arbeiter

{
    "beschaeftigungsverhaeltnis": {
        "arbeitgeber": Firma,   
        "berufsbezeichnung": String,
        "befristung": "BEFRISTET" | "UNBEFRISTET",
        "befristetBis": "YYYY-MM-DD",
        "beschaeftigtSeit": "YYYY-MM-DD",
        "inProbezeit": true | false,
        "nettoeinkommenMonatlich": BigDecimal
    },
    "vorherigesBeschaeftigungsverhaeltnis": {
        "arbeitgeber": Firma,
        "beschaeftigtSeit": "YYYY-MM-DD",
        "beschaeftigtBis": "YYYY-MM-DD"
    }
}

Arbeitsloser

{
    "sonstigesEinkommenMonatlich": BigDecimal
}

Beamter

{
    "beschaeftigungsverhaeltnis": {
        "arbeitgeber": Firma,
        "berufsbezeichnung": String,
        "beschaeftigtSeit": "YYYY-MM-DD",
        "inProbezeit": true | false,
        "nettoeinkommenMonatlich": BigDecimal,
        "verbeamtetSeit": "YYYY-MM-DD"
    },
    "vorherigesBeschaeftigungsverhaeltnis": {
        "arbeitgeber": Firma,
        "beschaeftigtSeit": "YYYY-MM-DD",
        "beschaeftigtBis": "YYYY-MM-DD"
    }
}

Freiberufler

{
    "berufsbezeichnung": String,
    "firma": Firma,
    "selbststaendigSeit": "YYYY-MM-DD", 
    "nettoeinkommenJaehrlich": BigDecimal,
    "bruttoEinkommenLaufendesJahr": BigDecimal,
    "einkommenssteuerLaufendesJahr": BigDecimal,
    "abschreibungenLaufendesJahr": BigDecimal,
    "bruttoEinkommenLetztesJahr": BigDecimal,
    "einkommenssteuerLetztesJahr": BigDecimal,
    "abschreibungenLetztesJahr": BigDecimal,
    "einkommenssteuerVor2Jahren": BigDecimal,
    "bruttoEinkommenVor2Jahren": BigDecimal,
    "abschreibungenVor2Jahren": BigDecimal,
    "bruttoEinkommenVor3Jahren": BigDecimal,
    "einkommenssteuerVor3Jahren": BigDecimal,
    "abschreibungenVor3Jahren": BigDecimal
}

Hausfrau

{
    "sonstigesEinkommenMonatlich": BigDecimal
}

Rentner

{
    "rentenversicherung": {
        "name": String,
        "anschrift": Anschrift
    },
    "rentnerSeit": "YYYY-MM-DD",
    "staatlicheRenteMonatlich": BigDecimal
}

Selbstständiger

{
    "berufsbezeichnung": String,
    "firma": Firma,
    "selbststaendigSeit": "YYYY-MM-DD",
    "nettoeinkommenJaehrlich": BigDecimal,
    "bruttoEinkommenLaufendesJahr": BigDecimal,
    "einkommenssteuerLaufendesJahr": BigDecimal,
    "abschreibungenLaufendesJahr": BigDecimal,
    "bruttoEinkommenLetztesJahr": BigDecimal,
    "einkommenssteuerLetztesJahr": BigDecimal,
    "abschreibungenLetztesJahr": BigDecimal,
    "einkommenssteuerVor2Jahren": BigDecimal,
    "bruttoEinkommenVor2Jahren": BigDecimal,
    "abschreibungenVor2Jahren": BigDecimal,
    "bruttoEinkommenVor3Jahren": BigDecimal,
    "einkommenssteuerVor3Jahren": BigDecimal,
    "abschreibungenVor3Jahren": BigDecimal
}

Anschrift

{
    "strasse": String,
    "hausnummer": String,
    "plz": String,
    "ort": String,
    "land": Country
}

Country

This Type uses the format ISO-3166/ALPHA-2

In addition there is the value “SONSTIGE” (“other”)

"AD" | "AE" | "AF" | "AG" | "AL" | "AM" | "AO" | "AR" | "AT" | "AU" | "AZ" | "BA" | "BB" | "BD" | "BE" | "BF" | "BG" | "BH" | "BI" | "BJ" | "BN" | "BO" | "BR" | "BS" | "BT" | "BW" | "BY" | "BZ" | "CA" | "CD" | "CF" | "CG" | "CH" | "CI" | "CK" | "CL" | "CM" | "CN" | "CO" | "CR" | "XK" | "CU" | "CV" | "CY" | "CZ" | "DE" | "DJ" | "DK" | "DM" | "DO" | "DZ" | "EC" | "EE" | "EG" | "ER" | "ES" | "ET" | "FI" | "FJ" | "FM" | "FR" | "GA" | "GB" | "GD" | "GE" | "GH" | "GM" | "GN" | "GQ" | "GR" | "GT" | "GW" | "GY" | "HN" | "HR" | "HT" | "HU" | "ID" | "IE" | "IL" | "IN" | "IQ" | "IR" | "IS" | "IT" | "JM" | "JO" | "JP" | "KE" | "KG" | "KH" | "KI" | "KM" | "KN" | "KP" | "KR" | "KW" | "KZ" | "LA" | "LB" | "LC" | "LI" | "LK" | "LR" | "LS" | "LT" | "LU" | "LV" | "LY" | "MA" | "MC" | "MD" | "ME" | "MG" | "MH" | "MK" | "ML" | "MM" | "MN" | "MR" | "MT" | "MU" | "MV" | "MW" | "MX" | "MY" | "MZ" | "NA" | "NE" | "NG" | "NI" | "NL" | "NO" | "NP" | "NR" | "NU" | "NZ" | "OM" | "PA" | "PE" | "PG" | "PH" | "PK" | "PL" | "PS" | "PT" | "PW" | "PY" | "QA" | "RO" | "RS" | "RU" | "RW" | "SA" | "SB" | "SC" | "SD" | "SE" | "SG" | "SI" | "SK" | "SL" | "SM" | "SN" | "SO" | "SR" | "SS" | "ST" | "SV" | "SY" | "SZ" | "TD" | "TG" | "TH" | "TJ" | "TL" | "TM" | "TN" | "TO" | "TR" | "TT" | "TV" | "TZ" | "UA" | "UG" | "US" | "UY" | "UZ" | "VA" | "VC" | "VE" | "VN" | "VU" | "WS" | "YE" | "ZA" | "ZM" | "ZW" | "SONSTIGE"

Firma

{
    "anschrift": Anschrift,
    "branche": "LANDWIRTSCHAFT_FORSTWIRTSCHAFT_FISCHEREI" | "ENERGIE_WASSERVERSORGUNG_BERGBAU" | "VERARBEITENDES_GEWERBE" | "BAUGEWERBE" | "HANDEL" | "VERKEHR_LOGISTIK" | "INFORMATION_KOMMUNIKATION" | "GEMEINNUETZIGE_ORGANISATION" | "KREDITINSTITUTE_VERSICHERUNGEN" | "PRIVATE_HAUSHALTE" | "DIENSTLEISTUNGEN" | "OEFFENTLICHER_DIENST" | "GEBIETSKOERPERSCHAFTEN" | "HOTEL_GASTRONOMIE" | "ERZIEHUNG_UNTERRICHT" | "KULTUR_SPORT_UNTERHALTUNG" | "GESUNDHEIT_SOZIALWESEN",
    "name": String
}

EinkunftAusNebentaetigkeit

{
    "antragstellerIds": [ String ],
    "beginnDerTaetigkeit": "YYYY-MM-DD",
    "betragMonatlich": BigDecimal
}

Finanzierungswunsch

{
    "kreditbetrag": BigDecimal,
    "laufzeitInMonaten": Integer,
    "provisionswunschInProzent": BigDecimal,
    "rateMonatlich": BigDecimal,
    "ratenzahlungstermin": Ratenzahlungstermin
}

Ratenzahlungstermin

    "MONATSENDE" | "MONATSMITTE"

Herkunft

{
    "arbeitserlaubnisVorhanden": true | false,
    "arbeitserlaubnisBefristetBis": "YYYY-MM-DD",
    "aufenthaltstitel": "VISUM" | "AUFENTHALTSERLAUBNIS" | "NIEDERLASSUNGSERLAUBNIS" | "ERLAUBNIS_ZUM_DAUERAUFENTHALT_EU",
    "aufenthaltBefristetBis": "YYYY-MM-DD",
    "inDeutschlandSeit": "YYYY-MM-DD",
    "staatsangehoerigkeit": Country,
    "steuerId": String
}

Immobilie

{
    "bezeichnung": String,
    "darlehen": [
        {
            "restschuld": BigDecimal,
            "zinsbindungBis": "YYYY-MM-DD",
            "rateMonatlich": BigDecimal
        }
    ],
    "gehoertZuAntragsteller": Antragstellerzuordnung,
    "immobilienart": "EIGENTUMSWOHNUNG" | "EINFAMILIENHAUS" | "MEHRFAMILIENHAUS" | "BUEROGEBAEUDE",
    "mieteinnahmenKaltMonatlich": BigDecimal,
    "mieteinnahmenWarmMonatlich": BigDecimal,
    "nebenkostenMonatlich": BigDecimal,
    "nutzungsart": "EIGENGENUTZT" | "VERMIETET" | "EIGENGENUTZT_UND_VERMIETET",
    "vermieteteWohnflaeche": Integer,
    "wert": BigDecimal,
    "wohnflaeche": Integer
}

Kind

{
    "gehoertZuAntragsteller": Antragstellerzuordnung,
    "kindergeldFuer": "ERSTES_ODER_ZWEITES_KIND" | "DRITTES_KIND" | "AB_VIERTEM_KIND",
    "name": String,
    "unterhaltseinnahmenMonatlich": BigDecimal
}

Kontoverbindung

{
    "antragstellerIds": [ String ],
    "bic": String,
    "iban": String
}

Mietausgabe

{
    "antragstellerIds": [ String ],
    "betragMonatlich": BigDecimal
}

Personendaten

{
    "anrede": "FRAU" | "HERR",
    "email": String,
    "familienstand": "LEDIG" | "VERHEIRATET" | "GESCHIEDEN" | "VERWITWET" | "GETRENNT_LEBEND" | "EHEAEHNLICHE_LEBENSGEMEINSCHAFT" | "EINGETRAGENE_LEBENSPARTNERSCHAFT",
    "geburtsdatum": "YYYY-MM-DD",
    "geburtsland": Country,
    "geburtsname": String,
    "geburtsort": String,
    "nachname": String,
    "telefonGeschaeftlich": String,
    "telefonPrivat": String,
    "titel": [ "DOKTOR" | "PROFESSOR" ],
    "vorname": String
}

Private Krankenversicherung

{
    "antragstellerIds": [ String ],
    "betragMonatlich": BigDecimal
}

Ratenschutz

{
    "arbeitslosigkeitAbsicherung": RatenschutzAbsicherung,
    "arbeitsunfaehigkeitAbsicherung": RatenschutzAbsicherung,
    "todesfallAbsicherung": RatenschutzAbsicherung
}

RatenschutzAbsicherung

{
    "gewuenscht": Boolean,
    "kommentar": String,
    "vorhanden": Boolean,
    "wichtig": Boolean
}

Unterhaltsverpflichtung

{
    "antragstellerIds": [ String ],
    "betragMonatlich": BigDecimal
}

Wohnsituation

{
    "anschrift": Wohnanschrift,
    "anzahlPersonenImHaushalt": Integer,
    "anzahlPkw": Integer,
    "gemeinsamerHaushalt": true | false,
    "voranschrift": Wohnanschrift,
    "wohnart": "ZUR_MIETE" | "ZUR_UNTERMIETE" | "IM_EIGENEN_HAUS" | "BEI_DEN_ELTERN"
}

Wohnanschrift

{
    "strasse": String,
    "hausnummer": String,
    "plz": String,
    "ort": String,
    "land": Country,
    "wohnhaftSeit": "YYYY-MM-DD"
}

Response-Datentypen

If we do server-side adaptions of the data to ensure a valid dataset, we add hints to the messages field of the response. These are purely to inform the client, there are NEVER any errors in the messages field. Errors will be only shown in the errors field of the response.

BasicResponse

{
    "messages" [ String ]
}

BasicCreatedResponse

{
    "messages": [ String ]
    "id": String
}

Terms of use

The APIs are made available under the following Terms of Use.



GitHub Dokumentation