Saltar al contenido principal
List Transfers
curl --request GET \
  --url https://api.spherepay.co/v2/transfer \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "payout_a1b2c3d4e5f6a7b8c9d0e1f2",
      "type": "on_ramp",
      "status": "succeeded",
      "customer": "customer_f31121c389624d3697cbf3ea8830b7a4",
      "externalId": "merchant_ref_123",
      "source": {
        "id": "bankAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
        "type": "bank_account"
      },
      "destination": {
        "id": "wallet_e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
        "type": "wallet",
        "currency": "usdc",
        "network": "sol",
        "amount": "498.50",
        "exchangeRate": "1.00"
      },
      "created": "2026-04-01T10:00:00.000Z",
      "updated": "2026-04-01T10:12:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrevious": false
  }
}
Usa este endpoint para recuperar todas las transferencias asociadas a tu cuenta de SpherePay. Puedes limitar los resultados por cliente, estado de la transferencia o tipo de transferencia. Los resultados están paginados — usa los parámetros page y limit para navegar por conjuntos de resultados grandes.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de consulta

page
string
predeterminado:1
requerido

Page number of the list (default: 1)

Ejemplo:

1

limit
string
predeterminado:10
requerido

Number of items per page (default: 10)

Ejemplo:

10

customer
string

Query by Customer ID.

Ejemplo:

"customer_123abc..."

status
enum<string>

Query by Payout status. See Transfer Lifecycle for status definitions.

Opciones disponibles:
pendingFunding,
pendingReview,
fundsReceived,
processing,
succeeded,
undeliverable,
returned,
pendingRefundInformation,
failed,
canceled,
refunded,
unexpectedError,
failedPrecondition,
expired
Ejemplo:

"succeeded"

type
enum<string>

Query by Payout type.

Opciones disponibles:
offRamp,
onChain,
onRamp,
microdeposit,
unmatchedDeposit
Ejemplo:

"onRamp"

Respuesta

data
object[]
requerido

Array of transfer objects.

Ejemplo:
[]
pagination
object
requerido
Última modificación el 18 de junio de 2026