curl --request GET \
--url https://api.sandbox.brickken.com/get-transaction-status \
--header 'x-api-key: <api-key>'import requests
url = "https://api.sandbox.brickken.com/get-transaction-status"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.sandbox.brickken.com/get-transaction-status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.brickken.com/get-transaction-status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.brickken.com/get-transaction-status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sandbox.brickken.com/get-transaction-status")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.brickken.com/get-transaction-status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "pending",
"transactionHash": "<string>",
"error": "<string>",
"paymentStatus": "<string>",
"settlementTransaction": "<string>",
"paymentError": "<string>"
}Get Transaction Status
Description: This endpoint retrieves the status of a transaction submitted through /send-transactions.
Headers:
x-api-key:YOUR_API_KEY
Query Parameters:
hash(string, optional): On-chain transaction hash returned after the transaction is sent. Use the exact hash value starting with0x.txId(string, 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 send a request body, because this endpoint only accepts GET.
curl --request GET \
--url https://api.sandbox.brickken.com/get-transaction-status \
--header 'x-api-key: <api-key>'import requests
url = "https://api.sandbox.brickken.com/get-transaction-status"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.sandbox.brickken.com/get-transaction-status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.brickken.com/get-transaction-status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.brickken.com/get-transaction-status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sandbox.brickken.com/get-transaction-status")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.brickken.com/get-transaction-status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "pending",
"transactionHash": "<string>",
"error": "<string>",
"paymentStatus": "<string>",
"settlementTransaction": "<string>",
"paymentError": "<string>"
}/send-transactions.
Query Parameters
hash(optional): On-chain transaction hash returned after the transaction is sent. Use the exact hash value starting with0x.txId(optional): Internal transaction ID returned by/prepare-transactions. Use this when the on-chain transaction hash is not available yet.
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",
"transactionHash": "0x46f7114878c49ad5af0f1e6f0a2ce9c700c1fdf36455fd956b20f492ee813e80"
}
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:
{
"status": "rejected",
"error": "Transaction failed"
}
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:{
"status": "success",
"transactionHash": "0x46f7114878c49ad5af0f1e6f0a2ce9c700c1fdf36455fd956b20f492ee813e80",
"paymentStatus": "settled",
"settlementTransaction": "0xae08674018f81ce617aa8b6c4d582a681b278542cf30921536b91b2162fe19fb"
}
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
Query Parameters
On-chain transaction hash returned after the transaction is sent. Use the exact value starting with 0x.
Internal transaction ID returned by /prepare-transactions. Use this when the on-chain transaction hash is not available yet.
Response
Successful response
Transaction status.
pending, success, rejected On-chain transaction hash, once Brickken has resolved it.
Stored error message when the transaction failed.
Status of the linked x402 payment. Present only for x402 transactions.
Settlement transaction of the linked x402 payment. Present only for x402 transactions.
Failure reason of the linked x402 payment. Present only for x402 transactions.