bus

Get all accounts

Changed on

Returns all accounts.

get/bus/accounts

Request

  • The document declares no server URL.
  • Auth
    none declared

Query parameters

ownerstring

The owner of the account. This is usually the id of the worker that maintains the account.

Response

Successfully retrieved accounts

idstring

The account's ID

cleanShutdownboolean

Whether the account has been cleanly shutdown. If not, the account will require a sync with the host.

hostKeystring

The host's public key

balancestring

The account's balance as expected by the worker

driftstring

The accumulated drift between the worker's expected balance and the host's actual balance. Used to track if a host is trying to cheat the renter over time.

ownerstring

The owner of the account that manages it. This is the id of the worker that maintains the account.

requiresSyncboolean

Whether the account requires a sync with the host. This is usually the case when the host reports insufficient balance for an account that the worker still believes to be funded.

Changes

  • fede87b22e1cRevision changes
    • info

      added to the / response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

  • 922f156353c9Revision changes
    • info

      api tag bus added

    • info

      added the new optional query request parameter owner

    • info

      added the non-success response with the status