---
title: "Refresh balances for the workspace"
method: POST
path: "/v2/accounts/refresh"
tags: ["Accounts"]
---

# Refresh balances for the workspace

`POST /v2/accounts/refresh`

Synchronously refreshes balances for every account in the caller workspace — connection-backed (Wise/Kraken/Safe/etc.) and standalone on-chain wallets alike — and persists them.

## Response `200`

- RefreshAccountsResponseDto
  - `refreshed` number, required — Number of accounts whose balances were refreshed.
  - `failed` number, required — Number of accounts whose balance refresh failed (e.g. provider error).
  - `failures` RefreshAccountFailureDto[], required — Per-account detail, one entry per failed account; its length always matches `failed`. Always present — an empty array when nothing failed. Additive field, so older clients that only read the counts keep working.
    - `account_id` string, required — Id of the account whose balance refresh failed.
    - `label` string, required — Human label for the account (its name, falling back to a shortened address).
    - `reason` string, required — Short, human-readable reason the refresh failed for this account.

---

[API](https://skmtc.net/range/apis/range-platform-api.md) · [All operations](https://skmtc.net/range/apis/range-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/range/range-platform-api/revisions/9926df2e476d/schema)