---
title: "Consultar saldo do seller"
method: GET
path: "/v2/seller/{sellerId}/balance"
tags: ["Seller"]
---

# Consultar saldo do seller

`GET /v2/seller/{sellerId}/balance`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/v2/seller/{sellerId}/balance`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/v2/seller/:sellerId/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

Retorna o saldo atual do seller. Quando futureAmount=true, também retorna o saldo futuro.

## Path parameters

- `sellerId` string, required

## Query parameters

- `futureAmount` boolean

## Headers

- `X-Token-Api` string, required
- `Content-Type` 'application/json'

## Response `200`

Saldo do seller retornado com sucesso

- SellerBalanceResponse
  - `amount` number, double: Saldo atual do seller
  - `futureAmount` number, double: Saldo futuro do seller; presente apenas quando o parâmetro futureAmount=true

## Other responses

- `202`: Solicitação aceita, processamento em andamento
- `400`: Erro de validação
- `401`: Token inativo ou inexistente
- `403`: Acesso negado
- `422`: Erro de processamento
- `429`: Muitas requisições
- `500`: Erro interno do servidor

---

[API](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)