---
title: "Retrieve Transfers"
method: GET
path: "/v1/instances/{instance_id}/transfers"
tags: ["Transfers"]
---

# Retrieve Transfers

`GET /v1/instances/{instance_id}/transfers`

## Path parameters

- `instance_id` string, required

## Query parameters

- `limit` '10' | '50' | '100' | '200' | '500' | '1000' — Number of items to return
- `offset` '0' | '10' | '50' | '100' | '200' | '500' | '1000' — Number of items to skip
- `starting_after` string — A cursor for use in pagination. starting_after is an object ID that defines your place in the list.
- `ending_before` string — A cursor for use in pagination. ending_before is an object ID that defines your place in the list.

## Response `200`

List transfers

- object
  - `data` TransferOut[], required
    - `id` string, required
    - `status` 'processing' | 'failed' | 'refunded' | 'completed', required — Transfer general status
    - `transfer_quote_id` string, required
    - `instance_id` string, required
    - `tracking_transaction_monitoring` object, required
      - `step` 'processing' | 'on_hold' | 'pending_review' | 'pending_refund_review' | 'completed', required — Transaction monitoring step
      - `blockchain_screening` number, nullable — Blindpay screening step
      - `risk_score` number, nullable — Risk score
      - `completed_at` string, nullable — Transfer transaction completed date
    - `tracking_paymaster` object, required
      - `step` 'processing' | 'on_hold' | 'pending_review' | 'pending_refund_review' | 'completed', required — Complete step
      - `transaction_hash` string, nullable — Complete transaction hash
      - `gas_fee` string, nullable — Gas fee related to transaction
      - `completed_at` string, nullable — Complete completed date
      - `error_message` string, nullable
    - `tracking_bridge_swap` object, required
      - `step` 'processing' | 'on_hold' | 'pending_review' | 'pending_refund_review' | 'completed', required — Complete step
      - `transaction_hash` string, nullable — Complete transaction hash
      - `gas_fee` string, nullable — Gas fee related to transaction
      - `completed_at` string, nullable — Complete completed date
      - `error_message` string, nullable
    - `tracking_complete` object, required
      - `step` 'processing' | 'on_hold' | 'pending_review' | 'pending_refund_review' | 'completed', required — Complete step
      - `transaction_hash` string, nullable — Complete transaction hash
      - `gas_fee` string, nullable — Gas fee related to transaction
      - `completed_at` string, nullable — Complete completed date
      - `error_message` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `image_url` string, uri, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `legal_name` string, nullable
    - `wallet_id` string, required
    - `sender_token` 'USDC' | 'USDT' | 'USDB', required
    - `sender_amount` number, required — 52.40 BRL needs to be sent in a pix transfer
    - `receiver_amount` number, required — 10.10 USDC
    - `customer_network` 'base' | 'sepolia' | 'arbitrum_sepolia' | 'base_sepolia' | 'arbitrum' | 'polygon' | 'polygon_amoy' | 'ethereum' | 'stellar' | 'stellar_testnet' | 'tron' | 'solana' | 'solana_devnet' | 'tempo' | 'tempo_testnet', required
    - `customer_token` 'USDC' | 'USDT' | 'USDB', required
    - `customer_wallet_address` string, required
    - `partner_fee_amount` number, nullable — 1.5 USDC
    - `external_id` string, nullable
    - `customer_id` string, required
    - `address` string, nullable
    - `network` 'base' | 'sepolia' | 'arbitrum_sepolia' | 'base_sepolia' | 'arbitrum' | 'polygon' | 'polygon_amoy' | 'ethereum' | 'stellar' | 'stellar_testnet' | 'tron' | 'solana' | 'solana_devnet' | 'tempo' | 'tempo_testnet', required
  - `pagination` PaginationMetadata, required
    - `has_more` boolean, required — Whether or not there are more elements available after this set.
    - `next_page` string, nullable — The ID of the first item in the next page of results.
    - `prev_page` string, nullable — The ID of the first item in the previous page of results.

## Other responses

- `400` — Possible error codes: `TRANSFERS_NOT_ENABLED`, `VALIDATION_FAILED`. See the Error responses section for retry semantics.
- `401` — Possible error codes: `AUTH_UNAUTHORIZED`. See the Error responses section for retry semantics.
- `403` — Possible error codes: `AUTH_FORBIDDEN`. See the Error responses section for retry semantics.
- `429` — Possible error codes: `AUTH_RATE_LIMITED`. See the Error responses section for retry semantics.
- `500` — Possible error codes: `INTERNAL_ERROR`. See the Error responses section for retry semantics.

---

[API](https://skmtc.dev/blindpay/apis/blindpay-api.md) · [All operations](https://skmtc.dev/blindpay/apis/blindpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blindpay/blindpay-api/revisions/470de27afb7b/schema)