Skip to main content

GET /extended/v3/transactions/batch - Stacks REST API V3

Returns summaries for up to 20 mined transactions in canonical chain order, newest first. Unknown, non-canonical, and pending transactions are omitted.

Updated on
Nov 12, 2026

Query Parameters

tx_id
string
REQUIRED

Transaction IDs, either comma-separated or supplied as repeated tx_id query parameters. Supply between 1 and 20 IDs.

Returns

results
array

Canonical mined transaction summaries, newest first. Unknown, non-canonical, and pending transaction IDs are omitted.

tx_id
string

Transaction ID

sender
object

Transaction sender details.

address
string

Address of the transaction initiator

nonce
integer

Nonce of the transaction initiator

sponsor
object | null

Fee sponsor details, or null when the transaction is not sponsored.

address
string

Address of the transaction initiator

nonce
integer

Nonce of the transaction initiator

fee_rate
string

Transaction fee as Integer string (64-bit unsigned integer).

block
object

Stacks block containing the transaction.

height
integer

Height of the block this transactions was associated with

hash
string

Hash of the blocked this transactions was associated with

index_hash
string

Hash of the index block this transactions was associated with

time
number

Unix timestamp (in seconds) indicating when this block was mined.

time_iso
string

Block timestamp in ISO 8601 UTC format.

tx_index
integer

Index of the transaction, indicating the order. Starts at 0 and increases with each transaction

bitcoin_block
object

Bitcoin block that anchors the Stacks block.

height
integer

Height of the anchor burn block.

time
number

Unix timestamp (in seconds) indicating when this block was mined.

time_iso
string

Block timestamp in ISO 8601 UTC format.

status
string

Status of the transaction

event_count
integer

Number of events emitted by the transaction.

type
string

Transaction type: token_transfer, smart_contract, contract_call, poison_microblock, coinbase, or tenure_change.

token_transfer
object

Present only when type is token_transfer. Token-transfer transaction details.

recipient
string

Principal that receives the transferred asset.

amount
string

Transfer amount as Integer string (64-bit unsigned integer)

memo
object

Token-transfer memo in encoded and readable forms.

hex
string

Hex-encoded Clarity value.

repr
string

Human-readable Clarity value representation.

smart_contract
object

Present only when type is smart_contract. Smart-contract deployment transaction details.

clarity_version
number

Clarity language version used by the contract.

contract_id
string

Contract identifier formatted as <principaladdress>.<contract_name>

contract_call
object

Present only when type is contract_call. Contract-call transaction details.

contract_id
string

Contract identifier formatted as <principaladdress>.<contract_name>

function_name
string

Name of the Clarity function to be invoked

coinbase
object

Present only when type is coinbase. Coinbase transaction details.

alt_recipient
string

Alternative recipient for the coinbase reward.

tenure_change
object

Present only when type is tenure_change. Mining-tenure change transaction details.

cause
string

Cause of change in mining tenure. Depending on cause, tenure can be ended or extended.

Request
Response
1
{
2
"results": [
3
{
4
"tx_id": "0xae0f20eba40465e8559628ed3e2b5e78d71cb96761e967653d87a2db28cb41e4",
5
"sender": {
6
"address": "SM37A2MMXMKEHTZ0N6N81TFF4XEA62J2ZR3NM7BW8",
7
"nonce": 25061
8
},
9
"sponsor": null,
10
"fee_rate": "16181",
11
"block": {
12
"height": 9455746,
13
"hash": "0x21413dc7fa361dfac13b33328d1d8552249999c31556c991679c73e61ee24b0c",
14
"index_hash": "0x2212a4a4fe44a451b8847f537a3f14abba5029abb285264fb5f0b2ac7a4b380c",
15
"time": 1794322912,
16
"time_iso": "2026-11-10T15:01:52.000Z",
17
"tx_index": 31
18
},
19
"bitcoin_block": {
20
"height": 975314,
21
"time": 1794322863,
22
"time_iso": "2026-11-10T15:01:03.000Z"
23
},
24
"status": "success",
25
"event_count": 3,
26
"type": "contract_call",
27
"contract_call": {
28
"contract_id": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-withdrawal",
29
"function_name": "accept-withdrawal-request"
30
}
31
},
32
{
33
"tx_id": "0x5caf4b27a8fbe1137db14fa4ee96455756349f6d8e7156dfdc626eea2e0b5098",
34
"sender": {
35
"address": "SM37A2MMXMKEHTZ0N6N81TFF4XEA62J2ZR3NM7BW8",
36
"nonce": 25060
37
},
38
"sponsor": null,
39
"fee_rate": "16181",
40
"block": {
41
"height": 9455746,
42
"hash": "0x21413dc7fa361dfac13b33328d1d8552249999c31556c991679c73e61ee24b0c",
43
"index_hash": "0x2212a4a4fe44a451b8847f537a3f14abba5029abb285264fb5f0b2ac7a4b380c",
44
"time": 1794322912,
45
"time_iso": "2026-11-10T15:01:52.000Z",
46
"tx_index": 30
47
},
48
"bitcoin_block": {
49
"height": 975314,
50
"time": 1794322863,
51
"time_iso": "2026-11-10T15:01:03.000Z"
52
},
53
"status": "success",
54
"event_count": 3,
55
"type": "contract_call",
56
"contract_call": {
57
"contract_id": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-withdrawal",
58
"function_name": "accept-withdrawal-request"
59
}
60
}
61
]
62
}
1
{
2
"results": [
3
{
4
"tx_id": "0xae0f20eba40465e8559628ed3e2b5e78d71cb96761e967653d87a2db28cb41e4",
5
"sender": {
6
"address": "SM37A2MMXMKEHTZ0N6N81TFF4XEA62J2ZR3NM7BW8",
7
"nonce": 25061
8
},
9
"sponsor": null,
10
"fee_rate": "16181",
11
"block": {
12
"height": 9455746,
13
"hash": "0x21413dc7fa361dfac13b33328d1d8552249999c31556c991679c73e61ee24b0c",
14
"index_hash": "0x2212a4a4fe44a451b8847f537a3f14abba5029abb285264fb5f0b2ac7a4b380c",
15
"time": 1794322912,
16
"time_iso": "2026-11-10T15:01:52.000Z",
17
"tx_index": 31
18
},
19
"bitcoin_block": {
20
"height": 975314,
21
"time": 1794322863,
22
"time_iso": "2026-11-10T15:01:03.000Z"
23
},
24
"status": "success",
25
"event_count": 3,
26
"type": "contract_call",
27
"contract_call": {
28
"contract_id": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-withdrawal",
29
"function_name": "accept-withdrawal-request"
30
}
31
},
32
{
33
"tx_id": "0x5caf4b27a8fbe1137db14fa4ee96455756349f6d8e7156dfdc626eea2e0b5098",
34
"sender": {
35
"address": "SM37A2MMXMKEHTZ0N6N81TFF4XEA62J2ZR3NM7BW8",
36
"nonce": 25060
37
},
38
"sponsor": null,
39
"fee_rate": "16181",
40
"block": {
41
"height": 9455746,
42
"hash": "0x21413dc7fa361dfac13b33328d1d8552249999c31556c991679c73e61ee24b0c",
43
"index_hash": "0x2212a4a4fe44a451b8847f537a3f14abba5029abb285264fb5f0b2ac7a4b380c",
44
"time": 1794322912,
45
"time_iso": "2026-11-10T15:01:52.000Z",
46
"tx_index": 30
47
},
48
"bitcoin_block": {
49
"height": 975314,
50
"time": 1794322863,
51
"time_iso": "2026-11-10T15:01:03.000Z"
52
},
53
"status": "success",
54
"event_count": 3,
55
"type": "contract_call",
56
"contract_call": {
57
"contract_id": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-withdrawal",
58
"function_name": "accept-withdrawal-request"
59
}
60
}
61
]
62
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free