---
title: "Get Earnings History"
method: GET
path: "/creator/earnings"
tags: ["creator"]
---

# Get Earnings History

`GET /creator/earnings`

## Request

- Base URL: `https://studio-api.meganova.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://studio-api.meganova.ai/creator/earnings`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Get earnings history for current user.

## Query parameters

- `page` integer
- `page_size` integer
- `status` string, nullable
- `source_type` string, nullable

## Response `200`

Successful Response

- CreatorEarningResponse[]
  - `id` string, uuid, required
  - `creator_id` string, uuid, required
  - `source_type` string, required
  - `source_id` string, uuid, nullable
  - `gross_amount` string, required
  - `platform_fee` string, required
  - `net_amount` string, required
  - `currency` string, required
  - `status` string, required
  - `hold_until` string, date-time, nullable
  - `attributed_user_id` string, uuid, nullable
  - `attribution_window_days` integer, required
  - `original_transaction_id` string, nullable
  - `description` string, nullable
  - `created_at` string, date-time, required
  - `approved_at` string, date-time, nullable
  - `paid_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `c683584f6060`: 3 info
  - the `items/gross_amount` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `items/net_amount` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `items/platform_fee` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`

[Operation history](https://skmtc.dev/meganova/apis/meganova-api/changes/creator/earnings/get.md)

---

[API](https://skmtc.dev/meganova/apis/meganova-api.md) - [All operations](https://skmtc.dev/meganova/apis/meganova-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meganova/apis/meganova-api/revisions/c683584f6060?raw)