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.
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_versionandcontent_published_at, which move together and date the corpus;index_url,brand_urlanddocumentation_url;license—attribution,publisher_url, and the licence byname,cc_urlandterms_url. Dates are ISO 8601 calendar dates, every_urlis absolute https, every response is UTF-8. - Languages.
codeis ISO 639-1 (ptis Brazilian Portuguese —pt-BRwhere BCP 47 matters);native_name;rtl;typeisofficial(Inner Development Goals' own document),community(not official: reviewed and approved by a community of the language's speakers, named inapproved_bywithapproved_at— Finnish today) orai, so read it before calling a text official;released_atandpdf_urlare the guide document's. A per-language resource names itslanguageand lists that one entry; the whole list is the index's. - Guide.
dimensions[].keyis the permanent identifier andorderits position;codethe guide's own short code on dimensions and skills (B,B1…A5);colorthe dimension's sRGB hex, identical in light and dark;anchora permanent slug from the skill's English title, also the fragment on itsurl;textkeyed by language on every node. - Index.
resources[]:path,url,languageon the per-language ones,sha256andbytes. - Brand.
colors.dimensions[]andcolors.secondary[]ashex,rgb,cmykandpantone, the guide's brand page transcribed — do not dim or restyle them per theme.icons.files[]:kind,keyorcode,svg(the original) andpngby size, each withurl,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
- Browsers. Responses carry
Access-Control-Allow-Origin: *, so a page on any site can call the API directly. Leave revalidation to the browser's cache and do not setIf-None-Matchyourself: our host drops the origin header from a 304, and the browser then rejects it. - AI assistants.
robots.txtallows/api/v1, so an assistant can read the guide when someone asks it to. The rules below apply to it too.
Three rules
- Keep to the licence. The guide and the marks are
Inner Development Goals' materials, under their
Public Licenses for Use of Materials.
Non-commercial use, unmodified, is
CC BY-NC-ND 4.0:
keep
license.attributionvisible wherever the words or marks appear, and do not edit the text or recolour the marks. Commercial use and any adaptation fall under other clauses of the same document, with conditions of their own — those are Inner Development Goals' to grant, and they are the ones to ask. /v1/is additive. Fields may appear; existing fields never change meaning or disappear. A breaking reshape would be/v2/, with/v1/kept serving. Language lives in the path, never in content negotiation — one URL, one representation, one ETag.- Be a polite client. Responses are good for an hour
(
Cache-Control: public, max-age=3600); after that ask withIf-None-Matchand take the 304, or in a browser let its cache do that for you. The guide changes a few times a year. Fetch on your server or at build time and serve your own users yourself — traffic shaped like every device calling here on every use may be limited.