get/archives

Liefert eine Liste der gültigen gespeicherten Archive zur Referenz-Id eines Kunden.

Request

Endpoint: POST https://bankathon.fb-xpert.fb-preview.de/hr/external/get/archives

Schema: GET https://bankathon.fb-xpert.fb-preview.de/hr/external/get/archives/request/schema


property default description options
[ token ] * required
string
Ein gültiger Token für die Autentifizierung mit der Schnittstelle.
[ referenz_id ] * required
string
Fremd-Id des Kunden
example:

mime-type: application/json, text/json

{
    "token": "a1s2d3f4g5h6j7k8l9",
    "referenz_id": "abc123"
}
example:

mime-type: application/json, text/json

{
    "token": "a1s2d3f4g5h6j7k8l9",
    "referenz_id": "abc123"
}

Response

Schema: GET https://bankathon.fb-xpert.fb-preview.de/hr/external/get/archives/response/schema


property description options
[ status ] * required
string
Status des Aufrufs
OK: Anfrage erfolgreich
ERROR: Anfrage verlief fehlerhaft

array
Liste der gültigen gespeicherten Archive zur übergebenen Referenz-Id des Kunden
property description options
archives[ name ]
string
Name für das Archiv
archives[ description ]
string
Beschreibung für das Archiv
archives[ transaction_id ]
string
Vorgangs-Id
archives[ created ]
date
Datum und Uhrzeit, wann das Archiv erstellt wurde
archives[ expired ]
date
Datum und Uhrzeit, bis wann das Archiv gültig ist
archives[ company_name ]
string
Gesellschaftsname
archives[ detail_name ]
string
Tarifname
example:

mime-type: application/json, text/json

{
    "status": "OK",
    "archives": [
        {
            "name": "Mein Archiv für Kunde X",
            "description": "Meine Archivbeschreibung für Kunde X",
            "transaction_id": "123456789abcdefg",
            "created": "2025-01-01 12:01:00",
            "expired": "2026-01-01 00:00:00",
            "company_name": "Gesellschaft XY",
            "detail_name": "Produkt XY"
        }
    ]
}