How to Render Your Own Chart

​

Why Render a Visual Chart

• 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

​

Request Format

curl -X POST https://api.humandesignapi.nl/v2/visual-charts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "HD-Geocode-Key: YOUR_GEOCODE_KEY" \
  -d '{
    "birthdate": "1990-01-15",
    "birthtime": "14:30",
    "location": "Amsterdam, The Netherlands"
  }'

​

Response: the svgRenderUrl field

{
  "timestamp": "2026-03-24T12:00:00.000Z",
  "success": true,
  "message": "Chart generated",
  "errorCode": "",
  "type": "ChartResult",
  "data": {
    "type": "Generator",
    "profile": "6/2",
    "centers": ["G", "Sacral", "Spleen", "Throat"],
    "strategy": "To Respond",
    "authority": "Sacral",
    ...
  },
  "svgRenderUrl": "https://render.appdebock.nl/1f0c8b3a-9d64-4a1e-b0f2-7c5ad2e91b83.svg?t=eyJ..."
}

​

Using the Render URL

​

As an <img> tag

<img
  src="https://render.appdebock.nl/1f0c8b3a-9d64-4a1e-b0f2-7c5ad2e91b83.svg?t=eyJ..."
  alt="My Human Design chart"
/>

​

As a CSS background image

.chart {
  background-image: url("https://render.appdebock.nl/1f0c8b3a-9d64-4a1e-b0f2-7c5ad2e91b83.svg?t=eyJ...");
}

​

Security & Data Handling

• Stateless. All render state travels in the signed URL. Nothing about your request, the render token, or the rendered chart is stored server-side. The edge holds a 24 hour cache of your chart style only.
• No PII. The signed token payload is exactly the chart’s gate and center activations (design, personality, centers). It carries no name, birthdate, birthtime, location, coordinates, or account id. The template id in the path is an opaque UUID.
• HMAC-signed. Tokens are signed with HMAC-SHA-256 and verified at the edge before anything renders. Any edit to the token invalidates the signature and the render is refused.
• Bearer link. A render URL is a capability: it does not expire and cannot be revoked. Anyone holding the URL can view that chart’s render. Treat it like a secret if the chart should stay private, and do not publish it where you would not publish the activations themselves.

​

Access Tier

​

API Reference

• POST /v2/visual-charts
• POST /v2/visual-charts/coordinates

​

Validation Errors