GET /v1/revenuecat/charts/:chartName/options
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) |
| 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"
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 |
| 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 |
