Skip to main content
The Tenderly REST API exposes endpoints for creating, listing, and managing Virtual Environments. For a walkthrough of how to call them from a script, see Create Virtual Environments via API. For the complete API surface, see the API Reference. All environment endpoints use the base URL: 
https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}

​
Authentication

All requests require an X-Access-Key header. Generate a key from Account Settings → Authorization in the Tenderly Dashboard. See API tokens. 
X-Access-Key: <your-access-key>

​
Create an environment

POST /environments
Creates a new environment with one or more networks. Both single-network and multi-network environments use this endpoint, pass one entry in network_configs for a single-network environment, or multiple entries for a multi-network one.

​
Request body

FieldTypeRequiredDescription
display_namestringyesHuman-readable name shown in the dashboard.
slugstringnoURL-safe identifier. Auto-generated from display_name if omitted.
network_configsarrayyesOne entry per network in the environment.
network_configs[].network_idstringyesChain ID of the network to fork (e.g. "1" for Ethereum).
network_configs[].block_numberstringnoFork point in hex. Defaults to the latest block.
network_configs[].chain_config_overrides.chain_idstringnoOverride the chain ID assigned to this Virtual Environment.
network_configs[].explorer_config.enabledbooleannoExpose a public explorer page.
network_configs[].explorer_config.verification_visibilitystringno"bytecode", "abi", or "source".
network_configs[].accountsarraynoPre-funded accounts. Each entry has address and balance (Wei, hex-encoded).
bridge_config.enabledbooleannoEnable cross-chain bridging between networks in this environment.
bridge_config.relay_modestringno"autoRelay" (default) or "delayedRelay".
bridge_config.delay_secondsintegernoRelay delay in seconds when using "delayedRelay".

​
Single-network example

request.json
{
  "display_name": "Staging Mainnet",
  "slug": "staging-mainnet",
  "network_configs": [
    {
      "network_id": "1",
      "block_number": "latest",
      "chain_config_overrides": { "chain_id": "73571" },
      "explorer_config": { "enabled": false, "verification_visibility": "bytecode" }
    }
  ]
}

​
Multi-network example

request.json
{
  "display_name": "Cross-chain Staging",
  "network_configs": [
    {
      "network_id": "1",
      "block_number": "latest",
      "chain_config_overrides": { "chain_id": "1" }
    },
    {
      "network_id": "42161",
      "block_number": "latest",
      "chain_config_overrides": { "chain_id": "42161" }
    },
    {
      "network_id": "8453",
      "block_number": "latest",
      "chain_config_overrides": { "chain_id": "8453" }
    }
  ],
  "bridge_config": { "enabled": true, "relay_mode": "autoRelay" }
}

​
Response

Returns the created environment object. The active_instance.vnets array contains one entry per network, each with its RPC endpoints.
response.json
{
  "id": "d998eea3-139d-4477-9de2-42f7739362f0",
  "display_name": "Staging Mainnet",
  "slug": "staging-mainnet",
  "created_at": "2026-06-08T10:00:00.000Z",
  "networks": [
    {
      "id": "a1b2c3d4-...",
      "network_id": "1",
      "network_name": "Ethereum Mainnet",
      "block_number": "0x168a5c6"
    }
  ],
  "active_instance": {
    "id": "e5f6a7b8-...",
    "vnets": [
      {
        "id": "f9e8d7c6-...",
        "display_name": "Staging Mainnet",
        "slug": "staging-mainnet",
        "status": "running",
        "rpcs": [
          { "name": "Admin RPC", "url": "https://virtual.mainnet.rpc.tenderly.co/..." },
          { "name": "Public RPC", "url": "https://virtual.mainnet.rpc.tenderly.co/..." }
        ],
        "fork_config": { "network_id": 1, "block_number": "0x168a5c6" }
      }
    ]
  }
}
The rpcs array on each entry contains the Admin RPC (full cheatcode access) and the Public RPC (standard JSON-RPC).

​
List environments

GET /environments
Returns all environments for the project.

​
Get an environment

GET /environments/{environmentId}
Returns a single environment by ID, including its active_instance and RPC endpoints.

​
Delete an environment

DELETE /environments/{environmentId}
Permanently deletes a single environment. Returns 204 No Content.

​
Batch delete environments

DELETE /environments
Permanently deletes multiple environments in one call. Pass the IDs in the request body.

​
List transactions

GET /environments/{environmentId}/instance/{instanceId}/transactions
Returns transactions across all Virtual Environments in an environment instance. Supports pagination and optional filters by status, category, kind, and from/to address.

​
Get a transaction

GET /environments/{environmentId}/instance/{instanceId}/transactions/{txHash}
Returns a single transaction from an environment instance by transaction hash.

​
Send a transaction

POST /environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions
Executes a transaction on a specific Virtual Environment within an environment instance. State is preserved.

​
Simulate a transaction

POST /environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate
Simulates a transaction without preserving state. Supports block overrides, state overrides, and a custom block number. Returns a detailed simulation result including call trace, state changes, and emitted events.

​
See also