Sign in
Charts V2

Query Chart Data

Queries chart data from ClickHouse based on the provided parameters. Returns time series data with optional breakdowns and filters. Requires charts:read scope.

post/v2/charts/data

Request body

application_idstring required

Application ID to query data for

y_axisstring required

Y-axis metric to display (e.g. netProceeds, newUsers, trialConversionRate). Must be an exact metric key from GET /v2/charts/definitions — e.g. proceeds charts use netProceeds, not proceeds.

x_axisstring required

X-axis dimension (e.g. purchaseDate, installDate). Must be an exact dimension key from GET /v2/charts/definitions.

breakdownstring nullable

Optional breakdown dimension (e.g. countryCode, placement)

date_interval'auto' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year' | 'totals'

Date interval for grouping (hour, day, week, month, quarter, year)

conversion_timeframe'd1' | 'd3' | 'd4' | 'd7' | 'd14' | 'd30' | 'd90'

Conversion timeframe for SDK events

includestring[]

Additional y-axis metrics to include in the response

paywall_idstring[]

Filter by paywall IDs

variant_idstring[]

Filter by variant IDs

experiment_idstring[]

Filter by experiment IDs

campaign_idstring[]

Filter by campaign IDs

country_codestring[]

Filter by country codes

product_idstring[]

Filter by product IDs

placementstring[]

Filter by placements

environmentstring[]

Filter by environment (SANDBOX, PRODUCTION)

storestring[]

Filter by store (APP_STORE, PLAY_STORE, STRIPE)

app_versionstring[]

Filter by app version

sdk_versionstring[]

Filter by SDK version

product_durationstring[]

Filter by product duration

billing_plan_typestring[]

Filter by App Store billing plan type (UP_FRONT, MONTHLY)

event_typestring[]

Filter by event type

sub_start_typestring[]

Filter by subscription start type

revenue_typestring[]

Filter by revenue type

auto_renew_statusstring[]

Filter by auto renew status

revenue_sourcestring[]

Filter by revenue source (Superwall, Your App)

max_data_pointsnumber

Maximum number of data points to return (default: 1000)

Response

Success

object'chart_data' required

Object type, always chart_data

request_idstring required

Unique identifier for this request

enriched_dataobject required

Enriched metadata for the response

Changes

No recorded changes to this endpoint across all 2 revisions of this API.