---
title: "List account run history"
method: GET
path: "/accounts/{account_id}/run_history"
tags: ["Accounts"]
---

# List account run history

`GET /accounts/{account_id}/run_history`

Retrieves the history of grouped settlements, deposits, withdrawals and other changes that have been applied to an account to lead up to its current balance.

## Path parameters

- `account_id` string, required

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Successfully retrieved account run history. Returns grouped settlements, deposits, withdrawals and other changes applied to the account.

- GetRunHistoryResponse — Response schema for retrieving run history information.
  - `message` RunHistoryEntity[]
    - `run_timestamp` number — Unix timestamp in milliseconds indicating when the run was executed.
    - `run_type` 'deposit' | 'execution_fee' | 'network_fee' | 'settlement' | 'transfer' | 'withdrawal' | 'stake' | 'unstake' | 'reward_distribution' — A run is a group of movements that pertain to the same type of change to an account.
    - `run_id` string — A unique ID for the particular run.
    - `change` string — Signed decimal net change to the account balance due to all movements within the run.
    - `new_balance` string — The account balance after the run was applied.
  - `page` number
  - `total_pages` number

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/versions/8b647d934363/schema)