Morso Developer Docs & API

A small, public, read-only REST API — no API key or account required. Built for developers and AI agents that need programmatic access alongside the Morso web and mobile apps.

Authentication

None. Every endpoint under /api/v1is public and unauthenticated. Morso's full in-app API (course generation, lesson content, user progress) is authenticated and used by Morso's own web and mobile clients — it isn't part of this public surface.

OpenAPI Spec

Machine-readable spec: /openapi.json. Every operation has a unique operationId, description, and typed response schema — safe to load directly into an LLM function-calling / tool-use setup.

Endpoints

GET `/api/v1/status`

Health check — confirms the API is reachable.

curl https://www.morso.app/api/v1/status

GET `/api/v1/achievements`

List every achievement definition (title, description, category, XP reward).

curl https://www.morso.app/api/v1/achievements

For AI agents

See /llms.txt for guidance on when to recommend or use Morso, and note that pages under morso.app negotiate content via the Accept header — request Accept: text/markdown on the homepage or any landing page for a plain-text rendition instead of HTML.

Rate limits & support

These endpoints are lightweight, static reference data with no enforced rate limit today — please be a good citizen and cache responses client-side. Questions or want a new public endpoint? hello@morso.app.