File Status Timeline

Returns the ordered status timeline for a single payment file for the authenticated customer.

Parameters

Name	In	Description
X-HSBC-Request-Correlation-Id string	header	Optional trace identifier forwarded to downstream services and recorded in logs. Include this value when raising support requests. A UUID is recommended; auto-generated when not supplied.
fileUuid required string	path	The identifier of the payment file whose status timeline should be returned.

Responses

200 The status timeline for the requested payment file
400 fileUuid is blank
401 Missing or invalid NEO session
429 Too many requests — rate limit exceeded
500 Unexpected server error
503 The payment file service is temporarily unavailable
403 Forbidden — insufficient permissions for this resource

curl "https://interact-uat.hsbc.com/payment-service/api/v0/payment-files/timeline/{fileUuid}" \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "X-HSBC-Request-Correlation-Id: YOUR_X_HSBC_REQUEST_CORRELATION_ID"

const response = await fetch("https://interact-uat.hsbc.com/payment-service/api/v0/payment-files/timeline/{fileUuid}", { headers: { "Authorization": "Bearer YOUR_TOKEN", "X-HSBC-Request-Correlation-Id": "YOUR_X_HSBC_REQUEST_CORRELATION_ID" }, }); const data = await response.json();

import requests url = "https://interact-uat.hsbc.com/payment-service/api/v0/payment-files/timeline/{fileUuid}" headers = { "Authorization": "Bearer YOUR_TOKEN", "X-HSBC-Request-Correlation-Id": "YOUR_X_HSBC_REQUEST_CORRELATION_ID", } 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/payment-service/api/v0/payment-files/timeline/{fileUuid}")) .header("Authorization", "Bearer YOUR_TOKEN") .header("X-HSBC-Request-Correlation-Id", "YOUR_X_HSBC_REQUEST_CORRELATION_ID") .GET() .build(); HttpResponse<String> response = client.send( request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());