--- title: "GET /v1/portfolios/{portfolioSlug}/payment-transactions/{paymentId}/audit-trail" method: GET path: "/v1/portfolios/{portfolioSlug}/payment-transactions/{paymentId}/audit-trail" tags: ["PaymentTransactionAuditTrail"] --- # GET /v1/portfolios/{portfolioSlug}/payment-transactions/{paymentId}/audit-trail `GET /v1/portfolios/{portfolioSlug}/payment-transactions/{paymentId}/audit-trail` ## Request - Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tokenbooks.io/v1/portfolios/{portfolioSlug}/payment-transactions/{paymentId}/audit-trail` - Auth: API key in header `x-api-key` ## Path parameters - `portfolioSlug` string, required - `paymentId` string, required ## Query parameters - `minVersion` number: Only return events at or after this version. - `maxVersion` number: Only return events at or before this version. - `limit` number: Maximum number of events to return. - `reverse` boolean: Return events in descending version order. - `connectedWalletAddress` string: Widens visibility to a payment transaction reachable only through this connected wallet. ## Response `200` - PaymentTransactionAuditTrailResponseDto - `success` boolean, required - `aggregateId` string, required - `events` object[], required - `event` union, required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_CREATED', required - `timestamp` string, date-time, required - `payload` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `fromWallet` union, required - object - … - unknown - `description` union - string - unknown - `createdByUserId` string, required - `createdAt` string - `lines` object[], required - `lineNumber` number, required - `toAddress` string, required - `tokenAddress` string, required - `chainId` string, required - `amount` string, required - `ledgerAccountId` string, required - `description` union - … - `responsibilityCenterAssignments` object[] - … - `counterpartyId` union - … - `paymentRequestId` string - `tags` string[] - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_UPDATED', required - `timestamp` string, date-time, required - `payload` object, required - `description` union - string - unknown - `tags` string[] - `lines` object[] - `lineNumber` number, required - `toAddress` string, required - `tokenAddress` string, required - `chainId` string, required - `amount` string, required - `ledgerAccountId` string, required - `description` union - … - `responsibilityCenterAssignments` object[] - … - `counterpartyId` union - … - `paymentRequestId` string - `fromWallet` union - object - … - unknown - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_PROPOSED', required - `timestamp` string, date-time, required - `payload` object, required - `safeTxHash` string, required - `safeNonce` number, required - `senderAddress` string, required - `safeGasMetadata` object - `safeTxGas` string, required - `baseGas` string, required - `gasPrice` string, required - `gasToken` string, required - `refundReceiver` string, required - `safeOperation` number - `importedSafePayload` object - `to` string, required - `value` string, required - `data` string, required - `operation` number, required - `safeTxGas` string, required - `baseGas` string, required - `gasPrice` string, required - `gasToken` string, required - `refundReceiver` string, required - `nonce` number, required - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_SIGNATURE_ADDED', required - `timestamp` string, date-time, required - `payload` object, required - `signerAddress` string, required - `signature` string, required - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_SAFE_SYNCED', required - `timestamp` string, date-time, required - `payload` object, required - `createdAt` string - `safeNonce` number, required - `safeOperation` number, required - `safeGasMetadata` object, required - `safeTxGas` string, required - `baseGas` string, required - `gasPrice` string, required - `gasToken` string, required - `refundReceiver` string, required - `importedSafePayload` object, required - `to` string, required - `value` string, required - `data` string, required - `operation` number, required - `safeTxGas` string, required - `baseGas` string, required - `gasPrice` string, required - `gasToken` string, required - `refundReceiver` string, required - `nonce` number, required - `lines` object[], required - `lineNumber` number, required - `toAddress` string, required - `tokenAddress` string, required - `chainId` string, required - `amount` string, required - `ledgerAccountId` string, required - `description` union - … - `responsibilityCenterAssignments` object[] - … - `counterpartyId` union - … - `paymentRequestId` string - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_REJECTION_ADDED', required - `timestamp` string, date-time, required - `payload` object, required - `signerAddress` string, required - `reason` union - string - unknown - `source` 'USER' | 'SAFE_SYNC', required - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_REJECTED', required - `timestamp` string, date-time, required - `payload` object, required - `reason` union - string - unknown - `source` 'USER' | 'SAFE_SYNC', required - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_EXECUTED', required - `timestamp` string, date-time, required - `payload` object, required - `blockchainTxHash` string, required - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_FAILED', required - `timestamp` string, date-time, required - `payload` object, required - `reason` string, required - `blockchainTxHash` string - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_DELETED', required - `timestamp` string, date-time, required - `payload` object, required - `reason` string - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_WALLET_LINKED', required - `timestamp` string, date-time, required - `payload` object, required - `walletTransactionId` string, required - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_PORTFOLIO_LINKED', required - `timestamp` string, date-time, required - `payload` object, required - `portfolioTransactionId` string, required - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_FILE_ATTACHED', required - `timestamp` string, date-time, required - `payload` object, required - `file` object, required - `id` string, required - `fileName` string, required - `fileSize` integer, required - `mimeType` string, required - `uploadedByUserId` string, required - `uploadedAt` string, date-time, required - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_FILE_REMOVED', required - `timestamp` string, date-time, required - `payload` object, required - `fileId` string, required - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_DUPLICATED_WITH_REQUEST_MOVE', required - `timestamp` string, date-time, required - `payload` object, required - `newPaymentTransactionId` string, required - `movedPaymentRequestIds` string[], required - `lines` object[], required - `lineNumber` number, required - `toAddress` string, required - `tokenAddress` string, required - `chainId` string, required - `amount` string, required - `ledgerAccountId` string, required - `description` union - … - `responsibilityCenterAssignments` object[] - … - `counterpartyId` union - … - `paymentRequestId` string - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - object - `aggregateId` string, required - `version` integer, required - `type` 'PAYMENT_TRANSACTION_RESTART_REQUESTS_MOVED', required - `timestamp` string, date-time, required - `payload` object, required - `newPaymentTransactionId` string, required - `movedPaymentRequestIds` string[], required - `lines` object[], required - `lineNumber` number, required - `toAddress` string, required - `tokenAddress` string, required - `chainId` string, required - `amount` string, required - `ledgerAccountId` string, required - `description` union - … - `responsibilityCenterAssignments` object[] - … - `counterpartyId` union - … - `paymentRequestId` string - `metadata` object, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `userId` string - `source` 'USER' | 'SYSTEM' | 'PROJECTION' | 'SAGA' | 'EXTERNAL' - `userId` string - `user` object - `id` string, required - `name` string, nullable, required - `image` string, nullable, required - `status` 'current' | 'former', required - `before` object, nullable, required - `aggregateId` string, required - `version` number, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `fromWallet` union, required - object - `chainId` string, required: Chain ID - `address` string, required: Wallet address - unknown - `description` union - string - unknown - `createdAt` string - `createdByUserId` string - `status` 'DRAFT' | 'PENDING_SIGNATURE' | 'PENDING_EXECUTION' | 'EXECUTED' | 'FAILED' | 'REJECTED', required - `safeTxHash` string - `safeNonce` number - `safeOperation` number - `safeGasMetadata` object - `safeTxGas` string, required - `baseGas` string, required - `gasPrice` string, required - `gasToken` string, required - `refundReceiver` string, required - `importedSafePayload` object - `to` string, required - `value` string, required - `data` string, required - `operation` number, required - `safeTxGas` string, required - `baseGas` string, required - `gasPrice` string, required - `gasToken` string, required - `refundReceiver` string, required - `nonce` number, required - `walletTransactionId` string - `portfolioTransactionId` string - `signatures` object[], required - `signerAddress` string, required - `signature` string, required - `rejections` object[], required - `signerAddress` string, required - `reason` union - string - unknown - `source` 'USER' | 'SAFE_SYNC', required - `rejectedAt` string, required - `tags` string[], required - `blockchainTxHash` string - `lines` object[], required - `lineNumber` number, required - `toAddress` string, required - `tokenAddress` string, required - `chainId` string, required - `amount` string, required - `ledgerAccountId` string, required - `description` union - string - unknown - `responsibilityCenterAssignments` object[] - `responsibilityCenterTypeId` string, required - `responsibilityCenterId` string, required - `percentageBps` integer, required - `counterpartyId` union - string - unknown - `paymentRequestId` string - `fileAttachments` object[], required - `id` string, required - `fileName` string, required - `fileSize` integer, required - `mimeType` string, required - `uploadedByUserId` string, required - `uploadedAt` string, date-time, required - `isDeleted` boolean, required - `after` object, nullable, required - `aggregateId` string, required - `version` number, required - `portfolioSlug` union, required - string: Public URL slug. - unknown - `fromWallet` union, required - object - `chainId` string, required: Chain ID - `address` string, required: Wallet address - unknown - `description` union - string - unknown - `createdAt` string - `createdByUserId` string - `status` 'DRAFT' | 'PENDING_SIGNATURE' | 'PENDING_EXECUTION' | 'EXECUTED' | 'FAILED' | 'REJECTED', required - `safeTxHash` string - `safeNonce` number - `safeOperation` number - `safeGasMetadata` object - `safeTxGas` string, required - `baseGas` string, required - `gasPrice` string, required - `gasToken` string, required - `refundReceiver` string, required - `importedSafePayload` object - `to` string, required - `value` string, required - `data` string, required - `operation` number, required - `safeTxGas` string, required - `baseGas` string, required - `gasPrice` string, required - `gasToken` string, required - `refundReceiver` string, required - `nonce` number, required - `walletTransactionId` string - `portfolioTransactionId` string - `signatures` object[], required - `signerAddress` string, required - `signature` string, required - `rejections` object[], required - `signerAddress` string, required - `reason` union - string - unknown - `source` 'USER' | 'SAFE_SYNC', required - `rejectedAt` string, required - `tags` string[], required - `blockchainTxHash` string - `lines` object[], required - `lineNumber` number, required - `toAddress` string, required - `tokenAddress` string, required - `chainId` string, required - `amount` string, required - `ledgerAccountId` string, required - `description` union - string - unknown - `responsibilityCenterAssignments` object[] - `responsibilityCenterTypeId` string, required - `responsibilityCenterId` string, required - `percentageBps` integer, required - `counterpartyId` union - string - unknown - `paymentRequestId` string - `fileAttachments` object[], required - `id` string, required - `fileName` string, required - `fileSize` integer, required - `mimeType` string, required - `uploadedByUserId` string, required - `uploadedAt` string, date-time, required - `isDeleted` boolean, required - `warnings` string[], required - `error` string - `pagination` object - `requestedLimit` number - `hasMore` boolean, required - `minVersion` number - `maxVersion` number --- [API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)