List transfers

Lists quoted transfers and reconciled inbound deposits in deterministic createdAt/id descending order. Filters are customerId, public state, method, direction, origin, source-or-destination accountId, quoteId, exact externalId, createdAt range, and updatedAfter (the missed-webhook recovery path).

List transfers

cURL

curl --request GET \
  --url https://platform.swipelux.com/v3/transfers \
  --header 'X-API-Key: <api-key>'

200

{
  "data": [
    {
      "id": "<string>",
      "origin": "quoted",
      "customerId": "<string>",
      "openTaskIds": [
        "<string>"
      ],
      "method": "<string>",
      "direction": "fiat_to_stablecoin",
      "state": "awaiting_funds",
      "stateDetail": {
        "code": "<string>",
        "message": "<string>",
        "actor": "customer",
        "retryable": true
      },
      "amounts": {
        "in": {
          "amount": "<string>",
          "currency": "<string>",
          "network": "polygon"
        },
        "out": {
          "amount": "<string>",
          "currency": "<string>",
          "network": "polygon"
        },
        "settled": {
          "amount": "<string>",
          "currency": "<string>"
        }
      },
      "fees": [
        {
          "beneficiary": "developer",
          "amount": "<string>",
          "currency": "<string>",
          "rule": {
            "fixed": "<string>",
            "bips": 123
          }
        }
      ],
      "source": {
        "type": "external"
      },
      "destination": {
        "type": "account",
        "id": "<string>"
      },
      "references": {
        "returnedTransferId": "<string>",
        "transactionHash": "<string>",
        "traceNumber": "<string>",
        "imad": "<string>",
        "uetr": "<string>",
        "explorerUrl": "<string>"
      },
      "instructions": {
        "type": "bank",
        "method": "ach",
        "amount": {
          "amount": "<string>",
          "currency": "<string>"
        },
        "details": {},
        "accountHolderName": "<string>",
        "bankName": "<string>",
        "reference": {
          "value": "<string>",
          "required": true
        },
        "localAmount": {
          "amount": "<string>",
          "currency": "<string>"
        },
        "expiresAt": "<string>"
      },
      "timestamps": {
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "fundsReceivedAt": "<string>",
        "completedAt": "<string>",
        "failedAt": "<string>",
        "returnedAt": "<string>",
        "settledAt": "<string>"
      },
      "quoteId": "<string>",
      "capabilityId": "<string>",
      "sender": {
        "name": "<string>",
        "bankName": "<string>",
        "accountLast4": "<string>"
      },
      "institutionId": "<string>",
      "externalId": "<string>",
      "memo": "<string>",
      "supportingDocuments": [
        "<string>"
      ]
    }
  ],
  "nextCursor": "<string>",
  "hasMore": true
}

Authorizations

X-API-Key · string · header · required

Query Parameters

cursor · string

limit · integer

customerId · string

state · enum<string>

Filter by transfer state. Closed enum — exhaustive; additions would be a breaking change.

Available options: awaiting_funds, processing, action_required, completed, failed, canceled

method · string

Filter by movement method. Open enum — values are added over time; clients must tolerate unknown values.

direction · enum<string>

Filter by transfer direction. Closed enum — exhaustive; additions would be a breaking change.

Available options: fiat_to_stablecoin, stablecoin_to_fiat, stablecoin_move

quoteId · string

externalId · string

origin · enum<string>

Filter by transfer origin. Open enum — values are added over time; clients must tolerate unknown values.

Available options: quoted, inbound_deposit

accountId · string

Match transfers whose source or destination is this account.

Pattern: ^acc_[a-zA-Z0-9]+$

createdAfter · string

createdBefore · string

updatedAfter · string<date-time>

Return only records updated at or after this RFC 3339 timestamp. Use it to recover from missed webhooks by replaying a window of changes.

Response

200

application/json

Transfers returned

data · object[] · required

Show child attributes

nextCursor · string | null · required

hasMore · boolean · required