---
title: "Retrieve transactions by their associated address"
method: POST
path: "/blockchain/transaction/byAddress"
tags: ["blockchain"]
---

# Retrieve transactions by their associated address

`POST /blockchain/transaction/byAddress`

## Query parameters

- `offset` integer
- `limit` integer

## Request body

- string

## Response `200`

transactions associated with wanted address

- object
  - `items` IndexedErgoTransaction[] — Array of transactions
    - `id` string, base16, required — Base16-encoded transaction id bytes
    - `inputs` IndexedErgoBox[], required — Transaction inputs
      - `boxId` string, base16 — Base16-encoded transaction box id bytes. Should be 32 bytes long
      - `value` integer, required — Amount of Ergo token
      - `ergoTree` string, base16, required — Base16-encoded ergo tree bytes
      - `creationHeight` integer, required — Height the output was created at
      - `assets` Asset[] — Assets list in the transaction
        - `tokenId` string, base16, required — Base16-encoded 32 byte digest
        - `amount` integer, required — Amount of the token
      - `additionalRegisters` Registers, required — Ergo box registers
      - `transactionId` string, base16 — Base16-encoded transaction id bytes
      - `index` integer — Index in the transaction outputs
      - `address` string, required — Encoded Ergo Address
      - `spentTransactionId` string, base16, required — Base16-encoded 32 byte modifier id
      - `spendingHeight` integer, nullable, required — The height the box was spent at
      - `inclusionHeight` integer, required — The height the transaction containing the box was included in a block at
      - `globalIndex` integer, required — Global index of the output in the blockchain
    - `dataInputs` ErgoTransactionDataInput[], required — Transaction data inputs
      - `boxId` string, base16, required — Base16-encoded transaction box id bytes. Should be 32 bytes long
    - `outputs` IndexedErgoBox[], required — Transaction outputs
      - `boxId` string, base16 — Base16-encoded transaction box id bytes. Should be 32 bytes long
      - `value` integer, required — Amount of Ergo token
      - `ergoTree` string, base16, required — Base16-encoded ergo tree bytes
      - `creationHeight` integer, required — Height the output was created at
      - `assets` Asset[] — Assets list in the transaction
        - `tokenId` string, base16, required — Base16-encoded 32 byte digest
        - `amount` integer, required — Amount of the token
      - `additionalRegisters` Registers, required — Ergo box registers
      - `transactionId` string, base16 — Base16-encoded transaction id bytes
      - `index` integer — Index in the transaction outputs
      - `address` string, required — Encoded Ergo Address
      - `spentTransactionId` string, base16, required — Base16-encoded 32 byte modifier id
      - `spendingHeight` integer, nullable, required — The height the box was spent at
      - `inclusionHeight` integer, required — The height the transaction containing the box was included in a block at
      - `globalIndex` integer, required — Global index of the output in the blockchain
    - `inclusionHeight` integer, required — Height of a block the transaction was included in
    - `numConfirmations` integer, required — Number of transaction confirmations
    - `blockId` string, base16, required — Base16-encoded 32 byte modifier id
    - `timestamp` integer, required — Basic timestamp definition
    - `index` integer, required — index of the transaction in the block it was included in
    - `globalIndex` integer, required — Global index of the transaction in the blockchain
    - `size` integer, required — Size in bytes
  - `total` integer — Total count of retrieved transactions

## Other responses

- `404` — No transactions found for wanted address
- `default` — Error

## Changes

- **2024-08-01** `fb8d02ee5bf6` — 8 breaking, 4 warning, 2 info
  - the `items/items/inputs/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `items/items/outputs/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `items/items/inputs/items/boxId` from the response with the `200` status
  - removed the required property `items/items/inputs/items/spendingProof` from the response with the `200` status
  - …10 more

[Change history](https://skmtc.dev/ergoplatform/apis/ergo-node-api/changes/blockchain/transaction/byAddress/post.md)

---

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