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

# Get your revenue statement

> Your revenue share, month by month: one month, or the last 12.

Scope: `nft:orders`

Your revenue share, month by month: one month with `period`, or the last 12 months (newest first) without it. A sale counts in the month it was paid; a refund in the month it was refunded. Amounts in USD.

**The standard share is 3% of every pack opening.** Premier partners earn more. `share_pct` is the rate that applies to you.

**period** `string`

A month, `YYYY-MM`. Without it, the last 12 months.

## Response

**program** `string`

Your program.

**currency** `string`

`USD`.

**months** `object[]`

**month**

**period** `string`

`YYYY-MM`.

**orders** `integer`

Packs paid that month.

**gmv** `number`

Their price.

**share\_pct** `number`

Your share rate.

**share\_amount** `number`

What it earned on `gmv`.

**refunds** `object`

Refunds that month: `count`, their price (`gmv`), and the share they take back (`share_amount`).

**net\_gmv** `number`

After refunds.

**net\_share** `number`

After refunds: what you are owed for the month.

**payout** `object`

`status`: `open` (the month is still running), `due` (closed, owed and not paid yet), `paid` (with `amount`, `reference` and `paid_at`) or `none` (nothing owed).

## Errors

| Status | Code | When |
| - | - | - |
| `400` | `BAD_PERIOD` | `period` isn't `YYYY-MM` |

```bash cURL theme={null}
curl "https://catchbackcards.com/api/partner/v2/revenue?period=2026-11" \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 theme={null}
{
  "program": "okx",
  "currency": "USD",
  "months": [
    {
      "period": "2026-11",
      "orders": 412,
      "gmv": 18250,
      "share_pct": 3,
      "share_amount": 547.5,
      "refunds": { "count": 3, "gmv": 125, "share_amount": 3.75 },
      "net_gmv": 18125,
      "net_share": 543.75,
      "payout": { "status": "open", "amount": null, "reference": null, "paid_at": null }
    }
  ]
}
```


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