---
updatedAt: 2025-11-11T23:14:23.000Z
agentTools:
projectIndex: https://developers.fortresstrust.com/llms.txt
---
# Withdraw crypto. (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/custodial-accounts/{custodialAccountId}/withdraw-crypto": {
"post": {
"tags": [
"CustodialAccounts"
],
"summary": "Withdraw crypto. (Auth)",
"parameters": [
{
"name": "custodialAccountId",
"in": "path",
"description": "Custodial account identifier",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "Idempotency-Key",
"in": "header",
"description": "The idempotency key for the endpoint",
"schema": {
"type": "string",
"format": "uuid"
}
}
],
"requestBody": {
"description": "Withdraw crypto request model",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WithdrawCryptoRequestModel"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/WithdrawCryptoRequestModel"
}
},
"application/*+json": {
"schema": {
"$ref": "#/components/schemas/WithdrawCryptoRequestModel"
}
}
}
},
"responses": {
"201": {
"description": "Withdraw crypto process started successfully",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PaymentResponseModel"
}
}
}
},
"400": {
"description": "Bad request model data",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
},
"examples": {
"Example 1": {
"summary": "Bad request result",
"value": {
"title": "string",
"status": 400,
"traceId": "string",
"path": "string",
"errors": {
"00000000-0000-0000-0000-000000000000": [
"Validation error"
]
}
}
},
"Example 2": {
"summary": "Invalid data",
"value": {
"title": "One or more validation errors occured.",
"status": 400,
"traceId": "string",
"path": "string",
"errors": {
"string": [
"string"
]
}
}
},
"Example 3": {
"summary": "Exeption",
"value": {
"title": "string",
"status": 400,
"traceId": "string",
"path": "string",
"errors": {}
}
}
}
}
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Withdraw crypto is allowed only for ZebPay custodial account"
},
"404": {
"description": "Custodial account was not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
},
"examples": {
"Example 1": {
"summary": "Validation exception",
"value": {
"title": "string",
"status": 404,
"traceId": "string",
"path": "string",
"errors": {
"00000000-0000-0000-0000-000000000000": [
"Validation error"
]
}
}
},
"Example 2": {
"summary": "Not found",
"value": {
"type": "string",
"title": "Not Found",
"status": 404,
"traceId": "string"
}
}
}
}
}
}
},
"security": [
{
"Bearer": []
}
]
}
}
},
"components": {
"schemas": {
"AchServiceModel": {
"enum": [
"standard",
"sameDay"
],
"type": "string"
},
"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
},
"ParsedModel": {
"type": "object",
"properties": {
"cycleDate": {
"type": "string",
"format": "date-time",
"nullable": true
},
"inputSource": {
"type": "string",
"nullable": true
},
"inputSequenceNumber": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false
},
"PaymentRejectedReason": {
"enum": [
"rejectedByAdmin",
"approvalTimeExpired"
],
"type": "string"
},
"PaymentResponseModel": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Payment identifier",
"format": "uuid"
},
"type": {
"$ref": "#/components/schemas/PaymentType"
},
"status": {
"$ref": "#/components/schemas/PaymentStatus"
},
"source": {
"$ref": "#/components/schemas/FundsStorageResponseModel"
},
"destination": {
"$ref": "#/components/schemas/FundsStorageResponseModel"
},
"comment": {
"type": "string",
"description": "Comment",
"nullable": true
},
"funds": {
"type": "number",
"description": "Funds",
"format": "double",
"nullable": true
},
"cryptoAmount": {
"type": "number",
"description": "Crypto amount",
"format": "double",
"nullable": true
},
"quantity": {
"type": "number",
"description": "Precious metal quantity",
"format": "double",
"nullable": true
},
"currency": {
"$ref": "#/components/schemas/ModelAssetFiatType"
},
"sourceCurrency": {
"$ref": "#/components/schemas/ModelAssetFiatType"
},
"destinationCurrency": {
"$ref": "#/components/schemas/ModelAssetFiatType"
},
"assetTypeId": {
"type": "string",
"description": "Id of Asset type (for Private Security)",
"format": "uuid",
"nullable": true
},
"network": {
"$ref": "#/components/schemas/ModelNetworkChain"
},
"sourceNetwork": {
"$ref": "#/components/schemas/ModelNetworkChain"
},
"destinationNetwork": {
"$ref": "#/components/schemas/ModelNetworkChain"
},
"txHash": {
"type": "string",
"description": "Transaction hash",
"nullable": true
},
"memo": {
"type": "string",
"description": "Memo",
"nullable": true
},
"purposeOfPayment": {
"type": "string",
"description": "Purpose of payment",
"nullable": true
},
"rejectedReason": {
"$ref": "#/components/schemas/PaymentRejectedReason"
},
"achService": {
"$ref": "#/components/schemas/AchServiceModel"
},
"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": "Payment response model"
},
"PaymentStatus": {
"enum": [
"new",
"completed",
"approvalNeeded",
"rejected"
],
"type": "string",
"description": "Payment status"
},
"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"
},
"ProblemDetails": {
"type": "object",
"properties": {
"type": {
"type": "string",
"nullable": true
},
"title": {
"type": "string",
"nullable": true
},
"status": {
"type": "integer",
"format": "int32",
"nullable": true
},
"detail": {
"type": "string",
"nullable": true
},
"instance": {
"type": "string",
"nullable": true
}
},
"additionalProperties": {}
},
"WithdrawCryptoRequestModel": {
"type": "object",
"properties": {
"network": {
"$ref": "#/components/schemas/ModelNetworkChain"
},
"currency": {
"$ref": "#/components/schemas/ModelAssetFiatType"
},
"address": {
"type": "string",
"description": "Gets or sets the destination address for withdrawal.",
"nullable": true
},
"tag": {
"type": "string",
"description": "Gets or sets the destination address tag for withdrawal.",
"nullable": true
},
"amount": {
"type": "number",
"description": "Gets or sets the amount of the currency to withdraw.",
"format": "double"
},
"comment": {
"type": "string",
"description": "Gets or sets the comment.",
"nullable": true
}
},
"additionalProperties": false,
"description": "Buy crypto request model"
}
},
"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
}
}
```