Get transaction tree by id. Provided for backwards compatibility, it will be removed in the Canton version 3.5.0, use v2/updates/update-by-id instead.

OpenAPI Removal scheduled 3.5.0 Updated 3.5 Deprecated 3.4 Added 3.4

```bash cURL theme={null} curl --request GET \ --url 'http://localhost:7575/v2/updates/transaction-tree-by-id/{update-id}' \ --header 'Authorization: Bearer $TOKEN' ``` ```python Python theme={null} import json import requests url = "http://localhost:7575/v2/updates/transaction-tree-by-id/{update-id}" headers = {'Authorization': 'Bearer '} response = requests.request("GET", url, headers=headers) print(response.text) ``` ```javascript JavaScript theme={null} const response = await fetch('http://localhost:7575/v2/updates/transaction-tree-by-id/{update-id}', { method: 'GET', headers: { "Authorization": "Bearer " }, }); console.log(await response.text()); ``` ```php PHP theme={null} 'http://localhost:7575/v2/updates/transaction-tree-by-id/{update-id}', CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => [ "Authorization: Bearer " ], ]); $response = curl_exec($curl); echo $response; ``` ```go Go theme={null} package main import ( "fmt" "io" "net/http" ) func main() { req, _ := http.NewRequest("GET", "http://localhost:7575/v2/updates/transaction-tree-by-id/{update-id}", nil) req.Header.Set("Authorization", "Bearer ") response, _ := http.DefaultClient.Do(req) defer response.Body.Close() body, _ := io.ReadAll(response.Body) fmt.Println(string(body)) } ``` ```java Java theme={null} import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; var request = HttpRequest.newBuilder() .uri(URI.create("http://localhost:7575/v2/updates/transaction-tree-by-id/{update-id}")) .header("Authorization", "Bearer ") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); var response = HttpClient.newHttpClient().send( request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); ``` ```ruby Ruby theme={null} require 'net/http' require 'uri' uri = URI('http://localhost:7575/v2/updates/transaction-tree-by-id/{update-id}') request = Net::HTTP::Get.new(uri) request['Authorization'] = 'Bearer ' response = Net::HTTP.start(uri.hostname, uri.port) do |http| http.request(request) end puts response.body ``` ```json 200 theme={null} { "transaction": { "updateId": "", "commandId": "", "workflowId": "", "effectiveAt": "", "offset": 123, "eventsById": {}, "synchronizerId": "", "traceContext": { "traceparent": "", "tracestate": "" }, "recordTime": "" } } ``` ```text 400 theme={null} ``` ```json default theme={null} { "code": "", "cause": "", "correlationId": "", "traceId": "", "context": {}, "resources": [ [ "" ] ], "errorCategory": 123, "grpcCodeValue": 123, "retryInfo": "", "definiteAnswer": false } ``` ## Authorizations ### httpAuth HTTP bearer authentication. Send the token as `Authorization: Bearer <token>`. Ledger API standard JWT token ### apiKeyAuth API key authentication in the header. Ledger API standard JWT token (websocket) ## Path parameters ## Query parameters ## Responses ### 200

application/json

Provided for backwards compatibility, it will be removed in the Canton version 3.5.0. Complete view of an on-ledger transaction. Assigned by the server. Useful for correlating logs. Must be a valid LedgerString (as described in `value.proto`). Required The ID of the command which resulted in this transaction. Missing for everyone except the submitting party. Must be a valid LedgerString (as described in `value.proto`). Optional The workflow ID used in command submission. Only set if the `workflow_id` for the command was set. Must be a valid LedgerString (as described in `value.proto`). Optional Ledger effective time. Required The absolute offset. The details of this field are described in `community/ledger-api/README.md`. Required, it is a valid absolute offset (positive integer). Changes to the ledger that were caused by this transaction. Nodes of the transaction tree. Each key must be a valid node ID (non-negative integer). Required A valid synchronizer id. Identifies the synchronizer that synchronized the transaction. Required Optional; ledger API trace context The trace context transported in this message corresponds to the trace context supplied by the client application in a HTTP2 header of the original command submission. We typically use a header to transfer this type of information. Here we use message body, because it is used in gRPC streams which do not support per message headers. This field will be populated with the trace context contained in the original submission. If that was not provided, a unique ledger-api-server generated trace context will be used instead. [https://www.w3.org/TR/trace-context/](https://www.w3.org/TR/trace-context/) Optional Optional The time at which the transaction was recorded. The record time refers to the synchronizer which synchronized the transaction. Required ### 400 Invalid value, Invalid value for: query parameter parties

text/plain

### default

application/json

## History

Removal scheduled 3.5.0

Updated 3.5

The GET /v2/updates/transaction-tree-by-id/\{update-id} operation was updated in this snapshot.

Deprecated 3.4

Added 3.4