Saques

Consultar saque

GET/api/v1/withdrawals/{id}

Devolve um saque da sua conta pelo número. Permissão: Criar/consultar saques.

Parâmetros

idinteiro (no caminho)obrigatório

O id que veio ao criar o saque.

Exemplo

curl https://app.grinnypay.com/api/v1/withdrawals/482 \
  -H "Authorization: Bearer $GRINNY_KEY"

Resposta 200

{
  "id": 482,
  "status": "concluido",
  "valor": 15000,
  "taxa": 367,
  "total_debitado": 15367,
  "destino": { "tipo": "chave_pix", "chave": "[email protected]" },
  "motivo": null,
  "criado_em": "2026-10-15T14:40:00-03:00",
  "concluido_em": "2026-10-15T14:40:12-03:00"
}

Campos explicados em O objeto saque. Saque que não existe (ou é de outra conta): 404 nao_encontrado.

Exemplos de resposta de erro

{
  "erro": {
    "codigo": "nao_encontrado",
    "mensagem": "Saque não encontrado."
  }
}