# Events

Events Api

## Get events by type (v3)

> Get events by type.

```json
{"openapi":"3.1.0","info":{"title":"Supra RPC Node","version":"cde8c9d5e24a97e8c59c1656551edb25e0d59000"},"tags":[{"name":"Events","description":"Events Api"}],"servers":[{"url":"https://rpc-mainnet.supra.com","description":"RPC For Supra"},{"url":"https://rpc-mainnet1.supra.com","description":"RPC For nodeops group1"},{"url":"https://rpc-mainnet2.supra.com","description":"RPC For nodeops group2"},{"url":"https://rpc-mainnet3.supra.com","description":"RPC For nodeops group3"},{"url":"https://rpc-mainnet4.supra.com","description":"RPC For nodeops group4"},{"url":"https://rpc-mainnet5.supra.com","description":"RPC For nodeops group5"},{"url":"https://rpc-wallet-mainnet.supra.com","description":"RPC For Supra Wallet"},{"url":"https://rpc-suprascan-mainnet.supra.com","description":"RPC For suprascan"},{"url":"http://localhost:29000","description":"LocalNet"}],"paths":{"/rpc/v3/events/{event_type}":{"get":{"tags":["Events"],"summary":"Get events by type (v3)","description":"Get events by type.","operationId":"events_by_type_v3","parameters":[{"name":"start_height","in":"query","description":"Starting block height (inclusive). Optional.","required":false,"schema":{"type":"integer","format":"u-int64","minimum":0},"style":"form"},{"name":"end_height","in":"query","description":"Ending block height (exclusive). Optional.","required":false,"schema":{"type":"integer","format":"u-int64","minimum":0},"style":"form"},{"name":"limit","in":"query","description":"Maximum number of events to return. Defaults to 20, max 100.","required":false,"schema":{"type":"integer","minimum":0},"style":"form"},{"name":"start","in":"query","description":"The cursor to start the query from. Optional.\n\nDuring a paginated query, the cursor returned in the `X_SUPRA_CURSOR` response header\nshould be specified as the `start` parameter of the request for the next page.","required":false,"schema":{"type":"string"},"style":"form"},{"name":"event_type","in":"path","description":"The fully qualified name of the event struct, i.e.: `contract_address::module_name::event_struct_name`. E.g. `0x1::coin::CoinDeposit`","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of Events contained in blocks","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventsV3"}}}},"410":{"description":"All data in the requested range has been pruned and is no longer available.","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrResp"}}}}}}}},"components":{"schemas":{"EventsV3":{"type":"object","description":"Events structure for v3 API","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EventWithContext"}}}},"EventWithContext":{"type":"object","description":"Event wrapper with block height and transaction hash","required":["event","block_height","transaction_hash"],"properties":{"event":{"$ref":"#/components/schemas/Event"},"block_height":{"type":"integer","format":"u-int64","description":"The height of the block where the event was emitted","minimum":0},"transaction_hash":{"$ref":"#/components/schemas/Hash"}}},"Event":{"type":"object","description":"On-chain event.","required":["guid","sequence_number","type","data"],"properties":{"guid":{"type":"string","description":"The globally unique identifier of this event stream."},"sequence_number":{"type":"integer","format":"u-int64","minimum":0},"type":{"type":"string","description":"The `MoveType` of the event"},"data":{"description":"The JSON representation of the event"}}},"Hash":{"type":"string","description":"Hex encoded hash"},"ErrResp":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}}
```
