Skip to main content
GET
Check Transaction Status
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

Response

status is pending, success, or rejected. transactionHash appears as soon as Brickken has resolved the on-chain hash, so a pending response may not include it yet. If the transaction failed, the response includes the stored error:
A confirmed newTokenization does not carry the new token contract address. Read it from GET /get-tokenizer-info as tokenAddress once the status is success.

x402 transactions

When the transaction was paid through x402, the response also carries the payment outcome:
paymentStatus is one of received, verified, settle_submitted, settled, released, failed, or replayed. settlementTransaction appears once a settlement transaction exists, and paymentError appears when the payment recorded a failure reason; either, both, or neither may be present. All three fields are omitted for API-key transactions.

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
transactionHash
string

On-chain transaction hash, once Brickken has resolved it.

error
string

Stored error message when the transaction failed.

paymentStatus
string

Status of the linked x402 payment. Present only for x402 transactions.

settlementTransaction
string

Settlement transaction of the linked x402 payment. Present only for x402 transactions.

paymentError
string

Failure reason of the linked x402 payment. Present only for x402 transactions.