Skip to main content
GET
/
api
/
v1
/
withdraw
/
list
curl -X GET 'https://api.visionwallet.com.br/api/v1/withdraw/list?limit=50&offset=0&status=COMPLETED' \
  -H 'X-API-Key: sua_api_key'

{
  "success": true,
  "data": {
    "withdraws": [
      {
        "id": "withdraw_abc123",
        "correlationID": "mistic_transaction_id",
        "value": 10000,
        "status": "COMPLETED",
        "pixKey": "usuario@example.com",
        "description": "Saque para conta pessoal",
        "metadata": {},
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "total": 1,
      "limit": 50,
      "offset": 0,
      "hasMore": false
    },
    "statistics": {
      "total": 1,
      "completed": 1,
      "pending": 0,
      "failed": 0,
      "totalValue": 10000
    }
  }
}

​
Listar Saques

Liste todos os saques do usuário com opções de filtro e paginação. 
curl -X GET 'https://api.visionwallet.com.br/api/v1/withdraw/list?limit=50&offset=0&status=COMPLETED' \
  -H 'X-API-Key: sua_api_key'

{
  "success": true,
  "data": {
    "withdraws": [
      {
        "id": "withdraw_abc123",
        "correlationID": "mistic_transaction_id",
        "value": 10000,
        "status": "COMPLETED",
        "pixKey": "usuario@example.com",
        "description": "Saque para conta pessoal",
        "metadata": {},
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "total": 1,
      "limit": 50,
      "offset": 0,
      "hasMore": false
    },
    "statistics": {
      "total": 1,
      "completed": 1,
      "pending": 0,
      "failed": 0,
      "totalValue": 10000
    }
  }
}

​
Parâmetros

​
status
string
Filtrar por status: PENDING, COMPLETED, FAILED.
​
limit
integer
default:"50"
Número máximo de resultados a retornar (máximo 100).
​
offset
integer
default:"0"
Número de resultados a pular (para paginação).

​
Campos da Resposta

​
withdraws
array
Lista de saques do usuário.
​
pagination
object
Informações de paginação incluindo total de registros e se há mais páginas.
​
statistics
object
Estatísticas resumidas dos saques, incluindo totais por status e valores.

​
Permissões Necessárias

Esta rota requer a permissão read:withdraws.

​
Rate Limiting

  • 10 req/s (600 req/min) por API Key
Esta rota possui cache de 60 segundos para melhorar a performance.

Authorizations

​
X-API-Key
string
header
required

API Key para autenticação. Use o header X-API-Key ou Authorization: Bearer {api_key}

Query Parameters

​
status
enum<string>
Available options:
PENDING,
COMPLETED,
FAILED
​
limit
integer
default:50
​
offset
integer
default:0

Response

200

Lista de saques