> ## 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. # GetEventsByContractId

com.daml.ledger.api.v2

GetEventsByContractId

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

GetEventsByContractIdRequest

Message
com.daml.ledger.api.v2.GetEventsByContractIdRequest
Client stream
No
contract\_id string
event\_format EventFormat
## Outputs

GetEventsByContractIdResponse

Message
com.daml.ledger.api.v2.GetEventsByContractIdResponse
Server stream
No
created Created
archived Archived
## Lifecycle Changes
3.4.4 introduced
## Related Schemas
contract\_id string
event\_format EventFormat
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
created Created
archived Archived
created\_event CreatedEvent
synchronizer\_id string
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
archived\_event ArchivedEvent
synchronizer\_id string
offset int64
node\_id int32
contract\_id string
template\_id Identifier
witness\_parties repeated string
package\_name string
implemented\_interfaces repeated Identifier
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.EventQueryService/GetEventsByContractId <<'EOF' { "contractId": "string", "eventFormat": { "filtersByParty": [ { "key": { "cumulative": [ { "wildcardFilter": {} } ] } } ], "filtersForAnyParty": { "cumulative": [ { "wildcardFilter": {} } ] }, "verbose": true } } EOF ```
OK application/json
```json OK theme={"theme":{"light":"github-light","dark":"github-dark"}} { "created": { "createdEvent": { "offset": "0", "nodeId": 0, "contractId": "string", "templateId": { "packageId": "string", "moduleName": "string", "entityName": "string" }, "contractKey": { "unit": "string" }, "contractKeyHash": "BASE64_ENCODED_BYTES", "createArguments": { "recordId": {}, "fields": [ {} ] }, "createdEventBlob": "BASE64_ENCODED_BYTES" }, "synchronizerId": "string" }, "archived": { "archivedEvent": { "offset": "0", "nodeId": 0, "contractId": "string", "templateId": { "packageId": "string", "moduleName": "string", "entityName": "string" }, "witnessParties": [ "string" ], "packageName": "string", "implementedInterfaces": [ { "packageId": "string", "moduleName": "string", "entityName": "string" } ] }, "synchronizerId": "string" } } ```