Meridian — Integration Guide

Quickstart

The fastest path: hit any of the public endpoints below. No API key required for the Gold tier content. Authentication is only required for authenticated Koydo-user endpoints (Silver tier) and the ingest pipeline (Bronze tier).

curl https://koydo.app/api/meridian/v1/concept/pythagorean-theorem

curl -X POST https://koydo.app/api/meridian/resolve-batch \
  -H 'Content-Type: application/json' \
  -d '{"slugs":["pythagorean-theorem","photosynthesis","limits"]}'

curl 'https://koydo.app/api/meridian/next?concept=limits&learner_stage=high-school'

curl 'https://koydo.app/api/meridian/v1/search?q=mitochondria'

curl 'https://koydo.app/api/meridian/pathways?domain=D3&age_band=middle-school'

curl https://koydo.app/api/meridian/v1/contracts/1/flashcard

License — CC-BY-SA 4.0

All Meridian content (concept nodes, prerequisites, pathways, JSON-LD context, JSON Schemas, OpenAPI spec) is released under Creative Commons Attribution-ShareAlike 4.0 International (CC-BY-SA 4.0). You are free to share and adapt the material for any purpose, including commercially — provided you give appropriate credit and license derivatives under the same terms.

The license declaration is embedded in the JSON-LD @context of every response and published as a LICENSE file in the source tree. Machine clients can verify license compliance via the license field on any concept node.

Source

• Canonical content + engine: github.com/robertwaltos/koydo-platform/tree/master/src/lib/meridian-engine
• Resolver (semantic search + pathway planning): github.com/robertwaltos/koydo-platform/tree/master/src/lib/meridian-resolver
• JSON Schema contracts: github.com/robertwaltos/koydo-platform/tree/master/src/lib/ingest/meridian/schemas
• API route handlers: github.com/robertwaltos/koydo-platform/tree/master/src/app/api/meridian
• A dedicated github.com/Koydo/meridian monorepo mirror is planned for Q3 2026 to simplify downstream forks.

OpenAPI Reference

The OpenAPI 3.1 specification is served at /api/meridian/openapi.json. All responses are JSON + JSON-LD. Public endpoints return the Gold tier; authenticated endpoints (Koydo users) also see Silver tier.

See the full endpoint table on the main Meridian page for a quick-reference summary.

JSON-LD Context

Every Meridian response includes a @context that maps field names onto W3C-registered vocabularies (schema.org for general metadata; Koydo's own namespace at https://koydo.app/meridian/ns/v1 for curriculum-specific terms).

{
  "@context": "https://koydo.app/meridian/ns/v1",
  "@id": "https://koydo.app/meridian/concept/pythagorean-theorem",
  "license": "https://creativecommons.org/licenses/by-sa/4.0/",
  "slug": "pythagorean-theorem",
  "domain": "D1",
  "prerequisites": ["right-triangles", "algebra-basics"],
  "unlocks": ["trigonometry-basics", "distance-formula"],
  "canonical_uri": "https://koydo.app/meridian/concept/pythagorean-theorem",
  "quality_tier": "gold",
  "revision": 7
}

Integration Guide

Suggested integration path for a new consumer (edtech app, LMS, ministry platform, NGO deployment):

1. Hit GET /v1/index once at deploy to cache the global slug map.
2. For each user session, resolve the learner's current concept via GET /v1/concept/{slug}.
3. Use GET /api/meridian/next for the adaptive recommendation (can gate on learner stage, quality tier, and completion history).
4. Plan multi-week pathways via GET /api/meridian/pathways.
5. Validate any user-generated derivative content against the canonical JSON Schema at /v1/contracts/{ver}/{kind} before posting.
6. Subscribe to the changelog endpoint (or poll /v1/health) to know when to invalidate caches.

Deployment Guide (self-host)

CC-BY-SA 4.0 permits any party to mirror Meridian on their own infrastructure. Recommended path for ministries / NGOs:

1. Pull a snapshot of the canonical graph (bulk S3 export endpoint coming Q3).
2. Stand up the Meridian API — either the open-source Next.js route handlers, or the containerized image (ghcr.io/koydo/meridian:latest, coming Q3).
3. Configure your own issuer for W3C Verifiable Credentials (see below).
4. Set your localization layer on top — your country's national standards mapped onto canonical Meridian nodes.
5. Subscribe to the upstream changelog for periodic canonical-graph sync.
6. Contribute improvements back under CC-BY-SA 4.0. The share-alike clause keeps the ecosystem healthy.

For SLA-backed deployment support, localization work, and branded credential issuer infrastructure, see the Partners & Ministries section below.

Credential Issuer (W3C VC 2.0)

Meridian pairs with Koydo Badges, an issuer infrastructure for W3C Verifiable Credentials 2.0 + DID:web. Any learning milestone mapped to a Meridian concept node can be issued as a verifiable credential — portable across employers, institutions, and borders without a central authority.

• Issuer DID:web endpoint pattern: did:web:koydo.app
• Credential schema: W3C VC 2.0 with Koydo-specific `evidence` + `termsOfUse`
• Proof format: Ed25519Signature2020 (default) or BBS+ for selective disclosure
• Verification: public DID doc + JSON-LD signature suite
• Revocation: StatusList2021 (bitmap revocation registry)

JSON Schema Contracts

Every content kind (flashcard, video, simulation, mnemonic, story) has a canonical JSON Schema published at /v1/contracts/{ver}/{kind}. Clients validate before posting to the ingest pipeline. Schemas are versioned with immutable revision history.

Content Quality Tiers

Meridian segments content into quality tiers. Public endpoints only return Gold tier; Silver is Koydo-authenticated; Bronze is internal-only.

• Gold: peer-reviewed + ≥2 independent sources + concept-linked — public API, bulk export, free tier.
• Silver: concept-linked + ≥1 peer review — authenticated users.
• Bronze: JSON-Schema-validated at ingest — internal editorial.
• Retracted: tombstoned with replaced_by pointer when a successor exists.

Changelog

Every node carries a monotonically increasing revision counter, and the public endpoint GET /v1/health returns the snapshot freshness timestamp. A more granular per-concept history endpoint (/v1/concept/{slug}/history) is on the roadmap for Q3 2026.

Partners & Ministries

Koydo offers paid deployment, localization, W3C VC issuer infrastructure, and SLA-backed support for ministries, NGOs, and multilaterals that want to run Meridian on their own infrastructure.

• Apply for a partnership engagement
• General enquiries: admin@koydo.app
• For research collaborations, cite Meridian as: Koydo Meridian (2026). Canonical curriculum knowledge graph. CC-BY-SA 4.0. https://koydo.app/meridian

Scale at time of publication: 104 concepts · 14 domains · 8 ways of thinking · 20 languages (full RTL for Arabic & Urdu) · DPG-aligned.