← Back

Developers

The guide as data: every dimension and skill, in fourteen languages, as public JSON — and the brand beside it. No key, no sign-up, no rate plan. The licence ships in every payload: it is Inner Development Goals', and it is linked below.

Resources

GET /api/v1/

Discovery: the language list and every resource with its checksum and size, so a download verifies against nothing but this index.

Try it →

GET /api/v1/guides

The whole guide — five dimensions, twenty-five skills, text keyed by language on every node, all fourteen languages at once.

Try it →

GET /api/v1/guides/{lang}

One language, the same shape with the text filtered — one schema to learn, never two. cy, de, en, es, fr, it, nl, pt, sv, tr, ar, ja, sn, fi.

Try it →

GET /api/v1/brand

The palette — the five dimension colours and the three secondary colours, with print values — and the thirty marks as SVG and PNG at four sizes, a checksum on each.

Try it →

The shapes

Real excerpts, generated from the same bytes as the API — they cannot drift from what you receive.

Guide

/api/v1/guides/en, first dimension, first skill. Every skill carries a stable anchor and a url into the reading pages; the language carries its official PDF and release date.

{
  "api_version": 1,
  "content_version": 2,
  "content_published_at": "2026-10-01",
  "language": "en",
  "index_url": "https://idg.guide/api/v1/",
  "brand_url": "https://idg.guide/api/v1/brand",
  "documentation_url": "https://idg.guide/developers/",
  "license": {
    "attribution": "The Inner Development Guide is published by Inner Development Goals · innerdevelopmentgoals.org",
    "publisher_url": "https://innerdevelopmentgoals.org",
    "documents_url": "https://idg.guide/translations/",
    "name": "CC BY-NC-ND 4.0 for non-commercial, unmodified use; other uses under the Inner Development Goals Public Licenses",
    "cc_url": "https://creativecommons.org/licenses/by-nc-nd/4.0/",
    "terms_url": "https://drive.google.com/file/d/1qkxeweJy6ZOB-LGX2xD3MdgVCRuOmXMq/view",
    "note": "The guide text is the Inner Development Goals' own words, transcribed verbatim from the published guides. Keep this attribution with any use, and do not edit the text for style — corrections only against the source documents."
  },
  "languages": [
    {
      "code": "en",
      "native_name": "English",
      "rtl": false,
      "type": "official",
      "released_at": "2025-10-14",
      "pdf_url": "https://idg.guide/official/en.pdf?download=Inner%20Development%20Guide%20%28English%29%202025-10-14.pdf"
    }
  ],
  "dimensions": [
    {
      "key": "being",
      "code": "B",
      "order": 1,
      "color": "#d4b88c",
      "url": "https://idg.guide/dimensions/#being",
      "text": {
        "en": {
          "title": "Being",
          "subtitle": "Cultivating Our Inner Life",
          "description": "Deepening our awareness of inner experiences and their dynamic relationship with the world around us nurtures embodied presence, clarity of purpose, and thoughtful responses when we face complexity."
        }
      },
      "skills": [
        {
          "code": "B1",
          "anchor": "inner-compass",
          "url": "https://idg.guide/skills/#inner-compass",
          "text": {
            "en": {
              "title": "Inner Compass",
              "description": "A deeply felt commitment to live and act in accordance with values and purposes that serve the good of the whole."
            }
          }
        }
      ]
    }
  ]
}

Index

/api/v1/, the first entry of each list. Each resource's sha256 is the checksum of its exact bytes.

{
  "api_version": 1,
  "content_version": 2,
  "content_published_at": "2026-10-01",
  "index_url": "https://idg.guide/api/v1/",
  "brand_url": "https://idg.guide/api/v1/brand",
  "documentation_url": "https://idg.guide/developers/",
  "license": {
    "attribution": "The Inner Development Guide is published by Inner Development Goals · innerdevelopmentgoals.org",
    "publisher_url": "https://innerdevelopmentgoals.org",
    "documents_url": "https://idg.guide/translations/",
    "name": "CC BY-NC-ND 4.0 for non-commercial, unmodified use; other uses under the Inner Development Goals Public Licenses",
    "cc_url": "https://creativecommons.org/licenses/by-nc-nd/4.0/",
    "terms_url": "https://drive.google.com/file/d/1qkxeweJy6ZOB-LGX2xD3MdgVCRuOmXMq/view",
    "note": "The guide text is the Inner Development Goals' own words, transcribed verbatim from the published guides. Keep this attribution with any use, and do not edit the text for style — corrections only against the source documents."
  },
  "languages": [
    {
      "code": "cy",
      "native_name": "Cymraeg",
      "rtl": false,
      "type": "official",
      "released_at": "2026-02-11",
      "pdf_url": "https://idg.guide/official/cy.pdf?download=Inner%20Development%20Guide%20%28Welsh%29%202026-02-11.pdf"
    }
  ],
  "resources": [
    {
      "path": "/api/v1/guides",
      "url": "https://idg.guide/api/v1/guides",
      "sha256": "bc30522985e81933b14ce14e13fc9122d744bf9256b9fbccca897df5d2368822",
      "bytes": 124340
    }
  ]
}

Brand

/api/v1/brand, the first colour of each palette and the first mark. Join to the guide by dimension key and skill code.

{
  "api_version": 1,
  "content_version": 2,
  "content_published_at": "2026-10-01",
  "index_url": "https://idg.guide/api/v1/",
  "brand_url": "https://idg.guide/api/v1/brand",
  "documentation_url": "https://idg.guide/developers/",
  "license": {
    "attribution": "The Inner Development Guide is published by Inner Development Goals · innerdevelopmentgoals.org",
    "publisher_url": "https://innerdevelopmentgoals.org",
    "name": "CC BY-NC-ND 4.0 for non-commercial, unmodified use; other uses under the Inner Development Goals Public Licenses",
    "cc_url": "https://creativecommons.org/licenses/by-nc-nd/4.0/",
    "terms_url": "https://drive.google.com/file/d/1qkxeweJy6ZOB-LGX2xD3MdgVCRuOmXMq/view",
    "note": "The colours, shapes and names are elements of the IDG Framework, which the licence forbids modifying in anything adapted and shared: use the marks and colours as they are."
  },
  "colors": {
    "dimensions": [
      {
        "key": "being",
        "code": "B",
        "name": "Being",
        "hex": "#d4b88c",
        "rgb": [
          212,
          184,
          140
        ],
        "cmyk": [
          15,
          26,
          51,
          0
        ],
        "pantone": "467 C"
      }
    ],
    "secondary": [
      {
        "name": "Light Grey",
        "hex": "#FAF7F5",
        "rgb": [
          250,
          247,
          245
        ],
        "cmyk": [
          1,
          2,
          2,
          0
        ],
        "pantone": "Cool Grey 1"
      }
    ]
  },
  "icons": {
    "sizes": [
      64,
      128,
      256,
      512
    ],
    "files": [
      {
        "kind": "dimension",
        "key": "being",
        "code": "B",
        "color": "#d4b88c",
        "svg": {
          "url": "https://idg.guide/api/v1/brand/icons/being.svg",
          "sha256": "d9e43b1d5a5f97a4f6e98100c8bd7c7262e21e5a8a65f5583b739e61e3636fee",
          "bytes": 342
        },
        "png": {
          "64": {
            "url": "https://idg.guide/api/v1/brand/icons/being-64.png",
            "sha256": "73c6382515ec55179724ea34277ee3dfd58f7fe054c91be5bdeb8bfc6435870a",
            "bytes": 1733
          },
          "128": {
            "url": "https://idg.guide/api/v1/brand/icons/being-128.png",
            "sha256": "9b6e30f6ff8d134ec00bcfe81373c2720a85c5ad44248aa1b18ff62a3aebdb26",
            "bytes": 3395
          },
          "256": {
            "url": "https://idg.guide/api/v1/brand/icons/being-256.png",
            "sha256": "defee316192c3fa0656c205e859a22b797c1aae6a1e28aae89ae1347f5ed3592",
            "bytes": 7204
          },
          "512": {
            "url": "https://idg.guide/api/v1/brand/icons/being-512.png",
            "sha256": "a80251bca1d49ca8d436de2bada3f5da255b72d56ecdb9c35468b1e1143712c6",
            "bytes": 15250
          }
        }
      }
    ]
  }
}

Fields

  • On every resource. api_version; content_version and content_published_at, which move together and date the corpus; index_url, brand_url and documentation_url; license — attribution, publisher_url, and the licence by name, cc_url and terms_url. Dates are ISO 8601 calendar dates, every _url is absolute https, every response is UTF-8.
  • Languages. code is ISO 639-1 (pt is Brazilian Portuguese — pt-BR where BCP 47 matters); native_name; rtl; type is official (Inner Development Goals' own document), community (not official: reviewed and approved by a community of the language's speakers, named in approved_by with approved_at — Finnish today) or ai, so read it before calling a text official; released_at and pdf_url are the guide document's. A per-language resource names its language and lists that one entry; the whole list is the index's.
  • Guide. dimensions[].key is the permanent identifier and order its position; code the guide's own short code on dimensions and skills (B, B1 … A5); color the dimension's sRGB hex, identical in light and dark; anchor a permanent slug from the skill's English title, also the fragment on its url; text keyed by language on every node.
  • Index. resources[]: path, url, language on the per-language ones, sha256 and bytes.
  • Brand. colors.dimensions[] and colors.secondary[] as hex, rgb, cmyk and pantone, the guide's brand page transcribed — do not dim or restyle them per theme. icons.files[]: kind, key or code, svg (the original) and png by size, each with url, sha256, bytes. The marks are Inner Development Goals' under the same attribution as the text — use them as they are. The wordmark and the IDG logo are not here.

Open to browsers and assistants

Three rules