---
title: "Writes a Sidetree transaction to the underlying anchor."
method: POST
path: "/anchor/transactions"
tags: ["Anchor"]
---

# Writes a Sidetree transaction to the underlying anchor.

`POST /anchor/transactions`

## Request body

- AnchorWriteRequest — if with the given fee (derived from minimumFee) this node will exceed the spending limit as configured in the parameters.
  - `anchor_string` string — The string to be written to the anchor for this transaction.
  - `minimum_fee` string — A number representing the minimum transaction fee to be paid to write this transaction to the anchor. The actual fee is dynamically calculated and can be higher than this amount (but not lower).

## Response `200`

Success

- AnchorTransaction
  - `transaction_number` number — A monotonically increasing number (need NOT be by 1) that identifies a Sidtree transaction.
  - `transaction_time` number — The logical anchor time this transaction is anchored. Used for protocol version selection.
  - `transaction_time_hash` string — The hash associated with the transaction time.
  - `anchor_string` string — The string written to the anchor for this transaction.
  - `transaction_fee_paid` string — A number representing the fee paid for this transaction.
  - `normalized_transaction_fee` string — A number representing the normalized transaction fee used for proof-of-fee calculation.
  - `writer` string — A string representing the writer of the transaction. Used in the value time lock calculations.

## Other responses

- `400` — Bad Request * `spending_cap_per_period_reached` - If with the given fee (derived from minimumFee) this node will exceed the spending limit as configured in the parameters. * `not_enough_balace_for_write` - If the wallet configured in the parameters does not have enough balance to complete the write operation.
- `401` — Unauthorized
- `404` — Not Found
- `500` — Server Error * `normalized_fee_cannot_be_computed` - Error while computing the normalized fee.

---

[API](https://skmtc.net/decentralized-identity/apis/sidetree-rest-api.md) · [All operations](https://skmtc.net/decentralized-identity/apis/sidetree-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentralized-identity/sidetree-rest-api/versions/9a32549ab92a/schema)