---
title: "Get internal transactions by contract address"
method: GET
path: "/v1/contracts/{contractAddress}/internal-transactions"
---

# Get internal transactions by contract address

`GET /v1/contracts/{contractAddress}/internal-transactions`

## Path parameters

- `contractAddress` string, required

## Query parameters

- `only_confirmed` boolean
- `only_unconfirmed` boolean
- `limit` integer
- `fingerprint` string
- `min_timestamp` string, date
- `max_timestamp` string, date
- `order_by` string

## Response `200`

200

- object
  - `data` object[]
    - `internal_tx_id` string — The unique identifier (ID) for the internal transaction.
    - `data` object
      - `note` string — The type of instruction, such as `call`, `create`, `suicide`, `freezeBalanceV2ForEnergy`, `freezeBalanceV2ForBandwidth`, or `unfreezeBalanceV2ForBandwidth`.
      - `rejected` boolean — Whether the internal transaction failed during execution. `true` means the execution failed.
      - `call_value` object[] — Transfer amounts.
        - `call_value` integer — Transfer amount. (Unit: sun)
        - `token_id` string — Token ID. `_` denotes TRX (decimals 6); otherwise a TRC-10 token ID.
    - `block_timestamp` integer — The Unix timestamp for when the transaction was confirmed. (Unit: millisecond)
    - `to_address` string — The recipient's address.
    - `tx_id` string — The unique identifier (ID) of the parent transaction that initiated this internal transaction.
    - `from_address` string — The sender's address. (Format: Hex, starts with `41`.)
  - `success` boolean — Whether the request was successful.
  - `meta` object
    - `at` integer — The timestamp for when the API response was generated. (Unit: millisecond)
    - `page_size` integer — The number of items returned on the current page.
    - `fingerprint` string — A fingerprint of the last transaction on this page, used to fetch the next page of results.
    - `links` object
      - `next` string — The complete URL to request the next page of results. `null` if this is the last page.

## Other responses

- `400` — 400

---

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