---
title: "Get wallet events"
method: GET
path: "/bus/wallet/events"
tags: ["bus"]
---

# Get wallet events

`GET /bus/wallet/events`

Returns all events related to the wallet.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successfully retrieved wallet events

- Event[]
  - `id` string — The event's ID
  - `index` object — Information about the block that triggered the creation of this event
    - `height` integer — The height of the block in the blockchain
    - `id` string — The ID of the block
  - `confirmations` integer — The number of blocks on top of the block that triggered the creation of this event
  - `type` 'miner' | 'foundation' | 'siafundClaim' | 'v1Transaction' | 'v1ContractResolution' | 'v2Transaction' | 'v2ContractResolution' — The type of the event
  - `data` object
  - `maturityHeight` integer — The block height at which the payout matures.
  - `timestamp` string, date-time — The time the event was created
  - `relevant` Address[]

## Other responses

- `400` — Malformed request
- `500` — Internal server error

## Changes

- **2024-12-18** `922f156353c9` — 1 breaking, 1 info
  - removed the media type `text/plain` for the response with the status `500`
  - api tag `bus` added
- **2024-12-16** `55183a7d2865` — 1 breaking, 1 warning, 1 info
  - the `items/index/allOf[#/components/schemas/ChainIndex]/id/allOf[#/components/schemas/BlockID]/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `items/index/allOf[#/components/schemas/ChainIndex]/id/allOf[#/components/schemas/BlockID]/id` from the response with the `200` status
  - added `#/components/schemas/Hash256, subschema #2` to the `items/index/allOf[#/components/schemas/ChainIndex]/id/allOf[#/components/schemas/BlockID]/` response property `allOf` list for the response status `200`
- **2024-12-16** `719a1b5e14dd` — 2 breaking, 7 warning, 2 info
  - the `items/index/allOf[#/components/schemas/ChainIndex]/height` response's property type/format changed from `integer`/`uint64` to ``/`` for status `200`
  - the `items/maturityHeight` response's property type/format changed from `integer`/`uint64` to ``/`` for status `200`
  - added the new `foundation` enum value to the `items/type` response property for the response status `200`
  - added the new `miner` enum value to the `items/type` response property for the response status `200`
  - …7 more
- **2024-12-12** `04e0339b5c24` — 1 info
  - endpoint added
- …earlier changes not shown

[Full history](https://skmtc.dev/siafoundation/apis/renterd-api/changes/bus/wallet/events/get.md)

---

[API](https://skmtc.dev/siafoundation/apis/renterd-api.md) · [All operations](https://skmtc.dev/siafoundation/apis/renterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siafoundation/renterd-api/revisions/184a3d5207da/schema)