Get raw HSBCnet-compatible transaction history

Returns transaction history in the raw HSBCnet-compatible responseBody and stmtTranList structure. Use header test: 1 to return seeded in-memory data instead of calling a downstream service. Configured synthetic customer IDs are served from test-data-viewer automatically, bypassing DSP and HSBCnet, and are adapted to the same raw response structure.

Requires authentication: neoSessionCookie (cookie) or xHSBCCustIdHeader (header) or b2bBearerToken (header)

Parameters

Name	In	Description
X-HSBC-Account-Id required string	header	HSBC account identifier for the requested transaction history.
X-HSBC-Account-Currency string	header	Optional account currency used to label returned amounts.
X-HSBC-Request-Correlation-Id string	header	Optional caller-provided correlation identifier.
X-HSBC-CUSTID string	header	Customer identifier used for the customer-id header authentication journey.
test string	header	Set to `1` to serve seeded in-memory data instead of calling the upstream transaction-history service.
lookbackDays integer	query	Number of days of transaction history to request.

Responses

200 Raw transaction history retrieved successfully
400 Invalid request parameters or missing required headers.
401 Missing or invalid authentication.
403 Caller is authenticated but not entitled for the requested account.
500 Unexpected service failure.
502 Downstream transaction-history service returned an invalid or failing response.

curl "https://interact-uat.hsbc.com/yi-transactions-service/v1/transactions/history" \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "X-HSBC-Account-Id: YOUR_X_HSBC_ACCOUNT_ID" \ -H "X-HSBC-Account-Currency: YOUR_X_HSBC_ACCOUNT_CURRENCY" \ -H "X-HSBC-Request-Correlation-Id: YOUR_X_HSBC_REQUEST_CORRELATION_ID" \ -H "X-HSBC-CUSTID: YOUR_X_HSBC_CUSTID" \ -H "test: YOUR_TEST"

const response = await fetch("https://interact-uat.hsbc.com/yi-transactions-service/v1/transactions/history", { headers: { "Authorization": "Bearer YOUR_TOKEN", "X-HSBC-Account-Id": "YOUR_X_HSBC_ACCOUNT_ID", "X-HSBC-Account-Currency": "YOUR_X_HSBC_ACCOUNT_CURRENCY", "X-HSBC-Request-Correlation-Id": "YOUR_X_HSBC_REQUEST_CORRELATION_ID", "X-HSBC-CUSTID": "YOUR_X_HSBC_CUSTID", "test": "YOUR_TEST" }, }); const data = await response.json();

import requests url = "https://interact-uat.hsbc.com/yi-transactions-service/v1/transactions/history" headers = { "Authorization": "Bearer YOUR_TOKEN", "X-HSBC-Account-Id": "YOUR_X_HSBC_ACCOUNT_ID", "X-HSBC-Account-Currency": "YOUR_X_HSBC_ACCOUNT_CURRENCY", "X-HSBC-Request-Correlation-Id": "YOUR_X_HSBC_REQUEST_CORRELATION_ID", "X-HSBC-CUSTID": "YOUR_X_HSBC_CUSTID", "test": "YOUR_TEST", } response = requests.get(url, headers=headers) print(response.json())

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://interact-uat.hsbc.com/yi-transactions-service/v1/transactions/history")) .header("Authorization", "Bearer YOUR_TOKEN") .header("X-HSBC-Account-Id", "YOUR_X_HSBC_ACCOUNT_ID") .header("X-HSBC-Account-Currency", "YOUR_X_HSBC_ACCOUNT_CURRENCY") .header("X-HSBC-Request-Correlation-Id", "YOUR_X_HSBC_REQUEST_CORRELATION_ID") .header("X-HSBC-CUSTID", "YOUR_X_HSBC_CUSTID") .header("test", "YOUR_TEST") .GET() .build(); HttpResponse<String> response = client.send( request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

{ "responseBody": { "accountId": "GBHRFBCA40117703000087", "totalCount": "1", "pagingInfo": { "startIndex": "0", "endIndex": "0", "isMoreRec": "N" }, "sortInfo": { "sortColumn": "PD", "sortOrder": "D" }, "stmtTranList": [ { "lastUpdtTmStmp": "2026-08-04T09:44:48.427694Z", "bosPostDt": "2026-08-03", "seqNo": "1", "bosLastTmStmp": "2026-08-04T10:44:48Z", "narrative": { "rawNarrative": "/REMI/Example remittance narrative", "shortNarrative": "N", "normalizedNarrative": [ "/REMI/Example remittance narrative" ] }, "bosPostTmStamp": "07.42.32", "amt": "-67.89", "rvrslInd": "N", "type": { "isoFamCode": "MDOP", "cfonbCode": "44", "bosCode": "TT", "orginalCode": "-0072", "btrCode": "TT", "baiCode": "0495", "isoDomnCode": "PMNT", "swiftCode": "NTRF", "isoSubFamCode": "OTHR" }, "tC": "S", "crDbInd": "D", "ref": { "bank": "RBE03086K8JOQ60W", "channel": "RBE03086K8JOQ60W", "customer": "Example customer reference" }, "postDate": "2026-08-03", "blendedTransactionParty": "Example remittance party", "blendedTransactionReference": null, "valDt": "2026-08-03", "openingBalance": "", "runningBalance": "", "closingBalance": "" } ] }, "statusCode": "200" }