curl --request GET \
--url https://api.prod.finverse.net/card_details \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.prod.finverse.net/card_details"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.prod.finverse.net/card_details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.prod.finverse.net/card_details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.prod.finverse.net/card_details"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.prod.finverse.net/card_details")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.prod.finverse.net/card_details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"card_details": {
"card_accounts": [
{
"account_id": "01HCMFSKAFT37ESRFTHNJK3CTZ",
"account_name": "American Express Platinum",
"account_number_masked": "378XXXXXXXX0005",
"account_type": {
"subtype": "CREDIT_CARD",
"type": "CARD"
},
"available_credit_limit": {
"currency": "SGD",
"raw": "19045.31",
"value": 19045.31
},
"current_balance": {
"currency": "SGD",
"raw": "-954.69",
"value": -954.69
},
"last_payment_amount": {
"currency": "SGD",
"raw": "100.00",
"value": 100
},
"last_payment_date": "2023-07-15",
"minimum_payment_due": {
"currency": "SGD",
"raw": "120.00",
"value": 120
},
"next_payment_due_date": "2023-08-05",
"payment_due_amount": {
"currency": "SGD",
"raw": "420.43",
"value": 420.43
},
"rewards_balances": [
{
"raw": "572489",
"unit": "TB$",
"value": 572489
}
],
"statement_date": "2023-08-05",
"statement_due_amount": {
"currency": "SGD",
"raw": "520.43",
"value": 520.43
},
"statement_payment_due_date": "2023-08-05",
"total_credit_limit": {
"currency": "SGD",
"raw": "20000.00",
"value": 20000
},
"updated_at": "2023-10-13T12:22:40.602Z"
},
{
"account_id": "01HCMFSKAM6G4J525H6H19S3W1",
"account_name": "HKD Credit Card",
"account_number_masked": "1234XXXXXXXX0000",
"account_type": {
"subtype": "CREDIT_CARD",
"type": "CARD"
},
"available_credit_limit": {
"currency": "HKD",
"raw": "8166.78",
"value": 8166.78
},
"current_balance": {
"currency": "HKD",
"raw": "-1833.22",
"value": -1833.22
},
"last_payment_amount": {
"currency": "HKD",
"raw": "1220.00",
"value": 1220
},
"last_payment_date": "2023-07-19",
"minimum_payment_due": {
"currency": "HKD",
"raw": "120.00",
"value": 120
},
"next_payment_due_date": "2023-08-11",
"payment_due_amount": {
"currency": "HKD",
"raw": "0.00",
"value": 0
},
"rewards_balances": [
{
"raw": "3895",
"unit": "TB$",
"value": 3895
}
],
"statement_date": "2023-08-11",
"statement_due_amount": {
"currency": "HKD",
"raw": "1220.00",
"value": 1220
},
"statement_payment_due_date": "2023-08-11",
"total_credit_limit": {
"currency": "HKD",
"raw": "10000.00",
"value": 10000
},
"updated_at": "2023-10-13T12:22:40.602Z"
},
{
"account_id": "01HCMFSKASNNFP3XJYCFJF60F8",
"account_name": "UOB Visa",
"account_number_masked": "4242XXXXXXXX4242",
"account_type": {
"subtype": "CREDIT_CARD",
"type": "CARD"
},
"available_credit_limit": {
"currency": "SGD",
"raw": "98543.10",
"value": 98543.1
},
"current_balance": {
"currency": "SGD",
"raw": "-1456.90",
"value": -1456.9
},
"last_payment_amount": {
"currency": "SGD",
"raw": "1220.00",
"value": 1220
},
"last_payment_date": "2023-07-25",
"minimum_payment_due": {
"currency": "SGD",
"raw": "220.00",
"value": 220
},
"next_payment_due_date": "2023-08-15",
"payment_due_amount": {
"currency": "SGD",
"raw": "0.00",
"value": 0
},
"rewards_balances": [
{
"raw": "123",
"unit": "TB$",
"value": 123
}
],
"statement_date": "2023-08-15",
"statement_due_amount": {
"currency": "SGD",
"raw": "1220.00",
"value": 1220
},
"statement_payment_due_date": "2023-08-15",
"total_credit_limit": {
"currency": "SGD",
"raw": "100000.00",
"value": 100000
},
"updated_at": "2023-10-13T12:22:40.602Z"
}
],
"card_total": {
"available_credit_limit": {
"currency": "HKD",
"raw": "125755.19189453125",
"value": 125755.191
},
"current_balance": {
"currency": "HKD",
"raw": "-4244.809997558594",
"value": -4244.81
},
"minimum_payment_due": {
"currency": "HKD",
"raw": "460",
"value": 460
},
"payment_due_amount": {
"currency": "HKD",
"raw": "420.42999267578125",
"value": 420.43
},
"rewards_balances": [],
"statement_due_amount": {
"currency": "HKD",
"raw": "2960.4299926757812",
"value": 2960.43
},
"updated_at": "2023-10-13T12:22:40.602Z"
}
},
"institution": {
"countries": [
"HKG",
"IDN",
"MYS",
"PHL",
"SGP",
"THA",
"VNM"
],
"institution_id": "testbank",
"institution_name": "Testbank",
"portal_name": "Testbank Online Banking"
},
"login_identity": {
"last_session_id": "01HCMFRWSNHSCE28DZC1ST6XFT",
"login_identity_id": "01HCMFRWR208N4NM9M8WYC7JEG",
"status": "DATA_RETRIEVAL_COMPLETE"
}
}{
"error": {
"details": "<string>",
"error_code": "CREDENTIALS_INVALID",
"message": "<string>",
"request_id": "<string>",
"type": "LINKING_ERROR"
}
}{
"error": {
"details": "<string>",
"error_code": "CREDENTIALS_INVALID",
"message": "<string>",
"request_id": "<string>",
"type": "LINKING_ERROR"
}
}List card details
Retrieve all Card Details under a Login Identity (using a specific login_identity_token).
Authorization: login_identity_token
card_details (object)
Card details, split into (i) account-level, and (ii) aggregated across all card accounts.
card_accounts (array of objects)
Full card_accounts array, containing a list of card accounts with account-level balances, card payment details & metadata.
currency object (object)
Details of any currency amount (e.g. payment or balance amount).
amount object (object)
Details of any non-currency amount (e.g. reward amount).
card_totals (object)
Total card balances, payment details & metadata, when reported by the institution at an aggregate-level (instead of at card_account level). Finverse does not compute these values if not reported by the institution..
institution (object)
Summary Institutions object. See GET /institutions for details.
login_identity (object)
Summary Login Identity object. See GET /login_identity for details.
curl --request GET \
--url https://api.prod.finverse.net/card_details \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.prod.finverse.net/card_details"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.prod.finverse.net/card_details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.prod.finverse.net/card_details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.prod.finverse.net/card_details"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.prod.finverse.net/card_details")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.prod.finverse.net/card_details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"card_details": {
"card_accounts": [
{
"account_id": "01HCMFSKAFT37ESRFTHNJK3CTZ",
"account_name": "American Express Platinum",
"account_number_masked": "378XXXXXXXX0005",
"account_type": {
"subtype": "CREDIT_CARD",
"type": "CARD"
},
"available_credit_limit": {
"currency": "SGD",
"raw": "19045.31",
"value": 19045.31
},
"current_balance": {
"currency": "SGD",
"raw": "-954.69",
"value": -954.69
},
"last_payment_amount": {
"currency": "SGD",
"raw": "100.00",
"value": 100
},
"last_payment_date": "2023-07-15",
"minimum_payment_due": {
"currency": "SGD",
"raw": "120.00",
"value": 120
},
"next_payment_due_date": "2023-08-05",
"payment_due_amount": {
"currency": "SGD",
"raw": "420.43",
"value": 420.43
},
"rewards_balances": [
{
"raw": "572489",
"unit": "TB$",
"value": 572489
}
],
"statement_date": "2023-08-05",
"statement_due_amount": {
"currency": "SGD",
"raw": "520.43",
"value": 520.43
},
"statement_payment_due_date": "2023-08-05",
"total_credit_limit": {
"currency": "SGD",
"raw": "20000.00",
"value": 20000
},
"updated_at": "2023-10-13T12:22:40.602Z"
},
{
"account_id": "01HCMFSKAM6G4J525H6H19S3W1",
"account_name": "HKD Credit Card",
"account_number_masked": "1234XXXXXXXX0000",
"account_type": {
"subtype": "CREDIT_CARD",
"type": "CARD"
},
"available_credit_limit": {
"currency": "HKD",
"raw": "8166.78",
"value": 8166.78
},
"current_balance": {
"currency": "HKD",
"raw": "-1833.22",
"value": -1833.22
},
"last_payment_amount": {
"currency": "HKD",
"raw": "1220.00",
"value": 1220
},
"last_payment_date": "2023-07-19",
"minimum_payment_due": {
"currency": "HKD",
"raw": "120.00",
"value": 120
},
"next_payment_due_date": "2023-08-11",
"payment_due_amount": {
"currency": "HKD",
"raw": "0.00",
"value": 0
},
"rewards_balances": [
{
"raw": "3895",
"unit": "TB$",
"value": 3895
}
],
"statement_date": "2023-08-11",
"statement_due_amount": {
"currency": "HKD",
"raw": "1220.00",
"value": 1220
},
"statement_payment_due_date": "2023-08-11",
"total_credit_limit": {
"currency": "HKD",
"raw": "10000.00",
"value": 10000
},
"updated_at": "2023-10-13T12:22:40.602Z"
},
{
"account_id": "01HCMFSKASNNFP3XJYCFJF60F8",
"account_name": "UOB Visa",
"account_number_masked": "4242XXXXXXXX4242",
"account_type": {
"subtype": "CREDIT_CARD",
"type": "CARD"
},
"available_credit_limit": {
"currency": "SGD",
"raw": "98543.10",
"value": 98543.1
},
"current_balance": {
"currency": "SGD",
"raw": "-1456.90",
"value": -1456.9
},
"last_payment_amount": {
"currency": "SGD",
"raw": "1220.00",
"value": 1220
},
"last_payment_date": "2023-07-25",
"minimum_payment_due": {
"currency": "SGD",
"raw": "220.00",
"value": 220
},
"next_payment_due_date": "2023-08-15",
"payment_due_amount": {
"currency": "SGD",
"raw": "0.00",
"value": 0
},
"rewards_balances": [
{
"raw": "123",
"unit": "TB$",
"value": 123
}
],
"statement_date": "2023-08-15",
"statement_due_amount": {
"currency": "SGD",
"raw": "1220.00",
"value": 1220
},
"statement_payment_due_date": "2023-08-15",
"total_credit_limit": {
"currency": "SGD",
"raw": "100000.00",
"value": 100000
},
"updated_at": "2023-10-13T12:22:40.602Z"
}
],
"card_total": {
"available_credit_limit": {
"currency": "HKD",
"raw": "125755.19189453125",
"value": 125755.191
},
"current_balance": {
"currency": "HKD",
"raw": "-4244.809997558594",
"value": -4244.81
},
"minimum_payment_due": {
"currency": "HKD",
"raw": "460",
"value": 460
},
"payment_due_amount": {
"currency": "HKD",
"raw": "420.42999267578125",
"value": 420.43
},
"rewards_balances": [],
"statement_due_amount": {
"currency": "HKD",
"raw": "2960.4299926757812",
"value": 2960.43
},
"updated_at": "2023-10-13T12:22:40.602Z"
}
},
"institution": {
"countries": [
"HKG",
"IDN",
"MYS",
"PHL",
"SGP",
"THA",
"VNM"
],
"institution_id": "testbank",
"institution_name": "Testbank",
"portal_name": "Testbank Online Banking"
},
"login_identity": {
"last_session_id": "01HCMFRWSNHSCE28DZC1ST6XFT",
"login_identity_id": "01HCMFRWR208N4NM9M8WYC7JEG",
"status": "DATA_RETRIEVAL_COMPLETE"
}
}{
"error": {
"details": "<string>",
"error_code": "CREDENTIALS_INVALID",
"message": "<string>",
"request_id": "<string>",
"type": "LINKING_ERROR"
}
}{
"error": {
"details": "<string>",
"error_code": "CREDENTIALS_INVALID",
"message": "<string>",
"request_id": "<string>",
"type": "LINKING_ERROR"
}
}