---
title: "Estimate network fees"
method: POST
path: "/api/v1/network/fees"
tags: ["network"]
---

# Estimate network fees

`POST /api/v1/network/fees`

Given a HAPI transaction, estimate the network fees in tinycents.

## Query parameters

- `mode` 'INTRINSIC' | 'STATE' — Estimate solely based on the transaction's inherent properties or use network state.

## Response `200`

OK

- FeeEstimateResponse — The response containing the estimated transaction fees.
  - `network` FeeEstimateNetwork, required — The network fee component which covers the cost of gossip, consensus, signature verifications, fee payment, and storage.
    - `multiplier` integer, required — Multiplied by the node fee to determine the total network fee.
    - `subtotal` integer, required — The subtotal in tinycents for the network fee component which is calculated by multiplying the node subtotal by the network multiplier.
  - `node` object, required — The node fee component which is to be paid to the node that submitted the transaction to the network. This fee exists to compensate the node for the work it performed to pre-check the transaction before submitting it, and incentivizes the node to accept new transactions from users.
    - `base` integer, required — The base fee price, in tinycents.
    - `extras` FeeExtra[], required — The extra fees that apply for this fee component.
      - `charged` integer, required — The charged count of items as calculated by `max(0, count - included)`.
      - `count` integer, required — The actual count of items received.
      - `fee_per_unit` integer, required — The fee price per unit in tinycents.
      - `included` integer, required — The count of this "extra" that is included for free.
      - `name` string, required — The unique name of this extra fee as defined in the fee schedule.
      - `subtotal` integer, required — The subtotal in tinycents for this extra fee. Calculated by multiplying the charged count by the fee_per_unit.
  - `notes` string[], required — An array of strings for any caveats.
  - `service` object, required — The service fee component which covers execution costs, state saved in the Merkle tree, and additional costs to the blockchain storage.
    - `base` integer, required — The base fee price, in tinycents.
    - `extras` FeeExtra[], required — The extra fees that apply for this fee component.
      - `charged` integer, required — The charged count of items as calculated by `max(0, count - included)`.
      - `count` integer, required — The actual count of items received.
      - `fee_per_unit` integer, required — The fee price per unit in tinycents.
      - `included` integer, required — The count of this "extra" that is included for free.
      - `name` string, required — The unique name of this extra fee as defined in the fee schedule.
      - `subtotal` integer, required — The subtotal in tinycents for this extra fee. Calculated by multiplying the charged count by the fee_per_unit.
  - `total` integer, required — The sum of the network, node, and service subtotals in tinycents.

## Other responses

- `400` — Invalid parameter
- `500` — Service Unavailable

## Changes

- **2025-12-10** (v1) `edb39f55f74d` — 1 info
  - endpoint added
- **2025-08-08** (v1) `db389f03b097` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/changes/api/v1/network/fees/post.md)

---

[API](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hiero-ledger/mirror-node-rest-api/revisions/69933cd62c21/schema)