Skip to main content
GET
/
api
/
payouts
/
transfer
/
{transfer_id}
Get a transfer
curl --request GET \
  --url https://business.madhousewallet.com/api/payouts/transfer/{transfer_id} \
  --header 'Authorization: Bearer <token>'
{
  "transfer": {
    "id": "507f1f77bcf86cd799439011",
    "type": "payout",
    "amount": 1000,
    "currency": "EUR",
    "status": "processing",
    "status_label": "Deposit received — processing",
    "recipientId": 12345678,
    "recipient": {
      "id": 12345678,
      "accountHolderName": "Jane Doe",
      "currency": "EUR",
      "type": "iban",
      "country": "DE",
      "details": {
        "legalType": "PRIVATE",
        "iban": "DE89370400440532013000"
      }
    },
    "customerUuid": "550e8400-e29b-41d4-a716-446655440000",
    "customerEmail": "user@example.com",
    "sourceToken": "usdc",
    "sourceNetwork": "base",
    "quote": {
      "sourceAmount": 1000,
      "providerCharge": 2,
      "serviceFeePercent": 1.5,
      "targetCurrency": "EUR",
      "usdToTargetRate": 0.9183,
      "targetAmount": 915.28,
      "transferFee": 0.58,
      "estimatedDelivery": "2026-03-26T15:52:37Z"
    },
    "wallet_address": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
    "error": null,
    "refund_tx_hash": null,
    "reference": "507f1f77bcf86cd799439011",
    "timestamp": "2026-03-22T14:30:00.000Z",
    "updated_at": "2026-03-22T14:32:00.000Z"
  }
}

Authorizations

Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer mw_live_<keyId>_<secret>

Path Parameters

transfer_id
string
required

The transfer_id returned by POST /api/payouts/transfer

Example:

"507f1f77bcf86cd799439011"

Response

Transfer found

transfer
object
required