> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# RevenueCat Chart Options

> Discover available resolutions, segments, and filters for any RevenueCat chart

```
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](/docs/revenuecat-charts) endpoint to discover valid parameter values.

<Note>
  Requires a **RevenueCat secret API key** (`sk_xxx`). This is a lightweight metadata call (1 credit).
</Note>

## Path Parameters

| Name      | Type   | Required | Description                                                                         |
| --------- | ------ | -------- | ----------------------------------------------------------------------------------- |
| chartName | string | Yes      | Chart identifier (see [Available Charts](/docs/revenuecat-charts#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

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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"
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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);
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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)
  ```
</CodeGroup>

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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                   |

<Tip>
  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.
</Tip>

***

## 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    |