/infoservice/schufa/score/creditcheck/
Response Daten
Bei einer erfolgreichen Anfrage HTTP-Statuscode = 200 werden als Antwort immer folgende Datentypen als JSON encoded String zurückgeliefert:
Response ⬆️
Das Response Objekt wird sowohl bei erfolgreichen als auch fehlerbehafteten Schufa Antworten zurückgeliefert
| Feld | Beschreibung | Feldeigenschaften | mögliche Werte |
|---|---|---|---|
| bSuccess | Zeigt an, ob eine Anfrage an die Schufa erfolgreich war | type: boolean | true oder false |
| aMessage | Beinhaltet zusätzliche Informationen zum Anfrageergebnis | type: array of infoserviceResponseMessage | siehe infoserviceResponseMessage |
| sRaw | enthält die originale Schufa Antwort, als XML string (Schufa Format) | type: string format: XML |
Unterschiedlich je nach Anfrage und ermittelter Daten, siehe Beispieldaten. |
Data ⬆️
Das Data Objekt wird nur bei erfolgreichen Anfragen (bSuccess=true) befüllt. Im Fehlerfall ist deren Wert null.
| Feld | Beschreibung | Feldeigenschaften | mögliche Werte | Hinweis |
|---|---|---|---|---|
| ServiceReference | Eindeutige Referenz/ID von der Schufa für eventuelle Rückfragen | type: string | example: "1234567891011" | |
| CustomerReference | Eine von Ihnen vergebene eindeutige Referenz/ID zur Anfrage | type: string | example: "Ihr Zeichen 123" | Wird nur befüllt, wenn in der Anfrage die Variable CustomerReference angegeben wurde |
| ScoreCard | Scoring Ergebnis von der Schufa | type: object | siehe ScoreCard |
ScoreCard ⬆️
| Feld | Beschreibung | Feldeigenschaften | mögliche Werte | Hinweis |
|---|---|---|---|---|
| ScoreValue | Enthält den eigentlichen Score | type: integer | example: 9800 | |
| RiskQuote | Die Risikoquote beschreibt die Wahrscheinlichkeit in Prozent dafür, dass bei der beauskunfteten Person, innerhalb eines bestimmten Zeitraumes, ein (neuer) Negativeintrag zur Einspeicherung kommt | type: string | example: "1.94" | |
| ScoreArea | Der Scorebereich enthält die individuelle Angabe des zum Scorewert dazugehörigen Bereich | type: string | example: "B" | |
| ScoreText | Der Scoretext kann die Scoreinformationen ergänzen und konkretisieren | type: string | example: "RATINGSTUFE B" |
infoserviceResponseMessage ⬆️
Beinhaltet zusätzliche Informationen zum Anfrageergebnis.
| Feld | Beschreibung | Feldeigenschaften | mögliche Werte |
|---|---|---|---|
| sKey | Gibt die Art der Information an | type: string | "code" "info" "error" |
| sValue | Information in textueller Form | type: string | example: "Operation successful" |
✅ Beispiel Response - erfolgreiche Schufa Antwort
{
"Response": {
"bSuccess": true,
"aMessage": [
{
"sKey": "info",
"sValue": "request successfully completed"
}
],
"sRaw": "\"<bon:Bonitaetsauskunft xmlns:bon=\\\"http:\\\/\\\/ifd-schema.de\\\/BonitaetsauskunftSCHUFA\\\">..<\\\/bon:Bonitaetsauskunft>\""
},
"Data": {
"ServiceReference": "15470464",
"CustomerReference": "60001167",
"ScoreCard": {
"ScoreValue": 244,
"RiskQuote": "0,00",
"ScoreArea": "L",
"ScoreText": "INKASSO L, INKASSO INDEX 031"
}
}
}🚫 Beispiel Response - Schufa Antwort mit Fehlermeldung
{
"Response": {
"bSuccess": false,
"aMessage": [
{
"sKey": "error",
"sValue": "Bei der Verarbeitung der Businesslogik aufgetretene Ausnahme"
},
{
"sKey": "code_1",
"sValue": "BER0012"
},
{
"sKey": "info_1",
"sValue": "Teilnehmer nicht berechtigt"
}
],
"sRaw": "\"<bon:AusnahmeAntwort xmlns:bon=\\\"http:\\\/\\\/ifd-schema.de\\\/BonitaetsauskunftSCHUFA\\\">...<\\\/bon:AusnahmeAntwort>\""
},
"Data": null
}