Skip to main content
GET
/
public
/
v1
/
account
/
{accountSlug}
/
project
/
{projectSlug}
/
environments
/
{environmentId}
/
instance
/
{instanceId}
/
transactions
Get Environment Instance Transactions
curl --request GET \
  --url https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/transactions \
  --header 'X-Access-Key: <api-key>'
[
  {
    "id": "a3235752-0f5a-4d32-8e43-e7629a9f7462",
    "vnet_id": "d6cf4c06-24c3-4841-9a85-e77ed341d8e2",
    "origin": "rpc",
    "category": "write",
    "kind": "cheatcode",
    "status": "success",
    "error_reason": null,
    "reverted": false,
    "rpc_method": "hardhat_mine",
    "created_at": "2024-04-19T12:21:48.373698Z",
    "dashboard_url": "https://dashboard.tenderly.co/transactions/a3235752-0f5a-4d32-8e43-e7629a9f7462",
    "block_number": "0x12c5113",
    "block_hash": "0xe28d8b295d236f85db34dc12982f5235e361101a26cf35f4be798fb000997194",
    "tx_hash": "0x0288ab91522c19cd1589eb73b86f4b874c52ed39cdce1ba7cef790f314c4523f",
    "tx_index": "0x0",
    "from": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
    "to": "0x6c8b8870c415f3b2d5fe0cd61e9c6960bad8e0c9",
    "input": "0x071e9503000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000a",
    "nonce": "0x15",
    "value": "0x0",
    "gas": "0xc0dec0de",
    "gas_price": "0x0",
    "max_priority_fee_per_gas": "0x0",
    "max_fee_per_gas": "0x0",
    "type": "0x0",
    "function_name": "mint"
  }
]

Authorizations

​
X-Access-Key
string
header
required

An API key is a token that a client provides when making API calls. The key can be sent as a request header:

curl 'https://api.tenderly.co/api/v1/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/simulate' \
  -H 'X-Access-Key: ${TENDERLY_ACCESS_KEY}' \
  ...

Learn how to generate API access tokens at Tenderly Docs.

Path Parameters

​
accountSlug
string
required

Account ID or slug

​
projectSlug
string
required

Project ID or slug

​
environmentId
string<uuid>
required

Environment ID

​
instanceId
string<uuid>
required

Environment instance ID

Query Parameters

​
vnet_ids
string[]

Filter transactions by Virtual TestNet IDs (comma separated)

​
status
enum<string>[]

Transaction statuses to filter by (comma separated)

Available options:
success,
failed,
pending,
unknown
​
category
enum<string>[]

Transaction categories to filter by (comma separated)

Available options:
write,
read,
compute,
subscribe,
config,
chain_sync
​
kind
enum<string>[]

Transaction kinds to filter by (comma separated)

Available options:
simulation,
blockchain,
fixture,
cheatcode,
cheatcode_faucet,
internal,
sync,
chain_sync
​
from
string[]

Filter by sender addresses (comma separated)

​
to
string[]

Filter by recipient addresses (comma separated)

​
page
integer
default:1

Page number for pagination

Required range: x >= 1
​
per_page
integer
default:10

Number of transactions to return per page

Required range: 1 <= x <= 100

Response

A successful response.

​
id
string

Unique identifier of the transaction.

Example:

"4010f442-c4d9-407d-aba1-7276e3312998"

​
vnet_id
string

Identifier of the Virtual Testnet.

Example:

"4010f442-c4d9-407d-aba1-7276e3312998"

​
origin
enum<string>

Origin of the transaction.

Available options:
rpc,
copy,
api,
system,
dashboard,
cli,
sdk
Example:

"rpc"

​
category
enum<string>

Category of the transaction.

Available options:
write,
read,
compute,
subscribe,
config,
chain_sync
Example:

"write"

​
kind
enum<string>

Kind of transaction.

Available options:
simulation,
blockchain,
fixture,
cheatcode,
cheatcode_faucet,
internal,
sync,
chain_sync
Example:

"blockchain"

​
status
enum<string>

Status of the transaction.

Available options:
success,
failed,
pending,
unknown
Example:

"success"

​
error_reason
string | null

Reason for the error. Null if no error.

Example:

"execution reverted"

​
reverted
boolean

True if the transaction was reverted using evm_revert rpc method.

Example:

false

​
rpc_method
string

RPC method used to create the transaction.

Example:

"eth_sendTransaction"

​
created_at
string<date-time>

Timestamp when the transaction was created.

Example:

"2024-04-21T12:00:00Z"

​
dashboard_url
string

URL to the transaction in the Tenderly dashboard.

Example:

"https://dashboard.tenderly.co/transactions/4010f442-c4d9-407d-aba1-7276e3312998"

​
public_explorer_url
string

URL to the transaction in the public explorer. Only present if public explorer page is enabled.

Example:

"https://explorer.tenderly.co/transactions/4010f442-c4d9-407d-aba1-7276e3312998"

​
block_number
string

Block number of the transaction.

Example:

"0x12c50f0"

​
block_hash
string

Hash of the block containing the transaction.

Example:

"0xe28d8b295d236f85db34dc12982f5235e361101a26cf35f4be798fb000997194"

​
tx_hash
string

Hash of the transaction.

Example:

"0x0288ab91522c19cd1589eb73b86f4b874c52ed39cdce1ba7cef790f314c4523f"

​
tx_index
string

Index of the transaction within the block.

Example:

"0x0"

​
from
string

Sender address of the transaction.

Example:

"0xfa78a211f7df670338daed1f96177c9fe154fcb1"

​
to
string

Receiver address of the transaction.

Example:

"0x6c8b8870c415f3b2d5fe0cd61e9c6960bad8e0c9"

​
input
string

Input data of the transaction.

Example:

"0x805e1f53"

​
nonce
string

Nonce of the transaction.

Example:

"0x15"

​
value
string

Value of the transaction.

Example:

"0x0"

​
gas
string

Gas of the transaction.

Example:

"0x5208"

​
gas_price
string

Gas price of the transaction.

Example:

"0x3b9aca00"

​
max_priority_fee_per_gas
string

Maximum priority fee per gas of the transaction.

Example:

"0x0"

​
max_fee_per_gas
string

Maximum fee per gas of the transaction.

Example:

"0x0"

​
type
string

Type of the transaction.

Example:

"1"

​
block_overrides
block_overrides · object

Overrides for block data

Example:
{ "number": "0x124214", "time": "0x124124" }
​
function_name
string

Name of the function invoked by the transaction.

Example:

"mint"