---
title: "List transfers"
method: GET
path: "/v1/payments/transfers"
tags: ["Payments"]
---

# List transfers

`GET /v1/payments/transfers`

Lists payment transfers for the authenticated organization or project scope.

## Query parameters

- `wallet` string — Filter by wallet `walletId`.
- `walletAddress` string — Filter by wallet address.
- `search` string — Search transfer ID, signature, provider reference, source or destination address, memo, counterparty ID, or counterparty display name. Use at least 3 non-whitespace characters; a blank value is treated as no search filter.
- `token` string — Filter by token symbol or mint.
- `direction` 'inbound' | 'outbound' — Filter by transfer direction.
- `status` string — Filter by transfer status. Accepts a comma-separated list of statuses.
- `category` 'wallet' | 'ramp' — Filter by wallet transfers or ramp transfers.
- `type` string — Filter by one or more comma-separated transfer types.
- `counterpartyId` string — Filter transfers tied to a specific counterparty.
- `provider` 'moonpay' | 'lightspark' | 'bvnk' | 'moneygram' | 'coinbase' | 'mural' | 'stripe' — Filter ramp transfers by provider.
- `providerReference` string — Provider quote or transaction reference. Must be supplied with provider for exact ramp transfer lookup.
- `from` string, date-time — Filter from timestamp.
- `to` string, date-time — Filter to timestamp.
- `includeObserved` 'true' | 'false' — When filtering a wallet, include RPC-observed on-chain activity that has not been recorded by SDP. Disable for stable database-backed pagination.
- `sortBy` 'createdAt' | 'updatedAt' | 'amount' | 'status' — Field used to sort the transfer list.
- `sortDirection` 'asc' | 'desc' — Sort direction.
- `page` integer — Page number (1-based).
- `pageSize` integer — Items per page.

## Headers

- `x-project-id` string — Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

## Response `200`

Transfer list

- object — Standard paginated response envelope.
  - `data` object[], required
    - `id` string, required — Transfer identifier (SDP record ID, not the on-chain signature).
    - `organizationId` string, required — Organization identifier.
    - `walletId` string, required — Source or receiving SDP wallet associated with the transfer.
    - `projectId` string — Project identifier for the transfer.
    - `type` 'transfer' | 'transfer_confidential' | 'transfer_batch' | 'onramp' | 'offramp', required — Transfer type.
    - `direction` 'inbound' | 'outbound', required — Transfer direction.
    - `status` 'pending' | 'processing' | 'confirmed' | 'finalized' | 'failed' | 'awaiting_payment' | 'settling' | 'completed' | 'canceled' | 'expired', required — Transfer status.
    - `signature` string, nullable, required — Solana transaction signature (tx id/hash).
    - `serializedTx` string, nullable, required — Base64-encoded transaction payload, if available.
    - `slot` integer, nullable, required — Slot number, if confirmed.
    - `blockTime` string, date-time, nullable, required — Block time, if confirmed.
    - `fee` integer, nullable, required — Transaction fee in lamports.
    - `error` string, nullable, required — Error message if the transaction failed.
    - `initiatedBy` object — Initiator that triggered the transfer.
      - `type` 'api_key' | 'user' | 'system', required — Initiator type.
      - `id` string — Initiator identifier if applicable.
      - `display` string — Human-friendly label for the initiator.
    - `source` string — Source wallet address.
    - `destination` string — Destination wallet address.
    - `memo` string — Optional memo for the transfer.
    - `rampsMemo` object, required — Free-form key-value memo for offchain reconciliation of ramp transfers. At most 20 entries.
    - `token` string — Token symbol or mint address.
    - `amount` string — Token amount in UI units (decimal string).
    - `provider` 'moonpay' | 'lightspark' | 'bvnk' | 'moneygram' | 'coinbase' | 'mural' | 'stripe' — Ramp provider for on-ramp and off-ramp transfer records.
    - `counterpartyId` string — Counterparty tied to the transfer record, when available.
    - `counterpartyDisplayName` string — Current display name of the counterparty tied to the transfer.
    - `providerReference` string — Provider quote or transaction reference used for ramp correlation.
    - `deliveryMode` 'hosted' | 'manual_instructions' | 'session_widget' — Ramp delivery mode. Hosted flows require the customer to complete a provider-hosted UI; manual instructions require the customer to fund displayed instructions; session widgets use a provider SDK session.
    - `fiatCurrency` string — Fiat currency for the ramp leg.
    - `fiatAmount` string — Fiat amount for the ramp leg when known.
    - `risk` object — Optional risk evaluation for the transfer.
      - `provider` string, required — Risk scoring provider.
      - `score` string, required — Provider-specific risk score.
      - `level` 'low' | 'medium' | 'high' | 'unknown', required — Risk level classification.
      - `evaluatedAt` string, date-time, required — Timestamp when risk was evaluated.
    - `moneygram` object — MoneyGram-specific details for MoneyGram ramp transfers.
      - `transactionId` string — MoneyGram xRamps transaction identifier.
      - `referenceNumber` string — Cash pickup reference number issued by MoneyGram.
      - `payoutAmount` number — Fiat payout amount reported by MoneyGram.
      - `payoutStatus` string — MoneyGram payout status.
      - `cryptoTransferId` string — SDP transfer id for the on-chain USDC leg.
      - `solanaTxSignature` string — Solana transaction signature for the USDC transfer.
      - `lastWidgetError` string — Last MoneyGram widget error recorded for this transfer.
    - `createdAt` string, date-time, required — Creation timestamp.
    - `updatedAt` string, date-time, required — Last update timestamp.
  - `meta` object, required — Pagination metadata.
    - `total` integer, required — Total items.
    - `page` integer, required — Current page number.
    - `pageSize` integer, required — Items per page.
    - `hasMore` boolean, required — Whether more pages exist.
    - `requestId` string, required — Request identifier for tracing.

## Other responses

- `401` — Error
- `403` — Error
- `500` — Error

---

[API](https://skmtc.net/solana/apis/solana-developer-platform-api.md) · [All operations](https://skmtc.net/solana/apis/solana-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solana/solana-developer-platform-api/revisions/672b1916ba61/schema)