.svg?fit=max&auto=format&n=IA3LwxdwplQ2w-t1&q=85&s=b292e78038d8c39788a4b2fa0c31ff8e)
.svg?fit=max&auto=format&n=IA3LwxdwplQ2w-t1&q=85&s=935bf5f31a64df6f5d9fed108e9fba67)
Transactions
List Transactions
Retrieve a paginated list of transactions, filtered by status, category, vault, asset, or external ID.
Request example
{
"query": {
"limit": 20,
"cursor": null,
"status": "COMPLETED",
"vaultId": "vault_123"
}
}
# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request GET \
--url "https://api.primevault.com/api/external/transactions/?limit=20&status=COMPLETED&vaultId=vault_123" \
--header "Authorization: Bearer <signed JWT>" \
--header "Api-Key: <API key>" \
--header "Accept: application/json"
getTransactions(
params?: Record<string, string>,
limit?: number,
cursor?: string | null,
): Promise<TransactionListResponse>
{
"results": [
{
"id": "transaction_123",
"orgId": "org_456",
"vaultId": "vault_123",
"status": "COMPLETED",
"transactionType": "OUTGOING",
"category": "TRANSFER",
"subCategory": "EXTERNAL_TRANSFER",
"createdAt": "2026-08-04T10:40:00Z",
"updatedAt": "2026-08-04T10:42:15Z",
"isDeleted": false,
"externalId": "invoice-1001",
"memo": "Vendor payout #1001",
"source": {
"type": "VAULT",
"id": "vault_123",
"subOrgId": "sub_org_123",
"name": "Treasury Vault"
},
"destination": {
"type": "CONTACT",
"id": "contact_456",
"name": "Operations Wallet",
"address": "0xAbC1234567890abcdef1234567890abcdef1234",
"chain": "ETHEREUM"
},
"blockChain": "ETHEREUM",
"asset": "ETH",
"amount": "0.50",
"txHash": "0x9f4e6c1b7a2d3e4f",
"balanceChanges": {
"changes": [
{
"party": {
"type": "VAULT",
"id": "vault_123",
"subOrgId": "sub_org_123",
"name": "Treasury Vault"
},
"asset": "ETH",
"amount": "-0.50",
"chain": "ETHEREUM"
},
{
"party": {
"type": "CONTACT",
"id": "contact_456",
"name": "Operations Wallet",
"address": "0xAbC1234567890abcdef1234567890abcdef1234",
"chain": "ETHEREUM"
},
"asset": "ETH",
"amount": "0.50",
"chain": "ETHEREUM"
}
]
}
}
],
"nextCursor": "eyJpZCI6InRyYW5zYWN0aW9uXzEyMyJ9",
"hasNext": true
}
GET
/api/external/transactions/?limit={limit}&cursor={cursor}&{filters}
Query parameters
number
Requested page size. SDK default: 20.
string | null
First page: null/empty. Subsequent pages: the preceding
nextCursor.Record<string, string>
Transaction filters such as status, category, vaultId, asset, or externalId when supported.
Response
interface TransactionListResponse {
results: Transaction[];
nextCursor?: string | null;
hasNext?: boolean;
}
Request example
{
"query": {
"limit": 20,
"cursor": null,
"status": "COMPLETED",
"vaultId": "vault_123"
}
}
# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request GET \
--url "https://api.primevault.com/api/external/transactions/?limit=20&status=COMPLETED&vaultId=vault_123" \
--header "Authorization: Bearer <signed JWT>" \
--header "Api-Key: <API key>" \
--header "Accept: application/json"
getTransactions(
params?: Record<string, string>,
limit?: number,
cursor?: string | null,
): Promise<TransactionListResponse>
{
"results": [
{
"id": "transaction_123",
"orgId": "org_456",
"vaultId": "vault_123",
"status": "COMPLETED",
"transactionType": "OUTGOING",
"category": "TRANSFER",
"subCategory": "EXTERNAL_TRANSFER",
"createdAt": "2026-08-04T10:40:00Z",
"updatedAt": "2026-08-04T10:42:15Z",
"isDeleted": false,
"externalId": "invoice-1001",
"memo": "Vendor payout #1001",
"source": {
"type": "VAULT",
"id": "vault_123",
"subOrgId": "sub_org_123",
"name": "Treasury Vault"
},
"destination": {
"type": "CONTACT",
"id": "contact_456",
"name": "Operations Wallet",
"address": "0xAbC1234567890abcdef1234567890abcdef1234",
"chain": "ETHEREUM"
},
"blockChain": "ETHEREUM",
"asset": "ETH",
"amount": "0.50",
"txHash": "0x9f4e6c1b7a2d3e4f",
"balanceChanges": {
"changes": [
{
"party": {
"type": "VAULT",
"id": "vault_123",
"subOrgId": "sub_org_123",
"name": "Treasury Vault"
},
"asset": "ETH",
"amount": "-0.50",
"chain": "ETHEREUM"
},
{
"party": {
"type": "CONTACT",
"id": "contact_456",
"name": "Operations Wallet",
"address": "0xAbC1234567890abcdef1234567890abcdef1234",
"chain": "ETHEREUM"
},
"asset": "ETH",
"amount": "0.50",
"chain": "ETHEREUM"
}
]
}
}
],
"nextCursor": "eyJpZCI6InRyYW5zYWN0aW9uXzEyMyJ9",
"hasNext": true
}
⌘I
Request example
{
"query": {
"limit": 20,
"cursor": null,
"status": "COMPLETED",
"vaultId": "vault_123"
}
}
# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request GET \
--url "https://api.primevault.com/api/external/transactions/?limit=20&status=COMPLETED&vaultId=vault_123" \
--header "Authorization: Bearer <signed JWT>" \
--header "Api-Key: <API key>" \
--header "Accept: application/json"
getTransactions(
params?: Record<string, string>,
limit?: number,
cursor?: string | null,
): Promise<TransactionListResponse>
{
"results": [
{
"id": "transaction_123",
"orgId": "org_456",
"vaultId": "vault_123",
"status": "COMPLETED",
"transactionType": "OUTGOING",
"category": "TRANSFER",
"subCategory": "EXTERNAL_TRANSFER",
"createdAt": "2026-08-04T10:40:00Z",
"updatedAt": "2026-08-04T10:42:15Z",
"isDeleted": false,
"externalId": "invoice-1001",
"memo": "Vendor payout #1001",
"source": {
"type": "VAULT",
"id": "vault_123",
"subOrgId": "sub_org_123",
"name": "Treasury Vault"
},
"destination": {
"type": "CONTACT",
"id": "contact_456",
"name": "Operations Wallet",
"address": "0xAbC1234567890abcdef1234567890abcdef1234",
"chain": "ETHEREUM"
},
"blockChain": "ETHEREUM",
"asset": "ETH",
"amount": "0.50",
"txHash": "0x9f4e6c1b7a2d3e4f",
"balanceChanges": {
"changes": [
{
"party": {
"type": "VAULT",
"id": "vault_123",
"subOrgId": "sub_org_123",
"name": "Treasury Vault"
},
"asset": "ETH",
"amount": "-0.50",
"chain": "ETHEREUM"
},
{
"party": {
"type": "CONTACT",
"id": "contact_456",
"name": "Operations Wallet",
"address": "0xAbC1234567890abcdef1234567890abcdef1234",
"chain": "ETHEREUM"
},
"asset": "ETH",
"amount": "0.50",
"chain": "ETHEREUM"
}
]
}
}
],
"nextCursor": "eyJpZCI6InRyYW5zYWN0aW9uXzEyMyJ9",
"hasNext": true
}