Skip to main content

Get Transaction

Using this API, details of the available transactions can be taken.

Resource Informations

NameValue
Requires authentication?Yes
Rate limited?No

Request

Request headers

KeyValue
AuthorizationBearer token
Content-Typeapplication/jsons

HTTP request URL for SHIFT

GET https://{hostname}/auth/realms/{tenantId}/v3_user/tms/{tmsId}/result
note

This API is applicable only for SHIFT based installations.

note

API requests must be made over https. Calls made over plain http will fail.

Parameters

No parameter fields are required.

Request body

No request body fields are required.

Response

Field NameTypeDescription
messageStringMessage explains result of the API call. Refer Response status Information for details.
statusStringThe status of the API call. Refer Response status Information for details.
subSystemIntegersubSystem categorizes the type of API that has been called. Refer Subsystem details for details.
dataObjectThis denotes the User details.
idStringThis denotes the ID of the transaction.
statusStringThe status of the API call. Refer Response status Information for details.
startedAtStringThis explains the time the transaction started.
retrievalTimeoutIntegerThe time in seconds clients have to retrieve the TMS, Default: 300.
tmsTimeoutIntegerThe time in seconds that the clients have to answer to a TMS after retrieving it,Default: 600.
userIdStringThe user's ID.
astClientIdsStringAn explicit non-empty set of client IDs of the TMS is sent, Default: unset.

Sample Response

{
"message": "Retrieved tms data successfully",
"status": "OK",
"subSystem": 2,
"data": {
"info": {
"id": "01GQFRE72GZYXTFJ10W4C9Y8YP",
"status": "ACCEPTED",
"startedAt": "2023*01*23T16:47:31.9209Z",
"retrievedAt": "2023*01*23T16:47:32.368051Z",
"completedAt": "2023*01*23T16:47:34.054639Z",
"retrievalTimeout": 50,
"tmsTimeout": 50,
"userId": "5b86b055*6644*4149*963d*01e5dd2072b6",
"astClientIds": [
"01GQFDATADK13BV8RCM1ZV2BMT"
]
},
"signedData": "MIAGCSqGSIb3DQEHAqCAMIACAQExDTALBglghkgBZQMEAgEwFwYJKoZIhvcNAQcBoAoECHRlc3QgVE1ToIAwggMrMIRQr/m4TLmntmHNJQr2rKX8hY5mtKJsVMfJfU1KUAzgNLqzxIUmUY+FRSoOxum7KhKLXd27azQ5AAAAAAAA",
"completedBy": "01GQFDATADK13BV8RCM1ZV2BMT"
}
}

Response Status Information

Status CodeStatusMessage
200OKRetrieved tms data successfully
401UnauthorizedHTTP 401 Unauthorized
404NOT FOUNDTMS Result Not found