# Quarter to goal (gauge chart)

> One number against its goal: a half-doughnut gauge with the attainment on the arc and the amounts in the strip.

This chart is one Chart-Output API request. Send the request below to `POST https://www.chart-output.com/api/v1/render` with an `Authorization: Bearer <API key>` header and the response is the image. The free plan includes 1,000 renders a month, no card.

- Page: https://www.chart-output.com/gallery/quarter-to-goal
- Request as JSON: https://www.chart-output.com/gallery/quarter-to-goal/spec.json
- Get a free API key: https://www.chart-output.com/auth/sign-up?ref=gallery-quarter-to-goal-md

## When to pick it

Use it for a single "how far to goal" number in a weekly digest, a Slack post or a report cover.

## The data it takes

Columns: Item, Value. 2 to 2 rows. Two rows: what you have so far, then the goal. In $ thousands, or in dollars.

## The request

Change the content (title, labels, numbers, KPI values, annotations) and keep the rest.

```json
{
  "type": "doughnut",
  "width": 560,
  "height": 640,
  "textScale": 1.8,
  "format": "png",
  "devicePixelRatio": 2,
  "legend": {
    "display": true,
    "position": "top",
    "style": "square",
    "fontSize": 13
  },
  "dataLabels": true,
  "data": {
    "labels": ["Closed so far", "Left to goal"],
    "datasets": [
      {
        "label": "Goal",
        "data": [112, 38],
        "backgroundColor": ["#3c5cdd", "#e3e7ef"],
        "borderWidth": 0
      }
    ]
  },
  "options": {
    "rotation": -90,
    "circumference": 180,
    "cutout": "66%",
    "plugins": {
      "tooltip": {
        "enabled": false
      },
      "datalabels": {
        "anchor": "center",
        "align": "center",
        "offset": 0,
        "color": ["#ffffff", "rgba(255,255,255,0)"],
        "font": {
          "size": 22,
          "weight": "700"
        },
        "numberFormat": {
          "share": "total",
          "style": "percent"
        }
      }
    }
  },
  "kpiStrip": [
    {
      "label": "Of goal",
      "value": "75%",
      "color": "#1d2640"
    },
    {
      "label": "Closed so far",
      "value": "$112k",
      "color": "#1d2640"
    },
    {
      "label": "Q4 goal",
      "value": "$150k",
      "color": "#1d2640"
    }
  ],
  "footer": {
    "left": "Source: CRM",
    "borderTop": true
  },
  "header": {
    "title": "Quarter to goal",
    "subtitle": "Q4 closed-won against goal, $ thousands",
    "logoUrl": "https://www.chart-output.com/gallery/acme-logo.png",
    "logoHeight": 22
  },
  "theme": {
    "backgroundColor": "#ffffff",
    "textPrimary": "#1d2640",
    "textSecondary": "#4a5368",
    "gridColor": "#e3e7ef",
    "mode": "light"
  }
}
```

## Questions

### How do I make this quarter to goal chart with my own data?

Paste your numbers into the box on this page and the chart and its request update. To make it from your own workflow, send that request to POST https://www.chart-output.com/api/v1/render with a free API key; the response is the image.

### What data does it take?

Columns: Item, Value. 2 to 2 rows. Two rows: what you have so far, then the goal. In $ thousands, or in dollars.

### Can ChatGPT or Claude make this chart?

Yes. Add https://www.chart-output.com/mcp as a custom connector and ask for the chart; its render_chart tool takes this page's request and returns the image, with no API key. Or use "Copy prompt for your AI" on this page.

### What does it cost?

The free plan includes 1,000 renders a month, with no card. Paid plans add more renders and remove the watermark.

### What do I get back?

A finished image: PNG by default, or SVG, WebP or JPEG, and PDF on Pro. Set "format" in the request.
