Developers

Public API

The entire solution catalogue as an open, static JSON file – no sign-up, no tracking.

1 · Overview

Swiss IT Navigator exposes its complete, curated catalogue of digitally sovereign open-source solutions as a public, read-only JSON API. The data is generated at build time on Swiss infrastructure (RZO Gais) and served as a static file – there is no server-side runtime, no database, and no collection of personal data.

2 · Endpoint

GEThttps://swissitnavigator.ch/api/v1/solutions.json

SPEC/api/v1/openapi.json · OpenAPI 3.1 ↗ Explorer

There is exactly one endpoint. It returns the whole directory in a single response.

3 · Access & terms of use

No authentication: No API key, no token, no login.
CORS: Access-Control-Allow-Origin: * – usable directly from the browser.
Caching: Browser cache 1 hour, CDN/proxy 24 hours (s-maxage). Please respect it.
Rate limit: No hard limit; fair use expected. Cache rather than poll.
Freshness: Regenerated on every deployment (typically daily), incl. current GitHub stars.

4 · Response structure

The response is an object with metadata and the solutions array:

Field	Type	Description
`version`	`number`	API schema version (currently 1).
`generatedAt`	`string`	ISO 8601 timestamp of the build that produced this file.
`count`	`number`	Number of solutions in the array.
`license`	`string`	Licence of the dataset (MIT).
`homepage`	`string`	Canonical project homepage.
`solutions`	`Solution[]`	Array of solution objects (see below).

5 · Solution object

Each entry in the solutions array has the following fields:

Field	Type	Description
`name`	`string`	Display name of the solution.
`category`	`string`	One of the fixed category names (e.g. "DevOps", "Storage").
`description`	`string`	German description (source of truth).
`descriptionEn`	`string`	English description.
`descriptionFr`	`string?`	French description (optional).
`descriptionIt`	`string?`	Italian description (optional).
`license`	`string`	OSI/SPDX licence identifier (e.g. "MIT", "AGPL-3.0").
`deployment`	`string[]`	Subset of "kubernetes" \| "docker" \| "linux".
`audience`	`string[]`	Subset of "business" \| "private" — who realistically uses this solution.
`complexity`	`number`	1–10 · setup & deployment effort (lower = simpler).
`maturity`	`number`	1–10 · project stability & production-readiness (higher = more mature).
`resourceUsage`	`number`	1–10 · RAM/CPU footprint (lower = lighter).
`maintenance`	`number`	1–10 · day-to-day operational overhead (lower = less).
`tags`	`string[]`	Free-form tags, incl. "<product>-alternative" markers.
`github`	`string`	Source repository URL (GitHub or GitLab).
`website`	`string`	Official project website URL.
`icon`	`string`	Emoji used as the solution icon.
`origin`	`string`	Geographic origin label (e.g. "🇨🇭 Schweiz", "🌍 International").
`addedAt`	`string`	ISO date (YYYY-MM-DD) the solution was added to the catalogue.
`stars`	`number \| null`	GitHub stars at build time; null if unavailable.

6 · Examples

Shell (curl + jq)

curl -s https://swissitnavigator.ch/api/v1/solutions.json | jq '.count'

JavaScript (fetch)

const res = await fetch('https://swissitnavigator.ch/api/v1/solutions.json')
const { solutions } = await res.json()

// e.g. all low-maintenance Kubernetes-ready options
const easy = solutions.filter(
  (s) => s.deployment.includes('kubernetes') && s.maintenance <= 3
)

Example response (truncated)

{
  "version": 1,
  "generatedAt": "2026-06-05T08:00:00.000Z",
  "count": 123,
  "license": "MIT",
  "homepage": "https://swissitnavigator.ch",
  "solutions": [
    {
      "name": "Gitea",
      "category": "DevOps",
      "description": "Gitea ist ein selbstgehosteter Git-Service …",
      "descriptionEn": "Gitea is a self-hosted Git service …",
      "license": "MIT",
      "deployment": ["kubernetes", "docker", "linux"],
      "audience": ["business", "private"],
      "complexity": 2,
      "maturity": 8,
      "resourceUsage": 2,
      "maintenance": 2,
      "tags": ["git", "ci-cd", "github-alternative"],
      "github": "https://github.com/go-gitea/gitea",
      "website": "https://gitea.io",
      "icon": "🐙",
      "origin": "🌍 International",
      "addedAt": "2026-05-17",
      "stars": 47000
    }
  ]
}

7 · Licence & attribution

The dataset is published under the MIT licence and may be used freely – including commercially. We appreciate attribution with a link to swissitnavigator.ch. The operators of linked projects are responsible for their own content.

Last updated: June 2026