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

# Vendas

> Listar as vendas do projeto com filtros e ver o detalhe de cada uma

## Listar vendas

```
GET /financial/bff/project/transaction?projectId={projectId}
```

Devolve as vendas do projeto em páginas. Os filtros são os mesmos da tela de **Vendas** do painel e vão como parâmetros na URL:

| Parâmetro | Descrição |
| - | - |
| `projectId` | **Obrigatório.** Projeto das vendas. |
| `limit`, `offset` | Paginação: quantas vendas por página e quantas pular. |
| `startDate`, `endDate` | Período de criação da venda. |
| `updatedAtStartDate`, `updatedAtEndDate` | Período da última atualização. Use para buscar só o que mudou desde a última consulta: pagamentos aprovados, reembolsos, chargebacks. |
| `status` | `paid`, `pending`, `waiting_payment`, `refunded`, `refused`, `chargedback`, `chargedback_refunded`, `pix_expired`, `request_refund`, `sent_to_refund`, `refunded_by_client`. |
| `paymentTypes` | `CREDIT`, `PIX`, `BANK_SLIP`. |
| `offerTypes` | `ENTRY`, `UPSELL`, `DOWNSELL`, `ORDERBUMP`. |
| `products`, `offers`, `funnels` | IDs de produtos, ofertas e funis. |
| `clientEmail`, `clientDocument`, `nameEmailClient` | Busca por e-mail, CPF/CNPJ ou nome/e-mail do comprador. |
| `utmSource`, `utmMedium`, `utmCampaign`, `utmTerm`, `utmContent`, `src` | Origem da venda. |

```bash curl theme={null}
curl "https://bff.assiny.com.br/v1/public/financial/bff/project/transaction?projectId=SEU_PROJECT_ID&status=paid&startDate=2026-11-01T00:00:00-03:00&endDate=2026-11-01T23:59:59-03:00&limit=50&offset=0" \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "ProjectId: SEU_PROJECT_ID"
```

> [!NOTE]
>
> Para manter o seu banco em dia, consulte por `updatedAtStartDate` e `updatedAtEndDate` a partir da última execução e pagine com `limit` e `offset` até acabar. Assim você pega também as vendas antigas que mudaram de status.

## Detalhe de uma venda

```
GET /financial/bff/sale/details/{transactionId}
```

Dados completos da venda: status, valores (`amount`, `amountWithTax`), forma de pagamento e parcelas, comprador (nome, e-mail, telefone, CPF), produto e oferta, funil, UTMs, cupom, frete, endereço, order bumps e, se for assinatura, o `subscriptionId`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.