---
title: "Get Creator Dashboard"
method: GET
path: "/api/dashboard/creator"
tags: ["Creator Dashboard", "dashboard"]
---

# Get Creator Dashboard

`GET /api/dashboard/creator`

Get complete creator dashboard data.

Returns all data needed to render the creator dashboard in a single call,
optimized for performance with aggregated queries.

## Response `200`

Successful Response

- CreatorDashboardResponse — Complete dashboard data in single response.
  - `channel` ChannelSummary, required
    - `id` integer, required
    - `channel_id` string, required
    - `channel_name` string, required
    - `thumbnail_url` string, nullable, required
    - `subscriber_count` integer, required
    - `tier` string, required
    - `category` string, required
    - `youtube_analytics_connected` boolean, required
    - `videos_count` integer, required
    - `optimized_count` integer, required
    - `active_optimizations` integer, required
  - `trial` TrialStatus, required — T5-1 (BILLING_RULES.md §13): trial-state info for the dashboard. `status` is one of: - None / 'active' (legacy non-trial OR completed-trial creator) - 'trial_awaiting_invoice' (signed up, no advisory yet) - 'trial_card_pending' (advisory issued, 5-day window open) - 'trial_lapsed' (card not added in time; new opts blocked) `days_remaining` is positive when in trial_card_pending and counts down from 5; null otherwise. `terminal_at` is set when smart-retry exhausted (T4-7).
    - `status` string, nullable
    - `trial_started_at` string, date-time, nullable
    - `advisory_invoice_id` integer, nullable
    - `advisory_invoice_issued_at` string, date-time, nullable
    - `card_added_at` string, date-time, nullable
    - `trial_lapsed_at` string, date-time, nullable
    - `days_remaining` integer, nullable
    - `terminal_at` string, date-time, nullable
    - `billing_paused` boolean
  - `billing` BillingSummary, required
    - `total_paid_all_time` string, required
    - `pending_invoices_count` integer, required
    - `pending_invoices_amount` string, required
    - `estimated_next_invoice` string, required
    - `last_payment_amount` string, nullable, required
    - `last_payment_date` string, date-time, nullable, required
    - `payment_method` object, nullable, required
  - `forecast` RevenueForecast, required
    - `next_30_days` string, required
    - `next_60_days` string, required
    - `next_90_days` string, required
  - `rpm_history` RPMHistoryPoint[], required
    - `date` string, date, required
    - `rpm` string, required
  - `top_videos` VideoSummary[], required
    - `id` integer, required
    - `youtube_video_id` string, required
    - `title` string, required
    - `thumbnail_url` string, nullable, required
    - `published_at` string, date-time, nullable, required
    - `current_views` integer, required
    - `baseline_views` integer, required
    - `incremental_views` integer, required
    - `state` string, required
    - `optimization_status` string, nullable, required
    - `last_optimized_at` string, date-time, nullable, required
    - `excluded` boolean
    - `confidence` number, nullable
    - `queue` string, nullable
    - `applied_at` string, date-time, nullable
    - `original_title` string, nullable
    - `optimized_title` string, nullable
    - `original_description` string, nullable
    - `optimized_description` string, nullable
    - `original_tags` unknown
    - `optimized_tags` unknown
    - `original_thumbnail_url` string, nullable
    - `optimized_thumbnail_url` string, nullable
    - `reverted_at` string, date-time, nullable
    - `optimization_cycles` object[]
  - `total_videos` integer, required
  - `total_incremental_views` integer, required
  - `total_revenue_generated` string, required
  - `success_rate` number, required
  - `pending_disputes` integer, required
  - `unread_notifications` integer, required

---

[API](https://skmtc.dev/primetime/apis/primetime-media-api.md) · [All operations](https://skmtc.dev/primetime/apis/primetime-media-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/primetime/primetime-media-api/revisions/9da9a9f64e11/schema)