Introducing the Human Design Chart Image API (SVG)

What shipped

The Human Design API now returns a rendered Visual Chart alongside the chart data. One request to POST /v2/visual-charts returns the full chart data you already get from /v2/charts, plus a new top-level svgRenderUrl field you can drop straight into an <img> tag. It is live now.

The goal has not changed: integrate accurate Human Design Chart data and visuals into your app or platform with ease through our API. You already had the data. Now you get the rendered chart too, with no client-side rendering code to write.

What's new

• Fast, edge-rendered. Rendered at the edge for high performance and low latency.
• Stateless and private. No PII stored; HMAC-signed render tokens carry only chart activations.
• Drop-in SVG. An svgRenderUrl you style in an <img> tag or CSS background-image.
• Your own branding. Create a branded chart style in the template editor.

How it works

Two new endpoints render a Visual Chart: POST /v2/visual-charts and POST /v2/visual-charts/coordinates. The request body is identical to POST /v2/charts, so nothing about how you call the API changes.

The response is the same chart envelope with one addition: svgRenderUrl is a top-level sibling of data, not a field inside it.

{
  "timestamp": "2026-03-24T12:00:00.000Z",
  "success": true,
  "message": "Chart generated",
  "type": "ChartResult",
  "data": {
    "type": "Generator",
    "profile": "6/2",
    "centers": ["G", "Sacral", "Spleen", "Throat"],
    "authority": "Sacral"
  },
  "svgRenderUrl": "https://render.humandesignapi.nl/1f0c8b3a-....svg?t=eyJ..."
}

To render a Human Design chart as an SVG image, take that URL and embed it. There is no client-side JavaScript and no build step:

<img src="https://render.humandesignapi.nl/1f0c8b3a-....svg?t=eyJ..." alt="My Human Design chart" />

The URL serves image/svg+xml and works just as well as a CSS background-image. For the full treatment, including caching notes and the coordinates variant, see the guide on how to render your own Visual Chart.

Stateless and private by design

The render URL is a signed capability, not a lookup into a database of your users. Nothing about your request, the render token, or the rendered chart is stored on our servers. Here are the specifics:

• HMAC-SHA-256 signed. Every render token is signed and verified at the edge before anything renders. Any edit to the token invalidates the signature and the render is refused, so it is tamper-evident.
• No identity PII in the token. The signed payload is exactly the chart's gate and center activations (design, personality, centers). It carries no name, birthdate, birthtime, location, coordinates, or account id.
• Nothing persisted per chart. All render state travels in the signed URL. The edge holds only a 24 hour cache of your chart style, never the chart itself.

One caveat worth stating plainly: a render URL does not expire and cannot be revoked, so anyone holding it can view that chart's render. Treat it like a secret if the chart should stay private. The guide's Security and Data Handling section covers this in full.

Your own branding

Want a different look? Build a branded chart style in the template editor. Every Visual Chart you request afterwards renders with that style, and the URL shape stays exactly the same, so nothing in your integration code has to change.

Pick colors, toggle labels, adjust layout. The editor saves a style your svgRenderUrl picks up on every future render.

Try it

You can see a Visual Chart render before you build anything. The demo on the homepage runs a live Visual Trial and renders the SVG right there, no signup and no API key required.

When you are ready to integrate: Available on Developer plans and up. See Plans & Credits for the full breakdown.

Get started

Two links get you building. The render guide walks through the request, the svgRenderUrl field, and every way to embed it. The API Reference documents the full request/response contract for POST /v2/visual-charts and POST /v2/visual-charts/coordinates.

Visual Charts are in Public Beta, so behavior may change before GA. We'd love your feedback: info@appdebock.nl.

Keep reading

• Guide: How to Render an Interactive Human Design Chart with SVG and JavaScript (much more complex, but offers full customization)
• API Reference: the POST /v2/visual-charts endpoint
• Plans and credits