Get send transaction status

Get the status of a send transaction request.

POST

/

public

/

v1

/

query

/

get_send_transaction_status

Authorizations

API Key

X-Stamp · string · required

Cryptographically signed (stamped) request to be passed in as a header. For more info, see here.

WebAuthn (Passkey)

X-Stamp-WebAuthn · string · required

Cryptographically signed (stamped) request to be passed in as a header. For more info, see here.

Body

organizationId · string · required

Unique identifier for a given organization.

sendTransactionStatusId · string · required

The unique identifier of a send transaction request.

Response

A successful response returns the following fields:

txStatus · string · required

The current status of the send transaction.

eth · object

eth field

Show eth details

eth.txHash

string

The Ethereum transaction hash, if available.

txError · string

The error encountered when broadcasting or confirming the transaction, if any.

error · object

error field

Show error details

error.message

string

Human-readable error message describing what went wrong.

error.revertChain

array

Chain of revert errors from nested contract calls, ordered from outermost to innermost.

Show revertChain details

error.revertChain.address

string

The contract address where the revert occurred.

error.revertChain.errorType

string

Type of error: ‘unknown’, ‘native’, or ‘custom’.

error.revertChain.displayMessage

string

Human-readable message describing this revert.

error.revertChain.unknown

object

unknown field

Show unknown details

error.revertChain.unknown.selector

string

The 4-byte error selector, if available.

error.revertChain.unknown.data

string

The raw error data, hex-encoded.

error.revertChain.native

object

native field

Show native details

error.revertChain.native.nativeType

string

The type of native error: ‘error_string’, ‘panic’, or ‘execution_reverted’.

error.revertChain.native.message

string

The error message for Error(string) reverts.

error.revertChain.native.panicCode

string

The panic code for Panic(uint256) reverts.

error.revertChain.custom

object

custom field

Show custom details

error.revertChain.custom.errorName

string

The name of the custom error.

error.revertChain.custom.paramsJson

string

The decoded parameters as a JSON object.

cURL

curl --request POST \
  --url https://api.turnkey.com/public/v1/query/get_send_transaction_status \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "organizationId": "<string>",
    "sendTransactionStatusId": "<string>"
}'

import { Turnkey } from "@turnkey/sdk-server";

const turnkeyClient = new Turnkey({
  apiBaseUrl: "https://api.turnkey.com",
  apiPublicKey: process.env.API_PUBLIC_KEY!,
  apiPrivateKey: process.env.API_PRIVATE_KEY!,
  defaultOrganizationId: process.env.ORGANIZATION_ID!,
});

const response = await turnkeyClient.apiClient().getSendTransactionStatus({
  organizationId: "<string> (Unique identifier for a given organization.)",
  sendTransactionStatusId: "<string> (The unique identifier of a send transaction request.)"
});

200

{
  "txStatus": "<string>",
  "eth": {
    "txHash": "<string>"
  },
  "txError": "<string>",
  "error": {
    "message": "<string>",
    "revertChain": [
      {
        "address": "<string>",
        "errorType": "<string>",
        "displayMessage": "<string>",
        "unknown": {
          "selector": "<string>",
          "data": "<string>"
        },
        "native": {
          "nativeType": "<string>",
          "message": "<string>",
          "panicCode": "<string>"
        },
        "custom": {
          "errorName": "<string>",
          "paramsJson": "<string>"
        }
      }
    ]
  }
}