Get Transaction Information
/restproxy/api/v2/channels/{channelId}/transactions/{transactionId}
Get the information for a transaction, whether it's submitted or not.
On Oracle Cloud Infrastructure (Gen 2), querying asynchronous invocation proposal failures is not supported.
Request
- application/json
-
channelId: string
ID of the channel
-
transactionId: string
ID of the transaction
-
role: string
Name of Fabric enrollment to be used
Response
- application/json
200 Response
object
-
error(optional):
string
-
result(optional):
object result
-
returnCode:
string
Allowed Values:
[ "Success", "Failure" ]
object
-
encode(optional):
string
Allowed Values:
[ "UTF-8", "JSON", "base64" ]
-
message(optional):
string
-
payload(optional):
-
status:
string
Allowed Values:
[ "valid", "invalid", "not found" ]
Transaction Status -
txid:
string
Transaction ID
400 Response
401 Response
403 Response
404 Response
500 Response
Examples
This endpoint is used to get the status and other details of a transaction based on it's transaction ID.
The following example shows how to get the transaction details of your Blockchain transaction by submitting a GET request on the REST resource using cURL.
curl -v -u <username>:<password> -X GET \ "https://<restproxy of your Blockchain instance>/api/v2/channels/default/transactions/{transactionId}" \ -H "accept: application/json"
For example,
curl -v -k -u obpuser:<password> -X GET \ "https://myvm.oracle.com:10001/restproxy/api/v2/channels/default/transactions/bc5221c648533646877505288fc50b6c6100394213694bf111f7a3183074a329" \ -H "accept: application/json"
Note:
You can find the restproxy value of your Blockchain instance from the Nodes tab of your instance console.Example of the Response Body
The following example shows the contents of the response body in JSON format:
{ "returnCode": "Success", "error": "", "result": { "txid": "bc5221c648533646877505288fc50b6c6100394213694bf111f7a3183074a329", "status": "valid", "payload": 800, "encode": "JSON" } }
As this transaction was invoked to query the balance of a, the value returned for payload can be interpreted as a's balance amount.