Get Node Transactions by ID

Lists transactions for the specified node with pagination.

Request

GET /v2/admin/nodes/{node_id}/transactions?page={page}&per_page={per_page}

Parameters

Name	Type	In	Description
node_id	string	path	Required. The ID of the node

Query Parameters

Name	Type	Required	Description
page	integer	No	Page number (default: 1)
per_page	integer	No	Items per page (default: 20)

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Example

curl --location '\{\{baseUrl\}\}/v2/admin/nodes/6901350deb7ed8c1c38de4e9/transactions?page=1&per_page=10' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJRCI6IjhmMzEwOWExLTYyMmMtNDVhZC1hYjI4LTg0ODE5N2ZiMDYwYSIsImV4cGlyYXRpb24iOjE3NjI5NDg5NTksInN1cGVydmlzb3JFbWFpbCI6InViZXJAYXBleC5jb20iLCJzdXBlcnZpc29ySUQiOiI2NjViMzcyZjNhNzJkN2QwNzkxNTk2YmEiLCJzdXBlcnZpc29yTm9kZUlEIjoiNjY1YWU1MzZhNjM5MmI3NWNmZDQwMzUyIiwic3VwZXJ2aXNvck5vZGVJbnRJRCI6MSwic3VwZXJ2aXNvck5vZGVQYXRoIjoiMSIsInN1cGVydmlzb3JSb2xlSUQiOiI2NjVhZTc5NjEwY2UyMTZkYmMzNWM5M2IiLCJzdXBlcnZpc29yUm9sZVByaW9yaXR5IjoxMDB9.OAK93_mbJET99ztAyvSbh2x-NY2wbR42dyaZZlPJyqs'

Response

{
    "data": [
        {
            "id": "690279bcd09741a44611889c",
            "node_id": "6901350deb7ed8c1c38de4e9",
            "user_id": "665b372f3a72d7d0791596ba",
            "reference_id": null,
            "data": {
                "address": "0xecE2c86490b1214035cb1bbcC9781aE45d29BB97",
                "amount": 90,
                "currency_token_id": "68fe8c129367fd414b227c7a"
            },
            "type": 1,
            "status": 3,
            "error": null,
            "created_at": "2025-10-29T20:31:56.485Z"
        },
        {
            "id": "69014d02bd0fb7ece2803763",
            "node_id": "6901350deb7ed8c1c38de4e9",
            "user_id": "665b372f3a72d7d0791596ba",
            "reference_id": null,
            "data": {
                "contract_address": "0x39247A80f1c0ddcEfb4986fA7A59E919E1F2Fa38"
            },
            "type": 16,
            "status": 3,
            "error": null,
            "created_at": "2025-10-28T23:08:50.414Z"
        },
        {
            "id": "6901429abd0fb7ece2803762",
            "node_id": "6901350deb7ed8c1c38de4e9",
            "user_id": "665b372f3a72d7d0791596ba",
            "reference_id": null,
            "data": {
                "contract_address": "0x709a52Dec3C716FBb4d7d8382EDD8F6e645D8b54"
            },
            "type": 18,
            "status": 3,
            "error": null,
            "created_at": "2025-10-28T22:24:26.212Z"
        },
        {
            "id": "6901415567c4db290177a44a",
            "node_id": "6901350deb7ed8c1c38de4e9",
            "user_id": "665b372f3a72d7d0791596ba",
            "reference_id": null,
            "data": null,
            "type": 16,
            "status": 4,
            "error": null,
            "created_at": "2025-10-28T22:19:01.59Z"
        },
        {
            "id": "69014127ae6e6f7e5ed951d3",
            "node_id": "6901350deb7ed8c1c38de4e9",
            "user_id": "665b372f3a72d7d0791596ba",
            "reference_id": null,
            "data": {
                "contract_address": "0x1C0777276B13c56d416c41D4186744b9ba0a0D3a"
            },
            "type": 4,
            "status": 3,
            "error": null,
            "created_at": "2025-10-28T22:18:15.21Z"
        },
        {
            "id": "690140a307b1c866f5df0d38",
            "node_id": "6901350deb7ed8c1c38de4e9",
            "user_id": "665b372f3a72d7d0791596ba",
            "reference_id": null,
            "data": {
                "contract_address": "0x0Fdf63aB85Ca5eb1404FCA1992b616D45AB34589"
            },
            "type": 3,
            "status": 3,
            "error": null,
            "created_at": "2025-10-28T22:16:03.406Z"
        },
        {
            "id": "69013f5c1b90d658a3130251",
            "node_id": "6901350deb7ed8c1c38de4e9",
            "user_id": "665b372f3a72d7d0791596ba",
            "reference_id": null,
            "data": {
                "contract_address": "0x80d60e8E2F2f0c19de948b8bc64c862119137924"
            },
            "type": 2,
            "status": 3,
            "error": null,
            "created_at": "2025-10-28T22:10:36.103Z"
        },
        {
            "id": "69013b86eb7ed8c1c38de4eb",
            "node_id": "6901350deb7ed8c1c38de4e9",
            "user_id": "665b372f3a72d7d0791596ba",
            "reference_id": null,
            "data": {
                "contract_address": "0x07CE06EF88C5b104A3632371b6E07A360Bcdb168"
            },
            "type": 7,
            "status": 3,
            "error": null,
            "created_at": "2025-10-28T21:54:14.098Z"
        }
    ],
    "total": 8,
    "page": 1,
    "per_page": 10
}

Response Fields

Field	Type	Description
data	array	List of transactions
data[].id	string	Unique transaction identifier
data[].node_id	string	ID of the node
data[].user_id	string	ID of the user who initiated the transaction
data[].reference_id	string | null	Reference ID for the transaction (null if not set)
data[].data	object | null	Transaction-specific data (structure varies by transaction type)
data[].data.address	string	Address associated with the transaction (for certain types)
data[].data.amount	number	Amount associated with the transaction (for certain types)
data[].data.currency_token_id	string	Currency token ID (for certain types)
data[].data.contract_address	string	Contract address (for certain types)
data[].type	integer	Transaction type
data[].status	integer	Transaction status
data[].error	string | null	Error message if the transaction failed (null if successful)
data[].created_at	string	ISO 8601 timestamp when the transaction was created
total	integer	Total number of transactions
page	integer	Current page number
per_page	integer	Number of items per page

Transaction Types

Authoritative list — mirrors the nodetransaction.Type enum (pkg/domain/aggregates/nodetransaction/node_transaction.go).

Type ID	Name	Description
1	WithdrawType	Withdraw native coin or currency token from node wallet
2	DeployListingContract	Deploy listing contract
3	DeployRentContract	Deploy rent contract
4	DeployBurnContract	Deploy burn contract
5	ApproveCurrencyToken	Approve currency token transfers
6	ApproveCurrencyRent	Approve currency token for rent
7	DeployFeeContract	Deploy fee contract
8	UpdateDefaultFee	Update default fee on fee contract
9	UpdateCategoryFee	Update category-scoped fee
10	UpdateDefaultPlatformOwnerFee	Update default platform-owner fee
11	UpdateCategoryPlatformOwnerFee	Update category platform-owner fee
12	UpdateDefaultNodeFee	Update default node fee
13	UpdateCategoryNodeFee	Update category node fee
14	UpdateDefaultNodeFeeByPlatformOwner	Platform-owner updates default node fee
15	UpdateCategoryNodeFeeByPlatformOwner	Platform-owner updates category node fee
16	UnsetDefaultOwnerFee	Clear default owner fee
17	UnsetCategoryOwnerFee	Clear category owner fee
18	DeploySecondaryContract	Deploy secondary-market contract
19	DeployKycTokenContract	Deploy KYC token contract
20	DeployOtcContract	Deploy OTC contract
21	SendKycToken	Send a KYC token to a member
22	UnsetDefaultPlatformOwnerFee	Clear default platform-owner fee
23	UnsetCategoryPlatformOwnerFee	Clear category platform-owner fee
24	UnsetDefaultNodeFee	Clear default node fee
25	UnsetCategoryNodeFee	Clear category node fee
26	UnsetDefaultNodeFeeByPlatformOwner	Platform-owner clears default node fee
27	UnsetCategoryNodeFeeByPlatformOwner	Platform-owner clears category node fee
28	ExportInvestorReport	Export investor report (background job)
29	DeployDiamondCutFacet	Deploy Diamond Cut facet
30	DeployDiamond	Deploy Diamond proxy
31	DeployDiamondLoupeFacet	Deploy Diamond Loupe facet
32	DeployOwnershipFacet	Deploy Ownership facet
33	ExecuteDiamondCut	Execute Diamond Cut (wires facets to the diamond)
34	SendOutsideKycToken	Send a KYC token to an outside address
35	RecallKycToken	Recall a previously-issued KYC token
36	RecallToken	Recall a token from a holder (governance / compliance)
37	ChangeKycTokenPlatformOwner	Reassign KYC token's platform owner
38	ChangeNodeOwnerAddress	Change node owner address on-chain
39	ChangePlatformOwnerAddress	Change platform owner address on-chain
40	TransferTokenizedAssetOwnership	Transfer ownership of a tokenized asset
41	CreateKycGroup	Create a KYC group
42	DeleteKycGroup	Delete a KYC group
43	AddMemberToKycGroup	Add a member to a KYC group
44	RemoveMemberFromKycGroup	Remove a member from a KYC group
45	AddMembersToKycGroup	Bulk-add members to a KYC group
46	AddMemberToWhitelist	Add a member to a token whitelist
47	AddMembersToWhitelist	Bulk-add members to a token whitelist
48	RemoveMemberFromWhitelist	Remove a member from a token whitelist
49	AddToBlacklistKyc	Add a KYC group / address to a token blacklist
50	AddMembersToBlacklist	Bulk-add members to a token blacklist
51	RemoveMemberFromBlacklist	Remove a member from a token blacklist
52	AddMemberToDistributionGroup	Add a member to a distribution group
53	RemoveMemberFromDistributionGroup	Remove a member from a distribution group
54	AddMembersToDistributionGroup	Bulk-add members to a distribution group
55	AddKycGroupTokenToWhitelist	Whitelist an entire KYC group for a token
56	RemoveKycGroupFromWhitelist	Remove a KYC group from a token whitelist
57	AddKycGroupToBlacklist	Blacklist an entire KYC group for a token
58	RemoveKycGroupFromBlacklist	Remove a KYC group from a token blacklist
59	UpdateDiamondCut	Add/replace/remove facets on the diamond
60	SendNativeToUser	Send native coin (ETH/etc.) to a user wallet

Transaction Statuses

Status ID	Name	Description
1	Started	Request queued, wallet pipeline hasn't picked it up yet
2	InProgress	Wallet is preparing / signing
3	Done	Confirmed on-chain
4	Error	Failed — see error
5	PendingReceipt	Broadcast on-chain (hash populated); the receipt-confirmation cron is still waiting for inclusion. Treat as not-yet-final

Non-completed statuses (caller should keep polling): Started, InProgress, PendingReceipt.

Status Codes

Status Code	Description
200	Success - Transactions retrieved successfully
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Node ID does not exist
500	Internal Server Error