# List Saved Analytics Charts

`GET https://api.suger.cloud/ai/org/{orgId}/analytics/chart`

Lists the organization's saved charts, newest first, a page at a time. A chart over a dataset the caller may not read is left out, as if there were none; every page but the last is full.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `limit` | query | integer | no |  |
| `cursor` | query | string | no |  |

## Responses

### 200 — A page of charts

Content-Type: `application/json`

**`Response`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array<AnalyticsSavedChart> | yes |  |
| `nextCursor` | string or null | yes |  |
| `hasMore` | boolean | yes |  |

**`AnalyticsSavedChart`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes |  |
| `title` | string | yes |  |
| `description` | string | yes |  |
| `version` | integer | yes |  |
| `createdBy` | string or null | yes |  |
| `createdAt` | string | yes |  |
| `updatedAt` | string | yes |  |
| `query` | object | no | The chart's query; absent when the caller cannot read every dataset it reads. |
| `chart` | AnalyticsChartConfig | no |  |

**`AnalyticsChartConfig`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | no | The chart type; without it, the type the result's shape asks for. |
| `x` | string | no |  |
| `y` | object | no | The measure, or measures sharing one unit, to plot. |
| `series` | string | no | A dimension output; each of its values is drawn as its own series. |
| `size` | string | no |  |
| `value` | string | no |  |
| `path` | array<string> | no |  |
| `rows` | array<string> | no |  |
| `across` | array<string> | no |  |
| `columns` | array<string> | no |  |
| `labels` | object | no | Display names for outputs, by output name, each at most 200 characters; the model's labels otherwise. |
| `values` | boolean | no |  |
| `top` | number | no | Keep the N largest series, slices or points; at most seven, or ten slices of a pie, whose eighth to tenth are steps of the gray, each named on its slice. |
| `sort` | string | no |  |
| `highlight` | object | no | One series value, drawn in color while the rest are muted. |
| `target` | number | no | A goal, in the measure's unit. |
| `axis` | object | no |  |
| `stack` | object | no | Stack the parts end to end, or not; `percent` stacks a bar's parts as shares of its own total, its axis reading 0% to 100%. |
| `smooth` | boolean | no |  |
| `step` | boolean | no |  |
| `horizontal` | boolean | no |  |
| `lines` | array<string> | no |  |
| `totals` | boolean | no |  |
| `scale` | string | no |  |
| `range` | array<—> | no |  |
| `trend` | boolean | no |  |
| `period` | string | no | The period a number over a time breakdown shows: `whole`, the newest whole period (the default), or `newest`, the newest period, marked partial while it is. |
| `donut` | boolean | no |  |
| `show` | string | no |  |
| `bars` | array<string> | no |  |
| `search` | boolean | no | A table's search box, which keeps the rows a cell of which shows the text typed in it, in any case, and counts them. |

### 400 — INVALID_REQUEST: the cursor is not valid

Content-Type: `application/json` · Schema: `AnalyticsError`

**`AnalyticsError`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | object | yes |  |

### 401 — No valid token

Content-Type: `application/json` · Schema: `AiErrorResponse`

**`AiErrorResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | string | yes | Error message |

### 403 — Not a member of the organization

Content-Type: `application/json` · Schema: `AiErrorResponse`

**`AiErrorResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | string | yes | Error message |

### 422 — INVALID_REQUEST: the query string is not valid

Content-Type: `application/json` · Schema: `AnalyticsError`

**`AnalyticsError`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | object | yes |  |

### 500 — ANALYTICS_UNAVAILABLE: an unexpected failure

Content-Type: `application/json` · Schema: `AnalyticsError`

**`AnalyticsError`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | object | yes |  |

### 503 — ANALYTICS_UNAVAILABLE: analytics is not configured or not ready

Content-Type: `application/json` · Schema: `AnalyticsError`

**`AnalyticsError`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | object | yes |  |

## Example

_Generated from this operation's schema. Values are placeholders — substitute your own ids, and set `SUGER_TOKEN` to a bearer token from the [OAuth client-credentials exchange](https://doc.fours.com/settings/oauth-app/)._

### Request

```bash
curl -X GET 'https://api.suger.cloud/ai/org/{orgId}/analytics/chart' \
  -H "Authorization: Bearer $SUGER_TOKEN"
```

### Response — 200

```json
{
  "data": [
    {
      "id": "01H0000000000000000000",
      "title": "string",
      "description": "string",
      "version": 1,
      "createdBy": "string",
      "createdAt": "2026-01-31T12:00:00Z",
      "updatedAt": "2026-01-31T12:00:00Z",
      "query": {},
      "chart": {
        "type": "line",
        "x": "string",
        "y": "string",
        "series": "string",
        "size": "string",
        "value": "string",
        "path": [
          "string"
        ],
        "rows": [
          "string"
        ],
        "across": [
          "string"
        ],
        "columns": [
          "string"
        ],
        "labels": {},
        "values": true
      }
    }
  ],
  "nextCursor": "string",
  "hasMore": true
}
```

### Error — 400

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "diagnostics": [
      {
        "code": "INVALID_QUERY",
        "path": [
          "string"
        ],
        "message": "string",
        "fix": "string",
        "suggestions": [
          "string"
        ]
      }
    ],
    "parameter": "string"
  }
}
```

---

API reference: https://doc.fours.com/api/
