Transactions

Transaction submission

post

Body

application/json

Request body for POST /v1/submit-transaction.

Both fields are hex-encoded BCS serializations of the respective types.

signaturestring · hexRequired

Hex-encoded BCS bytes of a [SignatureOrMultiSig].

Example: 00abcd...

transactionstring · hexRequired

Hex-encoded BCS bytes of a [VersionedTransaction].

Example: 00abcd...

witness_certificatesstring · hex[]Optional

Optional list of hex-encoded BCS bytes of [TransactionCertificate]s to use as witnesses.

Responses

200

Transaction processed. data contains one of:

• {"Success": <certificate>} — settled, certificate included
• {"IncompleteVerifierSigs": []} — awaiting verifier signatures
• {"IncompleteMultiSig": []} — awaiting multi-sig signatures

application/json

Schema for POST /v1/submit-transaction response.

dataone ofRequired

or

or

400

Invalid request or validator rejection (see error.code)

application/json

409

Nonce conflict (proxy pre-flight)

application/json

422

Invalid verifier signatures

application/json

500

Internal server error

application/json

502

Upstream validator error

application/json

post

/v1/submit-transaction

HTTPcURLJavaScriptPython

POST /v1/submit-transaction HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "signature": "00abcd...",
  "transaction": "00abcd...",
  "witness_certificates": [
    "text"
  ]
}

{
  "data": {
    "Success": {
      "envelope": {
        "signature": {
          "Signature": "text"
        },
        "transaction": {
          "Release20260319": {
            "archival": true,
            "claim": {
              "TokenTransfer": {
                "amount": "text",
                "recipient": "text",
                "token_id": "text",
                "user_data": "text"
              }
            },
            "fee_token": null,
            "network_id": "text",
            "nonce": 1,
            "sender": "text",
            "timestamp_nanos": 1
          }
        }
      },
      "signatures": [
        []
      ]
    }
  },
  "meta": {
    "timestamp": "text"
  }
}