# Get a Saved Analytics Chart

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

Gets a saved chart: its title, description, version, query and chart config. To a caller who may not read every dataset, a chart that reads a dataset they may not read, or is refused for a reason that might name one, answers NOT_FOUND, as an id no chart has.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `chartId` | path | string | yes |  |

## Responses

### 200 — The chart

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

**`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. |

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

### 404 — NOT_FOUND

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/{chartId}' \
  -H "Authorization: Bearer $SUGER_TOKEN"
```

### Response — 200

```json
{
  "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
  }
}
```

### Error — 401

```json
{
  "error": "string"
}
```

---

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