---
updatedAt: 2025-11-11T23:14:30.000Z
agentTools:
projectIndex: https://developers.fortresstrust.com/llms.txt
---
# Retrieve the filtered, paged list with transactions. (Auth)
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Core Api",
"version": "1.0"
},
"servers": [
{
"url": "https://api.sandbox.fortressapi.com/"
}
],
"paths": {
"/api/trust/v1/transactions": {
"get": {
"tags": [
"Transactions"
],
"summary": "Retrieve the filtered, paged list with transactions. (Auth)",
"parameters": [
{
"name": "IdentityId",
"in": "query",
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "CustodialAccountId",
"in": "query",
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "PaymentId",
"in": "query",
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "Page",
"in": "query",
"description": "Page count",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "PageSize",
"in": "query",
"description": "PageSize",
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TransactionResponseModelPageResponseModel"
}
}
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
}
},
"security": [
{
"Bearer": []
}
]
}
}
},
"components": {
"schemas": {
"AddressModel": {
"required": [
"city",
"country",
"street1"
],
"type": "object",
"properties": {
"street1": {
"minLength": 1,
"type": "string"
},
"street2": {
"type": "string",
"nullable": true
},
"postalCode": {
"type": "string",
"nullable": true
},
"city": {
"minLength": 1,
"type": "string"
},
"state": {
"type": "string",
"nullable": true
},
"country": {
"minLength": 1,
"type": "string"
}
},
"additionalProperties": false
},
"BankDataModel": {
"type": "object",
"properties": {
"bankName": {
"type": "string",
"nullable": true
},
"accountNumber": {
"type": "string",
"nullable": true
},
"routingNumber": {
"type": "string",
"nullable": true
},
"accountType": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false
},
"FundsStorageResponseModel": {
"type": "object",
"properties": {
"identityId": {
"type": "string",
"format": "uuid",
"nullable": true
},
"custodialAccountId": {
"type": "string",
"format": "uuid",
"nullable": true
},
"custodialSubAccountId": {
"type": "string",
"format": "uuid",
"nullable": true
},
"externalAccountId": {
"type": "string",
"format": "uuid",
"nullable": true
},
"incomingTransferOrigin": {
"type": "string",
"nullable": true
},
"cryptoAddress": {
"type": "string",
"nullable": true
},
"tag": {
"type": "string",
"nullable": true
},
"comment": {
"type": "string",
"nullable": true
},
"originator": {
"$ref": "#/components/schemas/OriginatorModel"
},
"imad": {
"$ref": "#/components/schemas/ImadModel"
},
"description": {
"type": "string",
"nullable": true
},
"refCode": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false
},
"ImadModel": {
"type": "object",
"properties": {
"raw": {
"type": "string",
"nullable": true
},
"parsed": {
"$ref": "#/components/schemas/ParsedModel"
}
},
"additionalProperties": false
},
"ModelAssetFiatType": {
"enum": [
"usd",
"btc",
"eth",
"matic",
"usdc",
"sol",
"ada",
"xlm",
"dot",
"link",
"algo",
"bnb",
"busd",
"avax",
"ltc",
"uni",
"crv",
"aave",
"eos",
"bch",
"xtz",
"comp",
"bat",
"shib",
"doge",
"grt",
"sushi",
"sand",
"enj",
"axs",
"mana",
"mkr",
"yfi",
"atom",
"ape",
"dai",
"usdt",
"near",
"trx",
"ftm",
"xrp",
"flrns",
"flow",
"smtf",
"qnt",
"chz",
"gala",
"hbar",
"pol",
"gold",
"silver"
],
"type": "string",
"description": "Asset fiat type"
},
"ModelNetworkChain": {
"enum": [
"mainnet",
"ropsten",
"goerli",
"bnbSmartChainMainnet",
"eosMainnet",
"bnbSmartChainTestnet",
"polygonMainnet",
"fantomMainnet",
"eosTestnet",
"bitcoinMainnet",
"cosmosHub",
"cosmosHubTestnet",
"bitcoinTestnet",
"bchMainnet",
"bchTestnet",
"solanaMainnet",
"solanaDevnet",
"solanaTestnet",
"polkadotMainnet",
"polkadotWestend",
"cardanoMainnet",
"cardanoTestnet",
"algorandMainnet",
"algorandTestnet",
"stellarMainnet",
"stellarTestnet",
"litecoinMainnet",
"litecoinTestnet",
"tezosMainnet",
"tezosTestnet",
"arbitrumMainnet",
"avalancheFuji",
"avalancheMainnet",
"polygonMumbai",
"polygonAmoy",
"rippleMainnet",
"rippleTestnet",
"arbitrumGoerli",
"arbitrumSepolia",
"dogeTestnet",
"dogeMainnet",
"nearMainnet",
"nearTestnet",
"tronMainnet",
"tronTestnet",
"flowMainnet",
"flowTestnet",
"hederaMainnet",
"hederaTestnet",
"sepolia"
],
"type": "string",
"description": "Supported networks"
},
"OriginatorAddressModel": {
"type": "object",
"properties": {
"raw": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true
},
"parsed": {
"$ref": "#/components/schemas/AddressModel"
}
},
"additionalProperties": false
},
"OriginatorModel": {
"type": "object",
"properties": {
"name": {
"type": "string",
"nullable": true
},
"address": {
"$ref": "#/components/schemas/OriginatorAddressModel"
},
"bankData": {
"$ref": "#/components/schemas/BankDataModel"
}
},
"additionalProperties": false
},
"PageMetadata": {
"type": "object",
"properties": {
"pageCount": {
"type": "integer",
"format": "int32"
},
"resourceCount": {
"type": "integer",
"format": "int32"
}
},
"additionalProperties": false
},
"ParsedModel": {
"type": "object",
"properties": {
"cycleDate": {
"type": "string",
"format": "date-time",
"nullable": true
},
"inputSource": {
"type": "string",
"nullable": true
},
"inputSequenceNumber": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false
},
"PaymentType": {
"enum": [
"internal",
"cardDeposit",
"cardWithdrawal",
"achDeposit",
"achWithdrawal",
"wireDeposit",
"wireWithdrawal",
"buyCrypto",
"sellCrypto",
"depositCrypto",
"withdrawalCrypto",
"internalCrypto",
"privateSecurityDeposit",
"privateSecurityWithdrawal",
"privateSecurityInternal",
"incomingAchDeposit",
"incomingAchWithdrawal",
"checkDeposit",
"internationalWireWithdrawal",
"initialDeposit",
"achDepositReturn",
"achWithdrawalReturn",
"achDepositReverse",
"achWithdrawalReverse",
"wireDepositReturn",
"wireWithdrawalReturn",
"wireDepositReverse",
"wireWithdrawalReverse",
"buyPreciousMetal",
"sellPreciousMetal",
"depositPreciousMetal",
"withdrawalPreciousMetal",
"manuallyProcessed",
"wireDepositPartialReturn",
"incomingAchDepositReturn",
"dishonoredAchReturn",
"transferFee",
"internalMovement",
"internalFeeRecalculationTransfer",
"internationalWireWithdrawalReturn",
"swapCrypto"
],
"type": "string",
"description": "Payment type"
},
"TransactionResponseModel": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Transaction identifier",
"format": "uuid"
},
"groupId": {
"type": "string",
"description": "Transaction group identifier",
"format": "uuid",
"nullable": true
},
"paymentId": {
"type": "string",
"description": "Payment identifier",
"format": "uuid"
},
"paymentType": {
"$ref": "#/components/schemas/PaymentType"
},
"status": {
"$ref": "#/components/schemas/TransactionStatus"
},
"source": {
"$ref": "#/components/schemas/FundsStorageResponseModel"
},
"destination": {
"$ref": "#/components/schemas/FundsStorageResponseModel"
},
"comment": {
"type": "string",
"description": "Comment",
"nullable": true
},
"amount": {
"type": "number",
"description": "Amount",
"format": "double",
"nullable": true
},
"cryptoAmount": {
"type": "number",
"description": "Crypto amount",
"format": "double",
"nullable": true
},
"quantity": {
"type": "number",
"description": "PM amount",
"format": "double",
"nullable": true
},
"price": {
"type": "number",
"description": "Contains executed price for Buy/Sell transactions",
"format": "double",
"nullable": true
},
"currency": {
"$ref": "#/components/schemas/ModelAssetFiatType"
},
"metadata": {
"type": "object",
"additionalProperties": {
"type": "string",
"nullable": true
},
"description": "Transaction metadata",
"nullable": true
},
"description": {
"type": "string",
"description": "Transaction description generated by Fortress",
"nullable": true
},
"createdAt": {
"type": "string",
"description": "Timestamp when transaction was created",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"description": "Timestamp when transaction was updated",
"format": "date-time",
"nullable": true
},
"txHash": {
"type": "string",
"description": "Transaction hash",
"nullable": true
},
"memo": {
"type": "string",
"description": "Memo",
"nullable": true
},
"imad": {
"$ref": "#/components/schemas/ImadModel"
},
"returnCode": {
"type": "string",
"description": "Return code (for Returned payments)",
"nullable": true
},
"fillPercentage": {
"type": "string",
"description": "Fill percentage (for crypto orders)",
"nullable": true
},
"network": {
"$ref": "#/components/schemas/ModelNetworkChain"
},
"sourceNetwork": {
"$ref": "#/components/schemas/ModelNetworkChain"
},
"destinationNetwork": {
"$ref": "#/components/schemas/ModelNetworkChain"
},
"sourceAmount": {
"type": "string",
"description": "Source amount for Swap payments (optional, used only for Swap type)",
"nullable": true
},
"destinationAmount": {
"type": "string",
"description": "Destination amount for Swap payments (optional, used only for Swap type)",
"nullable": true
}
},
"additionalProperties": false,
"description": "Transaction response model"
},
"TransactionResponseModelPageResponseModel": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TransactionResponseModel"
},
"description": "Gets or sets the data.",
"nullable": true
},
"meta": {
"$ref": "#/components/schemas/PageMetadata"
}
},
"additionalProperties": false
},
"TransactionStatus": {
"enum": [
"new",
"processing",
"completed",
"failed",
"pending",
"aborted",
"inProgress",
"cancelled"
],
"type": "string",
"description": "Transaction status"
}
},
"securitySchemes": {
"Bearer": {
"type": "apiKey",
"description": "Put access token in the box below.
For example: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6I",
"name": "Authorization",
"in": "header"
}
}
},
"security": [
{
"Bearer": []
}
],
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}
```