Skip to main content
GET
/
get-transaction-status
Check Transaction Status
curl --request GET \
  --url https://api.sandbox.brickken.com/get-transaction-status \
  --header 'x-api-key: <api-key>'
{
  "error": "<string>"
}
Retrieves the status of a transaction submitted through /send-transactions.

​
Query Parameters

  • hash (optional): On-chain transaction hash returned after the transaction is sent. Use the exact hash value starting with 0x.
  • txId (optional): Internal transaction ID returned by /prepare-transactions. Use this when the on-chain transaction hash is not available yet.
At least one of hash or txId is required. Do not include --data in the request, because this endpoint only accepts GET.

​
Example

curl --location --request GET 'https://api.sandbox.brickken.com/get-transaction-status?hash=0x46f7114878c49ad5af0f1e6f0a2ce9c700c1fdf36455fd956b20f492ee813e80' \
  --header 'x-api-key: YOUR_API_KEY'

​
Response

{
  "status": "success"
}
If the transaction failed, the response includes the stored error: 
{
  "status": "rejected",
  "error": "Transaction failed"
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
hash
string

On-chain transaction hash returned after the transaction is sent. Use the exact value starting with 0x.

​
txId
string

Internal transaction ID returned by /prepare-transactions. Use this when the on-chain transaction hash is not available yet.

Response

200 - application/json

Successful response

​
status
enum<string>

Transaction status.

Available options:
pending,
success,
rejected
​
error
string

Stored error message when the transaction failed.