RAradixdlt
Transaction

Get Transaction Status

Changed on

Returns overall transaction status and all of its known payloads based on supplied intent hash.

post/transaction/status

Request

  • Base URL
    https://mainnet.radixdlt.com
  • URL
    https://mainnet.radixdlt.com/transaction/status
  • Auth
    none declared

Request body

intent_hashstring required

Bech32m-encoded hash.

Example request

{
  "intent_hash": "<transaction-intent-hash>"
}

Response

Transaction Status

status'Unknown' | 'CommittedSuccess' | 'CommittedFailure' | 'Pending' | 'Rejected' required

A top-level intent status, left in for backwards compatibility. It doesn't give much information. Rejected means PermanentRejection.

intent_status'Unknown' | 'CommittedSuccess' | 'CommittedFailure' | 'CommitPendingOutcomeUnknown' | 'PermanentlyRejected' | 'LikelyButNotCertainRejection' | 'Pending' required

A more specific intent status. See the description field for further information. Note that CommitPendingOutcomeUnknown can either result in CommittedSuccess or CommittedFailure.

intent_status_descriptionstring required

An additional description to clarify the intent status.

committed_state_versioninteger nullable

If the intent was committed, this gives the state version when this intent was committed.

permanently_rejects_at_epochinteger nullable

The epoch number at which the transaction is guaranteed to get permanently rejected by the Network due to exceeded epoch range defined when submitting transaction.

error_messagestring nullable

The most relevant error message received, due to a rejection or commit as failure. Please note that presence of an error message doesn't imply that the intent will definitely reject or fail. This could represent a temporary error (such as out of fees), or an error with a payload which doesn't end up being committed.

Example response

{
  "ledger_state": {
    "network": "<network-name>"
  }
}

Changes

  • 00c5f3bf5c21Revision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

  • 9b38b70b609aRevision changes
    • info

      added AccountLockerNotFoundError discriminator mapping keys to the response property for the response status