Skip to content

Retrieve Authentications

Returns a list of authentication sessions (3‑DS, amount, merchant, timestamps, etc.) for the current tenant.

URL test:

    https://test.lightcms.io/trancore/v1/trancore/authentications

Method:

GET

Path items:

/trancore/authentications

Parameters:

Parameter Location Type Description
cardId query integer ($int64) Filter by CMS card identifier.
sessionId query string Filter by the UUID that groups all steps of a single authentication flow.
result query string 3‑DS result filter – comma‑separated list of values. Allowed values are the ones returned by /trancore/results3DS (SUCCESS,FAIL,ERROR,TIMEOUT). If omitted, all results are returned.
rdsRefusal query boolean When true, returns only authentications that were refused by Authcore (authcoreRefusal = true). When false, returns only successful ones.
dateTimeFrom query string ($date-time) Lower bound (inclusive) for the authentication start timestamp (startedAt). ISO‑8601 format, e.g. 2025-01-01T00:00:00Z.
dateTimeTo query string ($date-time) Upper bound (inclusive) for the authentication start timestamp (startedAt). ISO‑8601 format.
merchantName query string Case‑insensitive substring match on the merchant name. The value must be wrapped with % wildcards on both sides (e.g. %donio%).
country query string Case‑insensitive substring match on the merchant country code. Also requires surrounding % wildcards (e.g. %czk%).
page query string Zero‑based page index (default 0).
size query string Number of records per page (default 20).

Example request:

    curl -X GET "https://test.lightcms.io/trancore/v1/trancore/authentications" \
         -H 'accept: application/json'

Responses:

200 - OK

Status Code: 200 OK 

[
  {
    "id": 19,
    "sessionId": "dec71e02-55e9-4a84-a6bf-7e9e947afee3",
    "startedAt": "2025-02-15T08:20:33Z",
    "finishedAt": "2025-02-15T08:22:25Z",
    "startTraceId": "9a3cc17bad4c2f949a60f4199d7c5fe0",
    "resultTraceId": "67b04ec1b26783ce7ada5c3b78874fd0",
    "authenticatedAmount": 1135,
    "authenticatedCurrency": "CZK",
    "cardId": 1,
    "merchantName": "E-shop iQLANDIA",
    "merchantCountry": "CZE",
    "authcoreRefusal": false,
    "result3DS": "SUCCESS",
    "duration": "1 minutes 52 seconds",
    "authenticatedDirection": "DEBIT"
  },
  {
    "id": 18,
    "sessionId": "b40fdf06-4542-4c56-b2df-6fb176b8cf72",
    "startedAt": "2025-02-14T17:29:05Z",
    "finishedAt": "2025-02-14T17:30:05Z",
    "startTraceId": "ea48631fddb0f497fac05eaaeae894ae",
    "resultTraceId": "67af7d9da04ee0a0652778e8649c9d88",
    "authenticatedAmount": 14.39,
    "authenticatedCurrency": "EUR",
    "cardId": 1,
    "merchantName": "Steam Purchase",
    "merchantCountry": "USA",
    "authcoreRefusal": false,
    "result3DS": "SUCCESS",
    "duration": "1 minutes 0 seconds",
    "authenticatedDirection": "DEBIT"
  },
  {
    "id": 17,
    "sessionId": "3be584d1-db51-4170-9d03-f8e6c729ca95",
    "startedAt": "2025-02-07T19:31:01Z",
    "finishedAt": "2025-02-07T19:31:23Z",
    "startTraceId": "f15a1cd60b6e595a95fea6877a199534",
    "resultTraceId": "67a65f8b9a7093b950666cb1844ca691",
    "authenticatedAmount": 1290,
    "authenticatedCurrency": "CZK",
    "cardId": 7,
    "merchantName": "RESERVANTO S.R.O.",
    "merchantCountry": "CZE",
    "authcoreRefusal": false,
    "result3DS": "SUCCESS",
    "duration": "0 minutes 22 seconds",
    "authenticatedDirection": "DEBIT"
  }
  // …additional authentication objects follow in the full response…
]

Parameter Type Description
id integer Internal identifier of the authentication session.
sessionId string UUID that groups all steps of a single authentication flow.
startedAt string ISO‑8601 timestamp when the authentication started.
finishedAt string ISO‑8601 timestamp when the authentication finished (may be null if still in progress).
startTraceId string Trace identifier for the start of the flow (used for backend tracing).
resultTraceId string Trace identifier for the result stage of the flow.
authenticatedAmount number Amount that was authenticated (in authenticatedCurrency).
authenticatedCurrency string ISO‑4217 currency code of the authenticated amount.
cardId integer CMS card identifier used for the authentication.
merchantName string Human‑readable name of the merchant.
merchantCountry string ISO‑3166‑1 alpha‑2 country code of the merchant.
authcoreRefusal boolean true if the Authcore service refused the authentication.
result3DS string 3‑DS outcome (SUCCESS, FAIL, ERROR, TIMEOUT).
duration string Human‑readable duration of the authentication (e.g., “1 minutes 52 seconds”).
authenticatedDirection string Transaction direction (DEBIT or CREDIT).
500 - Internal error

Status Code: 500 Internal error 

{
"timestamp": "2025-07-22T13:09:02.348+02:00",
"status": 500,
"error": "Internal Server Error",
"path": "/cms/v1/trancore/authentications"
}