Skip to main content

Overview

The Hedera Mirror Node REST API enables developers to access historical transaction data from Hedera’s mainnet, testnet, and previewnet. Each transaction generates a record stored in a record file, which can be accessed via the Mirror Node REST APIs.

Making a Request

To make a request, use the network endpoint and the REST API of choice. For example, To get a list of transactions on the Hedera mainnet, use the following API endpoint:
https://mainnet.mirrornode.hedera.com/api/v1/transactions
This will return a JSON response containing transaction details such as transaction ID, timestamps, and fees. If you are using curl, you can make a request like this:
curl -X GET "https://mainnet.mirrornode.hedera.com/api/v1/transactions" -H "Accept: application/json"

Hedera Mirror Node Swagger UI Environments

Hedera provides interactive Swagger UI for its Mirror Node REST API. Developers can use these environments to explore available endpoints, check request parameters, and test API calls without writing code.

Available Environments:

NetworkSwagger UI URL
MainnetMainnet Swagger UI
TestnetTestnet Swagger UI
PreviewnetPreviewnet Swagger UI

Hedera Mirror Node Environments

Hedera provides three different network environments for interacting with the Mirror Node API.
NetworkBase URL
Mainnethttps://mainnet.mirrornode.hedera.com/
Testnethttps://testnet.mirrornode.hedera.com/
Previewnethttps://previewnet.mirrornode.hedera.com/
Each of these base URLs serves as the foundation for all API calls.

Community Providers

You may also check out these community providers as alternatives:
Public mainnet mirror node requests per second (RPS) are currently throttled at 50 per IP address. These configurations may change in the future depending on performance or security considerations. At this time, no authentication is required.