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

# Sales

`GET /v1/reporting/transactions` lists sales for your account, plus net commission totals for the whole date window.

## Date windows

Pass `start_date` and `end_date` as ISO 8601 datetimes:

* Omit both to default to the **last 30 days** ending now.
* Provide **both** or **neither** — a single bound returns `400`.
* Maximum window is **90 days**.
* Offset-aware values (e.g. `2026-08-01T00:00:00-04:00`) are converted to UTC. Naive values are treated as UTC.
* Responses echo the resolved window as UTC (`...Z`).

## Pagination

Results are newest-first. Use `page` (1-indexed) and `limit` (1–100, default 20). Each response includes `total_count`, `has_more`, and a `summary` for the full window (not just the current page).

Commission amounts are **your net share** after Channel3's take rate. See [Commissions](/docs/commissions.md) for how payouts work.

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
import Channel3 from "@channel3/sdk";

const client = new Channel3();

const transactions = await client.reporting.transactions.list({
  start_date: "2026-07-01T00:00:00Z",
  end_date: "2026-07-31T23:59:59Z",
  user_id: "ABCD", // optional
});

console.log(transactions.summary);
// { total_count, total_commission, pending_commission, paid_commission }

for (const txn of transactions.items) {
  console.log(
    txn.purchased_at,
    txn.status,
    txn.commission_amount,
    txn.brand_name,
  );
}
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
from channel3_sdk import Channel3

client = Channel3()

transactions = client.reporting.transactions.list(
    start_date="2026-07-01T00:00:00Z",
    end_date="2026-07-31T23:59:59Z",
    user_id="ABCD",  # optional
)

print(transactions.summary)
for txn in transactions.items:
    print(txn.purchased_at, txn.status, txn.commission_amount, txn.brand_name)
```

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.trychannel3.com/v1/reporting/transactions?start_date=2026-07-01T00:00:00Z&end_date=2026-07-31T23:59:59Z&user_id=ABCD" \
  -H "x-api-key: $CHANNEL3_API_KEY"
```

Each sale includes `order_amount`, `commission_amount`, `status`, `purchased_at`, `brand_name`, optional `user_id`, optional geo (`city` / `country`), and a compact `product` when we can match one.

Pass `user_id` to limit the list to one person. See [By user](/docs/guides/reporting/by-user.md).

## Status

| Status | Meaning |
| - | - |
| `pending` | Not yet paid out — includes network-approved commissions waiting on the retailer's return window |
| `paid` | Commission has been paid out |

The summary breaks out `pending_commission` and `paid_commission`, and `total_commission` is their sum.


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