---
title: "List transactions"
method: GET
path: "/list"
tags: ["Accounts"]
---

# List transactions

`GET /list`

List every appearance of an address anywhere on the chain. Corresponds to the <a href="/chifra/accounts/#chifra-list">chifra list</a> command line.

## Query parameters

- `addrs` string[], required
- `count` boolean
- `noZero` boolean
- `bounds` boolean
- `unripe` boolean
- `silent` boolean
- `firstRecord` number
- `maxRecords` number
- `reversed` boolean
- `firstBlock` number
- `lastBlock` number
- `chain` string
- `noHeader` boolean
- `fmt` string

## Response `200`

returns the requested data

- object
  - `data` union[] — Produces <a href="/data-model/accounts/#appearance">Appearance</a>, <a href="/data-model/accounts/#bounds">Bounds</a> or <a href="/data-model/accounts/#monitor">Monitor</a> data. Corresponds to the <a href="/chifra/accounts/#chifra-list">chifra list</a> command line.
    - union
      - Appearance — an appearance (`<blockNumber,transactionIndex>`) of an address anywhere on the chain (note that in some cases, not all fields will appear depending on the command)
        - `address` string, address — the address of the appearance
        - `blockNumber` number — the number of the block
        - `transactionIndex` number — the index of the transaction in the block
        - `traceIndex` number — the zero-based index of the trace in the transaction
        - `reason` string, string — the location in the data where the appearance was found
        - `timestamp` number — the timestamp for this appearance
        - `date` string, datetime — the timestamp as a date (calculated)
      - Bounds — show first block and last block an address appears in along with timestamps and dates
        - `count` number — the number of appearances for this address
        - `firstApp` object — the block number and transaction id of the first appearance of this address
        - `firstTs` number — the timestamp of the first appearance of this address
        - `firstDate` string, datetime — the first appearance timestamp as a date (calculated)
        - `latestApp` object — the block number and transaction id of the latest appearance of this address
        - `latestTs` number — the timestamp of the latest appearance of this address
        - `latestDate` string, datetime — the latest appearance timestamp as a date (calculated)
      - Monitor — a local file indicating a user's interest in an address. Includes caches for reconicilations, transactions, and appearances as well as an optional association to named account
        - `address` string, address — the address of this monitor
        - `name` string, string — the name of this monitor (if any)
        - `nRecords` number — the number of appearances for this monitor
        - `fileSize` number — the size of this monitor on disc
        - `lastScanned` number — the last scanned block number
        - `isEmpty` boolean — `true` if the monitor has no appearances, `false` otherwise
        - `isStaged` boolean — `true` if the monitor file in on the stage, `false` otherwise
        - `deleted` boolean — `true` if this monitor has been deleted, `false` otherwise

## Other responses

- `400` — bad input parameter

## Changes

- **2024-12-17** `2428f6f19a07` — 3 info
  - added the optional property `data/items/oneOf[#/components/schemas/monitor]/isEmpty` to the response with the `200` status
  - added the optional property `data/items/oneOf[#/components/schemas/monitor]/isStaged` to the response with the `200` status
  - added the optional property `data/items/oneOf[#/components/schemas/monitor]/name` to the response with the `200` status
- **2024-05-23** `dc48e08fde74` — 1 info
  - removed `#/components/schemas/appearanceCount` from the `data/items/` response property `oneOf` list for the response status `200`
- **2024-05-07** `e72d52cc70e1` — 2 breaking, 14 info
  - the `data/items/oneOf[#/components/schemas/bounds]/firstApp/items/` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `data/items/oneOf[#/components/schemas/bounds]/latestApp/items/` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - added the optional property `data/items/oneOf[#/components/schemas/bounds]/firstApp/items/address` to the response with the `200` status
  - added the optional property `data/items/oneOf[#/components/schemas/bounds]/firstApp/items/blockNumber` to the response with the `200` status
  - …12 more
- …earlier changes not shown

[Full history](https://skmtc.dev/trueblocks/apis/trueblocks-api/changes/list/get.md)

---

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