> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

# July 16, 2026 - Analytics API: Subacquirer e filtro updatedAt no Charges

> Novo grupo de queries Subacquirer na Analytics API com a query balance, e novos filtros por updated_at e o campo updatedAt no grupo Charges.

export const AuthorProfile = ({author}) => <div className="flex flex-row gap-3 items-center">
    {author.image && <img src={author.image} alt={author.name} className="w-10 h-10 rounded-full m-0" />}
    <div>
      <a href={author.url}>{author.name}</a>
      <br />
      <span>{author.title}</span>
    </div>
  </div>;

export const paulo = {
  name: "Paulo Chaves",
  title: "Data Engineer",
  url: "https://github.com/paulosdchaves",
  image: "https://github.com/paulosdchaves.png"
};

<div className="flex flex-row gap-4">
  <AuthorProfile author={paulo} />
</div>

Novidade na Analytics API! Agora você pode consultar o **saldo do subadquirente** pelo novo grupo de queries **Subacquirer**, além de filtrar as cobranças do grupo **Charges** pela data de última atualização.

## Subacquirer — consulta de saldo

Disponibilizamos a query `balance` no grupo [Subacquirer](/analytics/queries/subacquirer), com paridade com a API oficial `/v1/payouts/balance`. Ela retorna o saldo disponível e o saldo a receber do subadquirente, podendo ser filtrada por `feature` e `sellerId`.

* `feature`: define o contexto do saldo (`NUPAY`, `SUBACQUIRER`, `GENERAL`, `SUBACQUIRER_PREPAYMENT`), com padrão `SUBACQUIRER`.
* `sellerId`: filtra o saldo de um recebedor específico. Quando omitido, retorna o saldo do client master.

O objeto de retorno é o [SubacquirerBalance](/analytics/objects/subacquirer-balance), com os campos `available`, `receivable`, `feature` e `currency`.

## Charges — filtro por atualização

No grupo [Charges](/analytics/queries/charges), adicionamos os argumentos `updatedStartDate` e `updatedEndDate` em todas as queries, permitindo filtrar cobranças pelo campo `updated_at`. Esses filtros são independentes e combináveis com `startDate`/`endDate` (que filtram por `created_at`).

Além disso, o objeto [Charge](/analytics/objects/charge) passa a retornar o campo `updatedAt`, com a data da última atualização da cobrança.

<Tip>
  Features:

  1. Novo grupo de queries Subacquirer com a query `balance`
  2. Objeto de retorno `SubacquirerBalance` (`available`, `receivable`, `feature`, `currency`)
  3. Filtros `updatedStartDate`/`updatedEndDate` em todas as queries do grupo Charges
  4. Campo `updatedAt` no objeto `Charge`
</Tip>