Getting your Verification Report
Authorization
In order to fetch the accounts and transactions of a user customers require the access token that has been obtained in the previous steps. Use this token to make requests to the accounts and transactions endpoints.
Endpoints Overview
Request Example:
GET /rest/account-verifications/{account-verification-id}
Example Response:
{
"id": "9054f9b1-0d19-4788-a990-b493d5723419",
"provided": {
"name": "Max Mustermann",
"iban": "DE93300308800013441006"
},
"matched": {
"name": "Max Mustermann",
"affinity": "VERY_HIGH"
},
"account": {
"name": "FlexiCash",
"type": "Giro account",
"owners": [],
"iban": "DE93300308800013441006",
"currency": "EUR"
}
}
The verification report provides an evaluation of the affinity between the initially provided name
and the best matching account-holder name.
The affinity is
VERY_HIGH
if the names literally match (case-insensitive)HIGH
if there is a significant overlap with only minor deviations (e.g. "Doe, John"
instead of "John Doe" or "Hans Muller" instead of "Hans Müller")MEDIUM
if there is only some similarity between the names (e.g. "Helge Braun" vs.
"Stefan Braun")LOW
if the names don't match at all.
Under normal circumstances, it is advised to consider the affinities
VERY_HIGH
andHIGH
as a match and disregardMEDIUM
andLOW
affinities.
The receipt also contains some basic account information like the IBAN, type and account-
name.
Error Handling
The finX API employs HTTP status codes to indicate the outcome of each API request. Familiarity with these codes is essential for understanding the response.
200 OK: This status code indicates a successful request, typically returned when retrieving account or transaction data.
400 Bad Request: If the request is malformed, contains missing or invalid parameters, or violates validation rules, the API responds with a 400 status code.
401 Unauthorized: When the provided authorization is insufficient or invalid, the API responds with a 401 status code, indicating the need for proper user authentication.
404 Not Found: This status code signifies that the specified resource or endpoint is not available or was not found.
Updated 2 months ago