Get wallet transaction

Returns detailed information for one wallet transaction by public transaction ID, including settlement details when available. Use this endpoint to refresh known records or investigate reconciliation gaps.

GET /partner/wallets/transactions/{id}

Get wallet transaction

cURL

curl --request GET \
  --url https://api.stabyl.com/v1/partner/wallets/transactions/{id} \
  --header 'X-Api-Key: <api-key>'

200

{
  "data": {
    "amount": "99.50",
    "created_at": "2026-05-16T10:30:00Z",
    "currency": "USD",
    "description": "USD withdrawal via USDC",
    "failure_reason": null,
    "id": "0195f7cb-8af5-7f40-9f7c-f08f568d37aa",
    "rail": "crypto",
    "reference": "wd_20260516_001",
    "settlement_details": {
      "beneficiary_nickname": null,
      "block_number": null,
      "blockchain_tx_hash": null,
      "confirmations": null,
      "confirmed_at": null,
      "destination_address": "0xRecipient",
      "explorer_url": null,
      "failed_at": null,
      "network": {
        "chain": "evm",
        "chain_id": 8453,
        "display_name": "Base",
        "slug": "base",
        "token_standard": "erc20"
      },
      "network_display": "Base",
      "network_fee": null,
      "principal_amount": {
        "amount": "99.50",
        "currency": "USDC"
      },
      "rail_reference": "wd_20260516_001",
      "sender_address": null,
      "type": "crypto"
    },
    "settlement_rail": "USDC",
    "status": "processing",
    "tx_type": "withdrawal",
    "updated_at": "2026-05-16T10:31:00Z"
  },
  "status": "success"
}

Use wallet transactions as the reconciliation source of truth. Withdrawals initiated from Stabyl Pro can appear in this timeline.

Authorizations

X-Api-Key · string · header · default: sb_test_your_key · required

API key. Send it in the X-Api-Key header.

Path Parameters

id · string · required

Public wallet transaction ID returned by the transaction list endpoint.

Response

200

application/json

Transaction detail

data · object · required

Detailed wallet transaction record with settlement information where available.

Show child attributes

Example:

{
  "amount": "99.50",
  "created_at": "2026-05-16T10:30:00Z",
  "currency": "USD",
  "description": "USD withdrawal via USDC",
  "failure_reason": null,
  "id": "0195f7cb-8af5-7f40-9f7c-f08f568d37aa",
  "rail": "crypto",
  "reference": "wd_20260516_001",
  "settlement_details": {
    "beneficiary_nickname": null,
    "block_number": null,
    "blockchain_tx_hash": null,
    "confirmations": null,
    "confirmed_at": null,
    "destination_address": "0xRecipient",
    "explorer_url": null,
    "failed_at": null,
    "network": {
      "chain": "evm",
      "chain_id": 8453,
      "display_name": "Base",
      "slug": "base",
      "token_standard": "erc20"
    },
    "network_display": "Base",
    "network_fee": null,
    "principal_amount": { "amount": "99.50", "currency": "USDC" },
    "rail_reference": "wd_20260516_001",
    "sender_address": null,
    "type": "crypto"
  },
  "settlement_rail": "USDC",
  "status": "processing",
  "tx_type": "withdrawal",
  "updated_at": "2026-05-16T10:31:00Z"
}

status · enum<string> · required

Available options: success