---
title: "Simulate mining of a block with the specified transactions and returns its content"
method: GET
path: "/v3/blocks/simulate/{block_id}"
tags: ["Blocks"]
---

# Simulate mining of a block with the specified transactions and returns its content

`GET /v3/blocks/simulate/{block_id}`

Simulate the mining of a block (no data is written in the MARF) with specified transactions and returns its content.

## Path parameters

- `block_id` string, required

## Request body

- object
  - `transactions_hex` string[]
  - `mint` object[]
    - `principal` string — Principal address receiving STX
    - `amount` integer — amount of microSTX to mint for the block simulation

## Response `200`

Content of the simulated block

- BlockReplay — unresolved $ref

## Other responses

- `400` — Bad request
- `401` — Unauthorized. Invalid or missing authentication token.
- `404` — Not found
- `500` — Internal Server Error

## Changes

- **2026-01-30** `357b3c85b150` — 1 info
  - endpoint added
- **2026-01-28** `81a26df3fb6f` — 1 breaking
  - api path removed without deprecation
- **2026-01-14** `f7f733b4a1fc` — 1 info
  - endpoint added
- **2026-01-14** `eb2153a4a3ad` — 1 breaking
  - api path removed without deprecation
- **2026-01-12** `27c324609367` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api/changes/v3/blocks/simulate/:block_id/get.md)

---

[API](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api.md) · [All operations](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stacks-network/stacks-3-0-rpc-api/revisions/bfe6e0b30f62/schema)