---
title: "Submit a Transaction"
method: POST
path: "/transactions"
tags: ["Transactions"]
---

# Submit a Transaction

`POST /transactions`

Send a new signed transaction payload to the network with [required transaction fields](https://docs.onflow.org/flow-go-sdk/#transactions).

## Request body

- TransactionsBody
  - `script` string, base64, required — Base64 encoded content of the Cadence script.
  - `arguments` string[], required — A list of arguments each encoded as Base64 passed in the [JSON-Cadence interchange format](https://docs.onflow.org/cadence/json-cadence-spec/).
  - `reference_block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
  - `gas_limit` string, uint64, required — The limit on the amount of computation a transaction is allowed to preform.
  - `payer` string, hexadecimal, required — The 8-byte address of an account.
  - `proposal_key` ProposalKey, required
    - `address` string, hexadecimal, required — The 8-byte address of an account.
    - `key_index` string, uint64, required
    - `sequence_number` string, uint64, required
  - `authorizers` Address[], required
  - `payload_signatures` TransactionSignature[], required — A list of Base64 encoded signatures.
    - `address` string, hexadecimal, required — The 8-byte address of an account.
    - `key_index` string, uint64, required
    - `signature` string, byte, required — A variable length signature.
  - `envelope_signatures` TransactionSignature[], required — A list of Base64 encoded signatures.
    - `address` string, hexadecimal, required — The 8-byte address of an account.
    - `key_index` string, uint64, required
    - `signature` string, byte, required — A variable length signature.

## Response `201`

Created

- Transaction
  - `id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
  - `script` string, base64, required — Base64 encoded Cadence script.
  - `arguments` string[], required — Array of Base64 encoded arguments with in [JSON-Cadence interchange format](https://docs.onflow.org/cadence/json-cadence-spec/).
  - `reference_block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
  - `gas_limit` string, uint64, required — The limit on the amount of computation a transaction is allowed to preform.
  - `payer` string, hexadecimal, required — The 8-byte address of an account.
  - `proposal_key` ProposalKey, required
    - `address` string, hexadecimal, required — The 8-byte address of an account.
    - `key_index` string, uint64, required
    - `sequence_number` string, uint64, required
  - `authorizers` Address[], required
  - `payload_signatures` TransactionSignature[], required
    - `address` string, hexadecimal, required — The 8-byte address of an account.
    - `key_index` string, uint64, required
    - `signature` string, byte, required — A variable length signature.
  - `envelope_signatures` TransactionSignature[], required
    - `address` string, hexadecimal, required — The 8-byte address of an account.
    - `key_index` string, uint64, required
    - `signature` string, byte, required — A variable length signature.
  - `result` TransactionResult
    - `block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
    - `collection_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
    - `execution` 'Pending' | 'Success' | 'Failure' — This value indicates whether the transaction execution succeded or not, this value should be checked when determining transaction success.
    - `status` 'Pending' | 'Finalized' | 'Executed' | 'Sealed' | 'Expired', required — This value indicates the state of the transaction execution. Only sealed and expired are final and immutable states.
    - `status_code` integer, required
    - `error_message` string, required — Provided transaction error in case the transaction wasn't successful.
    - `computation_used` string, uint64, required
    - `events` Event[], required
      - `type` string, required — The qualified event type.
      - `transaction_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `transaction_index` string, uint64, required
      - `event_index` string, uint64, required
      - `payload` string, byte, required
    - `metadata` Metadata — Contains data about the node's state at the time of the request.
      - `executor_metadata` ExecutorMetadata — Contains data about the execution result used to serve the request.
        - `execution_result_id` string, hexadecimal — A 32-byte unique identifier for an entity.
        - `executor_ids` Identifier[]
    - `_links` Links
      - `_self` string
  - `_expandable` TransactionExpandable, required
    - `result` string, uri
  - `_links` Links
    - `_self` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

## Changes

> 50 revisions in range; 1 could not be searched.

- **2025-09-22** `ef376ce0d11f` — 1 info
  - added the optional property `result/metadata` to the response with the `201` status
- **2025-09-18** `04fb304815f2` — 1 warning
  - removed the optional property `result/metadata` from the response with the `201` status
- **2025-08-07** `f20439279859` — 1 warning, 1 info
  - removed the optional property `result/executor_metadata` from the response with the `201` status
  - added the optional property `result/metadata` to the response with the `201` status
- **2025-08-06** `ebfa18ff435c` — 1 warning, 1 info
  - removed the optional property `result/execution_metadata` from the response with the `201` status
  - added the optional property `result/executor_metadata` to the response with the `201` status
- **2025-08-06** `2136706a5203` — 1 info
  - added the optional property `result/execution_metadata` to the response with the `201` status

[Full history](https://skmtc.dev/onflow/apis/access-api/changes/transactions/post.md)

---

[API](https://skmtc.dev/onflow/apis/access-api.md) · [All operations](https://skmtc.dev/onflow/apis/access-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/onflow/access-api/revisions/fd121c1fddf8/schema)