# Læreplanatlas

> A source-traceable atlas of what Norwegian curricula, textbooks and readers say about people, works and topics, 1739 to today. Read-only, no key needed.

## Connect an agent

- MCP (Streamable HTTP): https://laereplanatlas.no/mcp
- Claude Code: claude mcp add --transport http laereplanatlas https://laereplanatlas.no/mcp
- OpenAPI 3.1: https://laereplanatlas.no/api/v1/openapi.json
- Documentation: https://laereplanatlas.no/om/api/

## Using the data

- Every response names the published release in release_id. For a reproducible study, use release_url as the base address.
- Lists take limit and cursor. Continue until next_cursor is null, also past empty pages.
- Cite page_url when present, otherwise url.
- A quote shows what a source says, not what was taught. A title in a table of contents shows that a text is listed.
- Null means unavailable in this release. Text under copyright is not available.
- Requests that miss the edge cache are limited to 60 per minute per client. HTTP 429 carries Retry-After.

## Operations

- search — GET https://laereplanatlas.no/api/v1/search: Search atlas entries and source passages. Entries come before passages. Follow next_cursor, also past empty pages.
- record — GET https://laereplanatlas.no/api/v1/record/{id}: One record: identifiers, aliases, dates, counts and related links. Old ids resolve and report redirected_from.
- entities — GET https://laereplanatlas.no/api/v1/entities: Browse people, works, topics, places or beings. kind is required so no request scans the whole catalogue.
- hierarchy — GET https://laereplanatlas.no/api/v1/hierarchy/{kind}: The topic or place tree as rows with a parent id.
- timeline — GET https://laereplanatlas.no/api/v1/timeline/{id}: One record across every plan, including plans where it was searched for and not found. state separates found, searched-and-absent and not examined.
- plans — GET https://laereplanatlas.no/api/v1/plans: All curricula with their dating and coverage.
- plan — GET https://laereplanatlas.no/api/v1/plan/{id}: One curriculum: editions and copies, prescribed reading lists, subject coverage, topics and legal basis.
- plan_findings — GET https://laereplanatlas.no/api/v1/plan/{id}/findings: Findings in one plan, with quote, page, coding and explicit absences.
- in_force — GET https://laereplanatlas.no/api/v1/in-force: Periods when each plan was in force.
- findings — GET https://laereplanatlas.no/api/v1/findings: Findings for an entity or a source, optionally by subject, stage or track. For one plan use plan_findings. entity or source is required so no request scans all findings.
- finding — GET https://laereplanatlas.no/api/v1/finding/{id}: One finding with quote, claim, location and every copy it appears in. Also accepts a member assertion id or a context finding id.
- context_findings — GET https://laereplanatlas.no/api/v1/context-findings: Findings in drafts and acts, not counted as plan findings. entity or source is required.
- mentions — GET https://laereplanatlas.no/api/v1/mentions/{id}: Plan, textbook and reader mentions of a record. Follow next_cursor, also past empty pages.
- sources — GET https://laereplanatlas.no/api/v1/sources: Registered curriculum source documents and their public links.
- source_pages — GET https://laereplanatlas.no/api/v1/pages/{source}: The pages of one source: scan sequence and printed page.
- page_text — GET https://laereplanatlas.no/api/v1/page/{source}/{sequence}: The text of one page. Text that may not be published is refused or returned as held.
- books — GET https://laereplanatlas.no/api/v1/books: Textbooks, readers and songbooks.
- textbook_contents — GET https://laereplanatlas.no/api/v1/textbook/{id}/contents: Published table of contents with printed pages and topic links. A title shows that a text is listed, not that it was taught.
- reader_texts — GET https://laereplanatlas.no/api/v1/reader-texts: Texts in readers, by author, by work, or the most reprinted. One of author, work or order=readers is required.
- library_text — GET https://laereplanatlas.no/api/v1/library/{book}/{page}: One page of a full-text library book. index returns the list of pages.
- songs — GET https://laereplanatlas.no/api/v1/songs: Songs in plans and songbooks, one initial letter at a time. Without letter, returns the letters and their counts.
- song — GET https://laereplanatlas.no/api/v1/song/{id}: One song: credits, plans and songbooks.
- list_collection — GET https://laereplanatlas.no/api/v1/collections/{collection}: List one collection: laws, library, questions, exam-years, exam-papers, schools, school-years, school-reads, classical-works, bible-stories, forgotten-gold.
- get_collection_item — GET https://laereplanatlas.no/api/v1/collections/{collection}/{id}: One item in a collection. Long nested lists are paged with limit and cursor.

## Collections

- laws: Education acts, with their copies and the plans issued under them.
- library: Full-text books in the library. Read the text with library_text.
- questions: Curated questions asked across all plans.
- exam-years: Exam tasks by year.
- exam-papers: Exam tasks by paper type.
- schools: Schools with their reported reading.
- school-years: One school in one year; the id is school:year.
- school-reads: Which schools read a person or work; the id is the atlas record id.
- classical-works: Latin and Greek works read in schools.
- bible-stories: Bible stories and the readers that retell them.
- forgotten-gold: Works once common in schools and rarely read now.