Skip to main content

API parameters

The chart endpoint accepts query parameters listed below.

Combine these parameters in your query string. For example:{...}

If you prefer not to construct the URL yourself, client libraries are available in many programming languages.

Supported parameters


  • Type: Javascript or JSON object
  • Required: yes
  • Parameter name: chart or c

Chart.js configuration object to render. This is the definition of the chart in Javascript or JSON format.

If you are sending a GET request, we recommend that you URL-encode your chart configuration. If not encoded, you will run into problems with special characters or syntax errors in your program. You may also use base64 encoding (see encoding).


  • Type: integer
  • Default: 500
  • Parameter name: width or w

Width of the image in pixels.


  • Type: integer
  • Default: 300
  • Parameter name: height or h

Height of the image in pixels.


  • Type: integer
  • Accepted values: 1 or 2
  • Default: 2

Device pixel ratio of the output. Image width and height are multiplied by this value. Defaults to 2.0 to ensure best image support on Retina devices.


This setting defaults to 2, meaning all images will be 2x width and height! To get an image that is exactly width*height, set devicePixelRatio to 1.


  • Type: string
  • Accepted values: rgb, hex, hsl, color names
  • Default: transparent
  • Parameter name: backgroundColor or bkg

Background of the chart canvas. Accepts rgb format (rgb(255,255,120)), colors (red), and URL-encoded hex values (%23ff00ff).


  • Type: string
  • Accepted values: 2, 3, 4, or any valid Chart.js version string
  • Default: 2.9.4
  • Parameter name: version or v

Chart.js version. Setting version to 4 enables latest stable Chart.js v4 support. Defaults to latest version of Chart.js v2.


  • Type: string
  • Accepted values: png, webp, jpg, svg, pdf, base64
  • Default: png
  • Parameter name: format or f

Format of your output.


  • Type: string
  • Accepted values: url or base64
  • Default: url

Encoding of your chart parameter.

Postman examples

We've put together a public Postman collection for the QuickChart API. View it here: