> ## Documentation Index > Fetch the complete documentation index at: https://docs.canton.network/llms.txt > Use this file to discover all available pages before exploring further. # GetUpdateById

com.daml.ledger.api.v2

GetUpdateById

gRPC Since 3.4.4
RPC /com.daml.ledger.api.v2.UpdateService/GetUpdateById
## Protocol Details
Protocol
gRPC
Service
UpdateService
RPC
GetUpdateById
Client stream
No
Server stream
No
## Inputs

GetUpdateByIdRequest

Message
com.daml.ledger.api.v2.GetUpdateByIdRequest
Client stream
No
update\_id string
update\_format UpdateFormat
## Outputs

GetUpdateResponse

Message
com.daml.ledger.api.v2.GetUpdateResponse
Server stream
No
transaction Transaction
reassignment Reassignment
topology\_transaction TopologyTransaction
## Lifecycle Changes
3.4.4 introduced
## Related Schemas
update\_id string
update\_format UpdateFormat
include\_transactions TransactionFormat
include\_reassignments EventFormat
include\_topology\_events TopologyFormat
event\_format EventFormat
transaction\_shape TransactionShape
filters\_by\_party repeated map
filters\_for\_any\_party Filters
verbose bool
cumulative repeated CumulativeFilter
wildcard\_filter WildcardFilter
interface\_filter InterfaceFilter
template\_filter TemplateFilter
include\_created\_event\_blob bool
interface\_id Identifier
include\_interface\_view bool
include\_created\_event\_blob bool
package\_id string
module\_name string
entity\_name string
template\_id Identifier
include\_created\_event\_blob bool
  • TRANSACTION\_SHAPE\_UNSPECIFIED
  • TRANSACTION\_SHAPE\_ACS\_DELTA
  • TRANSACTION\_SHAPE\_LEDGER\_EFFECTS
include\_participant\_authorization\_events ParticipantAuthorizationTopologyFormat
parties repeated string
transaction Transaction
reassignment Reassignment
topology\_transaction TopologyTransaction
update\_id string
command\_id string
workflow\_id string
effective\_at Timestamp
events repeated Event
offset int64
synchronizer\_id string
trace\_context TraceContext
record\_time Timestamp
external\_transaction\_hash bytes
paid\_traffic\_cost int64
created CreatedEvent
archived ArchivedEvent
exercised ExercisedEvent
offset int64
node\_id int32
contract\_id string
template\_id Identifier
contract\_key Value
contract\_key\_hash bytes
create\_arguments Record
created\_event\_blob bytes
interface\_views repeated InterfaceView
witness\_parties repeated string
signatories repeated string
observers repeated string
created\_at Timestamp
package\_name string
acs\_delta bool
representative\_package\_id string
unit Empty
bool bool
int64 sint64
date int32
timestamp sfixed64
numeric string
party string
text string
contract\_id string
optional Optional
list List
text\_map TextMap
gen\_map GenMap
record Record
variant Variant
enum Enum
value Value
elements repeated Value
entries repeated Entry
key string
value Value
entries repeated Entry
key Value
value Value
record\_id Identifier
fields repeated RecordField
label string
value Value
variant\_id Identifier
constructor string
value Value
enum\_id Identifier
constructor string
interface\_id Identifier
view\_status Status
view\_value Record
implementation\_package\_id string
offset int64
node\_id int32
contract\_id string
template\_id Identifier
witness\_parties repeated string
package\_name string
implemented\_interfaces repeated Identifier
offset int64
node\_id int32
contract\_id string
template\_id Identifier
interface\_id Identifier
choice string
choice\_argument Value
acting\_parties repeated string
consuming bool
witness\_parties repeated string
last\_descendant\_node\_id int32
exercise\_result Value
package\_name string
implemented\_interfaces repeated Identifier
acs\_delta bool
traceparent string
tracestate string
update\_id string
command\_id string
workflow\_id string
offset int64
events repeated ReassignmentEvent
trace\_context TraceContext
record\_time Timestamp
synchronizer\_id string
paid\_traffic\_cost int64
unassigned UnassignedEvent
assigned AssignedEvent
reassignment\_id string
contract\_id string
template\_id Identifier
source string
target string
submitter string
reassignment\_counter uint64
assignment\_exclusivity Timestamp
witness\_parties repeated string
package\_name string
offset int64
node\_id int32
source string
target string
reassignment\_id string
submitter string
reassignment\_counter uint64
created\_event CreatedEvent
update\_id string
offset int64
synchronizer\_id string
record\_time Timestamp
events repeated TopologyEvent
trace\_context TraceContext
participant\_authorization\_changed ParticipantAuthorizationChanged
participant\_authorization\_revoked ParticipantAuthorizationRevoked
participant\_authorization\_added ParticipantAuthorizationAdded
participant\_authorization\_onboarding ParticipantAuthorizationOnboarding
party\_id string
participant\_id string
participant\_permission ParticipantPermission
  • PARTICIPANT\_PERMISSION\_UNSPECIFIED
  • PARTICIPANT\_PERMISSION\_SUBMISSION
  • PARTICIPANT\_PERMISSION\_CONFIRMATION
  • PARTICIPANT\_PERMISSION\_OBSERVATION
party\_id string
participant\_id string
party\_id string
participant\_id string
participant\_permission ParticipantPermission
party\_id string
participant\_id string
participant\_permission ParticipantPermission
grpcurl
```bash grpcurl theme={"theme":{"light":"github-light","dark":"github-dark"}} # Add -plaintext if the server is not using TLS. grpcurl \ -d @ \ \ com.daml.ledger.api.v2.UpdateService/GetUpdateById <<'EOF' { "updateId": "string", "updateFormat": { "includeTransactions": { "eventFormat": { "filtersByParty": [ { "key": {} } ], "filtersForAnyParty": {}, "verbose": true }, "transactionShape": "TRANSACTION_SHAPE_UNSPECIFIED" }, "includeReassignments": { "filtersByParty": [ { "key": { "cumulative": [ {} ] } } ], "filtersForAnyParty": { "cumulative": [ {} ] }, "verbose": true }, "includeTopologyEvents": { "includeParticipantAuthorizationEvents": { "parties": [ "string" ] } } } } EOF ```
OK application/json
```json OK theme={"theme":{"light":"github-light","dark":"github-dark"}} { "transaction": { "updateId": "string", "commandId": "string", "workflowId": "string", "effectiveAt": "string", "events": [ { "created": { "offset": "0", "nodeId": 0, "contractId": "string", "templateId": {}, "contractKey": {}, "contractKeyHash": "BASE64_ENCODED_BYTES", "createArguments": {}, "createdEventBlob": "BASE64_ENCODED_BYTES" } } ], "offset": "0", "synchronizerId": "string", "traceContext": { "traceparent": "string", "tracestate": "string" } } } ```