---
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`

## Request

- Base URL: `https://api.cert.zerohash.com`
- URL: `https://api.cert.zerohash.com/accounts/{account_id}/run_history`
- Auth: API key in header `X-SCX-API-KEY` and API key in header `X-SCX-PASSPHRASE`

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.dev/zerohash/apis/zerohash-api.md) - [All operations](https://skmtc.dev/zerohash/apis/zerohash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zerohash/apis/zerohash-api/revisions/47cf70ae701c?raw)