Get transfers initiated by Mesh

curl --request GET \
  --url https://integration-api.meshconnect.com/api/v1/transfers/managed/mesh \
  --header 'X-Client-Id: <api-key>' \
  --header 'X-Client-Secret: <api-key>'

{
  "content": {
    "items": [
      {
        "userId": "123456798",
        "amountToReceive": 0,
        "networkId": "00000000-0000-0000-0000-000000000000",
        "networkLogoUrl": "https://file-cdn.meshconnect.com/public/logos/networks/Polygon.svg",
        "infoUrl": "https://polygonscan.com/tx/0x5b0ac59e43b63f2985d78994b6270d747f1019777201ca18ebb36ad1e1a8693e",
        "from": {
          "logoUrl": "https://logo.com/logo.jpg",
          "id": "8e25acb5-a9e2-4d00-8772-a255f010a2a9",
          "type": "robinhood",
          "name": "Robinhood"
        },
        "sourceAmount": 10.122,
        "destinationAmount": 10,
        "totalFeesAmountInFiat": 0.5,
        "totalTransactionAmountInFiat": 1000.5,
        "fundingMethods": [
          {
            "type": "cryptocurrencyConversion",
            "amount": 2,
            "amountInFiat": 20,
            "toSymbol": "WETH",
            "fromAmount": 1,
            "fromSymbol": "BTC",
            "fee": {
              "fee": 0.0001,
              "feeCurrency": "ETH",
              "feeInFiat": 0.1,
              "feeInTransferCurrency": 0
            }
          },
          {
            "type": "paymentMethodDepositUsage",
            "amount": 3,
            "amountInFiat": 30,
            "toSymbol": "WETH",
            "fromAmount": 1,
            "fromSymbol": "USD",
            "paymentMethodType": "bankAccount",
            "fee": {
              "fee": 0.0001,
              "feeCurrency": "USD",
              "feeInFiat": 0.1,
              "feeInTransferCurrency": 0
            }
          },
          {
            "type": "existingCryptocurrencyBalance",
            "amount": 5,
            "amountInFiat": 50,
            "toSymbol": "WETH",
            "fromAmount": 5,
            "fromSymbol": "ETH"
          }
        ],
        "id": "8e25acb5-a9e2-4d00-8772-a255f010a2a9",
        "clientTransactionId": "123456",
        "institutionTransactionId": "456789",
        "status": "succeeded",
        "amountInFiat": 1000.3,
        "amountToReceiveInFiat": 0,
        "amountInFiatCurrencyCode": "USD",
        "amount": 10.123,
        "symbol": "WETH",
        "tokenAddress": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
        "networkName": "Polygon",
        "createdTimestamp": 1653211113,
        "hash": "0x77f3a280aa5cfe956a5759c24cf774325504070b32b4159...",
        "gasFee": {
          "fee": 0.0001,
          "feeCurrency": "MATIC",
          "feeInFiat": 0.1,
          "feeInTransferCurrency": 0
        },
        "withdrawalFee": {
          "fee": 0.0001,
          "feeCurrency": "WETH",
          "feeInFiat": 0.1,
          "feeInTransferCurrency": 0
        },
        "processingFee": {
          "fee": 0.0001,
          "feeCurrency": "WETH",
          "feeInFiat": 0.1,
          "feeInTransferCurrency": 0
        },
        "executedTimestamp": 1707462614,
        "transferType": "payment",
        "isFeeIncluded": false,
        "isSmartFundingTransfer": false,
        "unitPrice": 0,
        "requestedTransferAmount": 0,
        "isBridgingTransfer": false
      },
      {
        "userId": "123456798",
        "amountToReceive": 0,
        "networkId": "00000000-0000-0000-0000-000000000000",
        "from": {
          "logoUrl": "https://logo.com/logo.jpg",
          "id": "8e25acb5-a9e2-4d00-8772-a255f010a2a9",
          "type": "deFiWallet",
          "name": "MetaMask"
        },
        "totalFeesAmountInFiat": 0,
        "totalTransactionAmountInFiat": 10.3,
        "fundingMethods": [],
        "id": "12345678-a9e2-4d00-8772-a255f010a2a9",
        "clientTransactionId": "123456",
        "institutionTransactionId": "456789",
        "status": "failed",
        "amountInFiat": 10.3,
        "amountToReceiveInFiat": 0,
        "amountInFiatCurrencyCode": "USD",
        "amount": 0.123,
        "symbol": "WETH",
        "tokenAddress": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
        "networkName": "Polygon",
        "createdTimestamp": 1653211113,
        "hash": "0x77f3a280aa5cfe956a5759c24cf774325504070b32b4159...",
        "isFeeIncluded": false,
        "isSmartFundingTransfer": false,
        "unitPrice": 0,
        "requestedTransferAmount": 0,
        "isBridgingTransfer": false
      }
    ],
    "total": 10
  },
  "status": "ok",
  "message": "",
  "errorHash": "bf6d53f3",
  "errorType": ""
}

GET

api

transfers

managed

mesh

Get transfers initiated by Mesh

curl --request GET \
  --url https://integration-api.meshconnect.com/api/v1/transfers/managed/mesh \
  --header 'X-Client-Id: <api-key>' \
  --header 'X-Client-Secret: <api-key>'

{
  "content": {
    "items": [
      {
        "userId": "123456798",
        "amountToReceive": 0,
        "networkId": "00000000-0000-0000-0000-000000000000",
        "networkLogoUrl": "https://file-cdn.meshconnect.com/public/logos/networks/Polygon.svg",
        "infoUrl": "https://polygonscan.com/tx/0x5b0ac59e43b63f2985d78994b6270d747f1019777201ca18ebb36ad1e1a8693e",
        "from": {
          "logoUrl": "https://logo.com/logo.jpg",
          "id": "8e25acb5-a9e2-4d00-8772-a255f010a2a9",
          "type": "robinhood",
          "name": "Robinhood"
        },
        "sourceAmount": 10.122,
        "destinationAmount": 10,
        "totalFeesAmountInFiat": 0.5,
        "totalTransactionAmountInFiat": 1000.5,
        "fundingMethods": [
          {
            "type": "cryptocurrencyConversion",
            "amount": 2,
            "amountInFiat": 20,
            "toSymbol": "WETH",
            "fromAmount": 1,
            "fromSymbol": "BTC",
            "fee": {
              "fee": 0.0001,
              "feeCurrency": "ETH",
              "feeInFiat": 0.1,
              "feeInTransferCurrency": 0
            }
          },
          {
            "type": "paymentMethodDepositUsage",
            "amount": 3,
            "amountInFiat": 30,
            "toSymbol": "WETH",
            "fromAmount": 1,
            "fromSymbol": "USD",
            "paymentMethodType": "bankAccount",
            "fee": {
              "fee": 0.0001,
              "feeCurrency": "USD",
              "feeInFiat": 0.1,
              "feeInTransferCurrency": 0
            }
          },
          {
            "type": "existingCryptocurrencyBalance",
            "amount": 5,
            "amountInFiat": 50,
            "toSymbol": "WETH",
            "fromAmount": 5,
            "fromSymbol": "ETH"
          }
        ],
        "id": "8e25acb5-a9e2-4d00-8772-a255f010a2a9",
        "clientTransactionId": "123456",
        "institutionTransactionId": "456789",
        "status": "succeeded",
        "amountInFiat": 1000.3,
        "amountToReceiveInFiat": 0,
        "amountInFiatCurrencyCode": "USD",
        "amount": 10.123,
        "symbol": "WETH",
        "tokenAddress": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
        "networkName": "Polygon",
        "createdTimestamp": 1653211113,
        "hash": "0x77f3a280aa5cfe956a5759c24cf774325504070b32b4159...",
        "gasFee": {
          "fee": 0.0001,
          "feeCurrency": "MATIC",
          "feeInFiat": 0.1,
          "feeInTransferCurrency": 0
        },
        "withdrawalFee": {
          "fee": 0.0001,
          "feeCurrency": "WETH",
          "feeInFiat": 0.1,
          "feeInTransferCurrency": 0
        },
        "processingFee": {
          "fee": 0.0001,
          "feeCurrency": "WETH",
          "feeInFiat": 0.1,
          "feeInTransferCurrency": 0
        },
        "executedTimestamp": 1707462614,
        "transferType": "payment",
        "isFeeIncluded": false,
        "isSmartFundingTransfer": false,
        "unitPrice": 0,
        "requestedTransferAmount": 0,
        "isBridgingTransfer": false
      },
      {
        "userId": "123456798",
        "amountToReceive": 0,
        "networkId": "00000000-0000-0000-0000-000000000000",
        "from": {
          "logoUrl": "https://logo.com/logo.jpg",
          "id": "8e25acb5-a9e2-4d00-8772-a255f010a2a9",
          "type": "deFiWallet",
          "name": "MetaMask"
        },
        "totalFeesAmountInFiat": 0,
        "totalTransactionAmountInFiat": 10.3,
        "fundingMethods": [],
        "id": "12345678-a9e2-4d00-8772-a255f010a2a9",
        "clientTransactionId": "123456",
        "institutionTransactionId": "456789",
        "status": "failed",
        "amountInFiat": 10.3,
        "amountToReceiveInFiat": 0,
        "amountInFiatCurrencyCode": "USD",
        "amount": 0.123,
        "symbol": "WETH",
        "tokenAddress": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
        "networkName": "Polygon",
        "createdTimestamp": 1653211113,
        "hash": "0x77f3a280aa5cfe956a5759c24cf774325504070b32b4159...",
        "isFeeIncluded": false,
        "isSmartFundingTransfer": false,
        "unitPrice": 0,
        "requestedTransferAmount": 0,
        "isBridgingTransfer": false
      }
    ],
    "total": 10
  },
  "status": "ok",
  "message": "",
  "errorHash": "bf6d53f3",
  "errorType": ""
}

Authorizations

X-Client-Secret

string

header

required

Contact Mesh to get client Secret

X-Client-Id

string

header

required

Contact Mesh to get client Id

Query Parameters

Count

integer<int32>

Number of items to return. Default 10, maximum - 100.

Offset

integer<int32>

Number of items to skip.

string<uuid>

Mesh transfer identifier.

ClientTransactionId

string

Client transaction identifier.

Maximum string length: 128

UserId

string

Client's user identifier.

Maximum string length: 50

IntegrationIds

string<uuid>[]

Transfered integration.

Maximum array length: 100

Statuses

enum<string>[]

Transfer statuses.

Maximum array length: 5

Available options:

pending,

succeeded,

failed

FromTimestamp

integer<int64>

Transfer created minimum timestamp.

ToTimestamp

integer<int64>

Transfer created maximum timestamp.

MinAmountInFiat

number<double>

Minimum amount in fiat.

MaxAmountInFiat

number<double>

Maximum amount in fiat.

OrderBy

enum<string>

Order by column.

Available options:

id,

clientTransferId,

userId,

fromType,

amountInFiat,

status,

createdTimestamp,

symbol,

networkName

Hash

string

Transfer hash.

SubClientId

string<uuid>

Sub-client identifier.

DescendingOrder

boolean

Value indicating if ordering is descending.

IsSandBox

boolean

Value indicating if Env is Sandbox.

Response

Transfers obtained.

status

enum<string>

Available options:

ok,

serverFailure,

permissionDenied,

badRequest,

notFound,

conflict,

tooManyRequest,

locked,

unavailableForLegalReasons

message

string | null

A message generated by the API

displayMessage

string | null

User-friendly display message that can be presented to the end user

errorHash

string | null

An error grouping hash from string components and caller information. Used by bugsnag on FE for correct error grouping

errorType

string | null

Strictly-typed error type that is explaining the reason of an unsuccessful status of the operation. All possible error types are available in the documentation.

errorData

unknown

content

object

Show child attributes

content.items

object[] | null

list of items

Show child attributes

content.items.id

string<uuid>

required

Mesh transfer identifier.

content.items.clientTransactionId

string | null

Client transaction identifier.

content.items.institutionTransactionId

string | null

Integration transaction identifier.

content.items.status

enum<string>

Transfer status.

Available options:

pending,

succeeded,

failed

content.items.amountInFiat

number<double>

Transfer amount in fiat.

content.items.amountToReceiveInFiat

number<double>

Actual transfer amount without fees in fiat.

content.items.amountInFiatCurrencyCode

string | null

Transfer amount in fiat currency code.

content.items.amount

number<double>

Transfer amount.

content.items.symbol

string | null

Transfer cryptocurrency symbol.

content.items.tokenAddress

string | null

Transfer cryptocurrency token contract address (e.g., for ERC20s).

content.items.networkName

string | null

Transfer network name.

content.items.createdTimestamp

integer<int64>

Created timestamp.

content.items.hash

string | null

Transfer hash.

content.items.subClientId

string<uuid> | null

Sub-client identifier.

content.items.clientId

string<uuid> | null

Client identifier.

content.items.companyName

string | null

Company name

content.items.gasFee

object

Transfer network gas fee.

Show child attributes

content.items.gasFee.fee

number<double>

The amount of the fee.

content.items.gasFee.feeCurrency

string | null

The currency of the fee. Does not match the currency of the transfer in some cases.

content.items.gasFee.feeInFiat

number<double>

The value of the fee converted to the fiat currency.

content.items.gasFee.feeInTransferCurrency

number<double>

The value of the fee converted to the transfer currency.

content.items.withdrawalFee

object

Financial institution withdrawal fee.

Show child attributes

content.items.withdrawalFee.fee

number<double>

The amount of the fee.

content.items.withdrawalFee.feeCurrency

string | null

The currency of the fee. Does not match the currency of the transfer in some cases.

content.items.withdrawalFee.feeInFiat

number<double>

The value of the fee converted to the fiat currency.

content.items.withdrawalFee.feeInTransferCurrency

number<double>

The value of the fee converted to the transfer currency.

content.items.processingFee

object

Transfer processing fee.

Show child attributes

content.items.processingFee.fee

number<double>

The amount of the fee.

content.items.processingFee.feeCurrency

string | null

The currency of the fee. Does not match the currency of the transfer in some cases.

content.items.processingFee.feeInFiat

number<double>

The value of the fee converted to the fiat currency.

content.items.processingFee.feeInTransferCurrency

number<double>

The value of the fee converted to the transfer currency.

content.items.executedTimestamp

integer<int64> | null

Transfer executed Unix timestamp.

content.items.transferType

enum<string>

Type of a transfer.

Available options:

deposit,

payment,

onramp

content.items.isFeeIncluded

boolean

Is fee included.

content.items.destinationAddress

string | null

Transfer Destination Address.

content.items.addressTag

string | null

Transfer Destination Address Tag.

content.items.isSmartFundingTransfer

boolean

Indicates whether this transfer is part of a smart funding operation.

content.items.unitPrice

number<double>

Unit price of the cryptocurrency in fiat at the time of transfer.

content.items.requestedTransferAmount

number<double>

The exact amount requested for transfer before any fees are applied.

content.items.isBridgingTransfer

boolean

Indicates whether this transfer involves bridging between different blockchain networks.

content.items.userId

string | null

Client's user identifier.

content.items.amountToReceive

number<double>

Actual transfer amount without fees.

content.items.networkId

string<uuid>

Id of the transfer network.

content.items.networkLogoUrl

string | null

Network logo URL.

content.items.infoUrl

string<uri> | null

Transfer info url on blockchain explorer.

content.items.from

object

Show child attributes

content.items.from.id

string<uuid>

Unique identifier of integration.

content.items.from.type

enum<string>

Type of integration.

Available options:

robinhood,

eTrade,

alpaca,

tdAmeritrade,

weBull,

stash,

interactiveBrokers,

public,

coinbase,

kraken,

coinbasePro,

cryptoCom,

openSea,

binanceUs,

gemini,

cryptocurrencyAddress,

cryptocurrencyWallet,

okCoin,

bittrex,

kuCoin,

etoro,

cexIo,

binanceInternational,

bitstamp,

gateIo,

acorns,

okx,

bitFlyer,

coinlist,

huobi,

bitfinex,

deFiWallet,

krakenDirect,

vanguard,

binanceInternationalDirect,

bitfinexDirect,

bybit,

paxos,

coinbasePrime,

btcTurkDirect,

kuCoinDirect,

okxOAuth,

paribuDirect,

robinhoodConnect,

blockchainCom,

bitsoDirect,

binanceConnect,

binanceOAuth,

revolutConnect,

binancePay,

bybitDirect,

paribuOAuth,

payPalConnect,

binanceTrDirect,

coinbaseRamp,

bybitDirectMobile,

sandbox,

cryptoComPay,

bybitEuDirect

content.items.from.name

string | null

Name of integration.

content.items.from.logoUrl

string | null

Integration logo URL.

content.items.sourceAmount

number<double> | null

Amount what was actually transferred from source account.

content.items.destinationAmount

number<double> | null

Amount what destination actually received.

content.items.destinationAmountInFiat

number<double> | null

Amount in fiat what destination actually received.

content.items.totalFeesAmountInFiat

number<double>

Total fees paid by user to execute this transaction.

content.items.totalTransactionAmountInFiat

number<double>

Total fiat transaction amount in origin integration.

content.items.fundingMethods

object[] | null

The funding methods that were used to fund the transaction.

Show child attributes

content.items.fundingMethods.type

enum<string>

Type of the funding method.

Available options:

existingCryptocurrencyBalance,

buyingPowerPurchase,

paymentMethodDepositUsage,

cryptocurrencyConversion,

stableCoinNoFeeConversion,

cryptocurrencyBuyingPowerConversion,

cryptocurrencyMultiStepConversion

content.items.fundingMethods.amount

number<double>

Amount funded.

content.items.fundingMethods.amountInFiat

number<double>

Amount in fiat.

content.items.fundingMethods.toSymbol

string | null

Symbol purchased.

content.items.fundingMethods.fromAmount

number<double>

Amount used.

content.items.fundingMethods.fromSymbol

string | null

Symbol used.

content.items.fundingMethods.paymentMethodType

enum<string>

Payment method type

Available options:

card,

bankAccount,

digitalWallet,

unknown

content.items.fundingMethods.fee

object

Fee of funding.

Show child attributes

content.items.fundingMethods.fee.fee

number<double>

The amount of the fee.

content.items.fundingMethods.fee.feeCurrency

string | null

The currency of the fee. Does not match the currency of the transfer in some cases.

content.items.fundingMethods.fee.feeInFiat

number<double>

The value of the fee converted to the fiat currency.

content.items.fundingMethods.fee.feeInTransferCurrency

number<double>

The value of the fee converted to the transfer currency.

content.items.refundAddress

string | null

Transfer Refund Address.

content.items.bridgingDetails

object

Bridging operation details.

Show child attributes

content.items.bridgingDetails.status

enum<string>

Available options:

recordCreated,

registeredInProvider,

sourceTransferStarted,

inReview,

providerAwaitingSourceTransfer,

providerFundsReceived,

providerProcessingPayment,

providerProcessedPayment,

providerSetUndeliverable,

returned,

refundRegisteredInProvider,

providerAwaitingSourceRefundTransfer,

providerRefundFundsReceived,

providerProcessingRefundPayment,

providerProcessedRefundPayment,

refunded,

canceled,

failed

content.items.bridgingDetails.statusDescription

string | null

content.items.bridgingDetails.targetSide

object

Show child attributes

content.items.bridgingDetails.targetSide.networkName

string | null

content.items.bridgingDetails.targetSide.symbol

string | null

content.items.bridgingDetails.targetSide.amount

number<double>

content.items.bridgingDetails.targetSide.transactionHash

string | null

content.items.bridgingDetails.targetSide.infoUrl

string<uri> | null

content.items.bridgingDetails.sourceSide

object

Show child attributes

content.items.bridgingDetails.sourceSide.networkName

string | null

content.items.bridgingDetails.sourceSide.symbol

string | null

content.items.bridgingDetails.sourceSide.amount

number<double>

content.items.bridgingDetails.sourceSide.transactionHash

string | null

content.items.bridgingDetails.sourceSide.infoUrl

string<uri> | null

content.items.bridgingDetails.timeline

object[] | null

Show child attributes

content.items.bridgingDetails.timeline.eventType

string | null

content.items.bridgingDetails.timeline.description

string | null

content.items.bridgingDetails.timeline.timestamp

integer<int64>

content.total

integer<int32>

Total number of items

Get deposit addresses Get holdings.

⌘I

Managed Account Authentication

Managed Transfers

Portfolio

Balance

Verify

Transfers to/from User's Linked Account

Get transfers initiated by Mesh

Authorizations

Query Parameters

Response