RevenueCat Chart Options

GET /v1/revenuecat/charts/:chartName/options

Returns the available configuration options for a specific chart — resolutions, segments, and filters. Use this before calling the Chart Data endpoint to discover valid parameter values.

Requires a RevenueCat secret API key (sk_xxx). This is a lightweight metadata call (1 credit).

Path Parameters

Name	Type	Required	Description
chartName	string	Yes	Chart identifier (see Available Charts)

Headers

Name	Type	Required	Description
X-RC-Key	string	Yes	Your RevenueCat secret API key (starts with `sk_`)
X-RC-Project	string	No	RevenueCat project ID. Auto-detected if you have one project.

Code Examples

curl -X GET "https://api.appeeky.com/v1/revenuecat/charts/revenue/options" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-RC-Key: sk_YOUR_REVENUECAT_SECRET_KEY"

const response = await fetch(
  "https://api.appeeky.com/v1/revenuecat/charts/revenue/options",
  {
    headers: {
      "X-API-Key": "YOUR_API_KEY",
      "X-RC-Key": "sk_YOUR_REVENUECAT_SECRET_KEY",
    },
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://api.appeeky.com/v1/revenuecat/charts/revenue/options",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "X-RC-Key": "sk_YOUR_REVENUECAT_SECRET_KEY",
    },
)

data = response.json()
print(data)

Response

{
  "data": {
    "resolutions": [
      { "id": "day", "display_name": "Daily" },
      { "id": "week", "display_name": "Weekly" },
      { "id": "month", "display_name": "Monthly" },
      { "id": "quarter", "display_name": "Quarterly" },
      { "id": "year", "display_name": "Yearly" }
    ],
    "segments": [
      { "id": "app", "display_name": "App" },
      { "id": "country", "display_name": "Country" },
      { "id": "product_identifier", "display_name": "Product" },
      { "id": "store", "display_name": "Store" },
      { "id": "offering", "display_name": "Offering" }
    ],
    "filters": [
      {
        "id": "app",
        "display_name": "App",
        "values": [
          { "id": "app8845704621", "display_name": "My App (App Store)" }
        ]
      },
      {
        "id": "country",
        "display_name": "Country",
        "values": [
          { "id": "US", "display_name": "United States" },
          { "id": "GB", "display_name": "United Kingdom" }
        ]
      }
    ]
  }
}

Response Fields

Resolutions

Available time granularity options for the chart’s resolution parameter.

Field	Type	Description
id	string	Resolution identifier (pass to chart)
display_name	string	Human-readable name

Segments

Available dimensions to segment chart data by. Pass the id as the segment query parameter.

Field	Type	Description
id	string	Segment identifier (pass to chart)
display_name	string	Human-readable name

Filters

Available filter dimensions and their possible values.

Field	Type	Description
id	string	Filter dimension identifier
display_name	string	Human-readable name
values	array	Available values for this filter

Each filter value:

Field	Type	Description
id	string	Value identifier (use in filter JSON)
display_name	string	Human-readable name

Use the options response to build dynamic filter UIs or validate parameters before requesting chart data. The available options vary per chart — for example, the churn chart may support different segments than the revenue chart.

Errors

Status	Code	When
400	MISSING_RC_KEY	`X-RC-Key` header not provided
400	INVALID_CHART_NAME	Chart name is not one of the valid options
401	UNAUTHORIZED	Invalid RevenueCat API key
404	RESOURCE_MISSING	Project not found or Charts not enabled

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

AI Visibility

Search & Discovery

Market Intelligence

RevenueCat

App Store Connect

Google Play Console

Apple Search Ads

Growth Channels

Reference

Path Parameters

Headers

Code Examples

Response

Response Fields

Resolutions

Segments

Filters

Errors

​Path Parameters

​Headers

​Code Examples

​Response

​Response Fields

​Resolutions

​Segments

​Filters

​Errors

Path Parameters

Headers

Code Examples

Response

Response Fields

Resolutions

Segments

Filters

Errors