{ "openapi": "3.0.1", "info": { "title": "Swiss Health Insurance Premiums Lookup (LAMal / KVG)", "description": "Official 2026 Swiss basic health insurance premiums for any canton, postal code or municipality, filtered by age group, deductible, accident cover and insurance model, sorted from cheapest to most expensive. Built on FOPH open data.", "version": "0.1", "x-build-id": "NWDLUe8INKooOOQni" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/najx~swiss-health-insurance-premiums/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-najx-swiss-health-insurance-premiums", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/najx~swiss-health-insurance-premiums/runs": { "post": { "operationId": "runs-sync-najx-swiss-health-insurance-premiums", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/najx~swiss-health-insurance-premiums/run-sync": { "post": { "operationId": "run-sync-najx-swiss-health-insurance-premiums", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "postalCode": { "title": "Postal code (NPA / PLZ)", "pattern": "^[1-9][0-9]{3}$", "type": "string", "description": "Four-digit Swiss postal code of the place of residence, e.g. 1003 for Lausanne. Resolves the canton and the premium region. If the postal code spans several regions, all of them are returned; pass municipalityBfs to disambiguate." }, "canton": { "title": "Canton", "enum": [ "AG", "AI", "AR", "BE", "BL", "BS", "FR", "GE", "GL", "GR", "JU", "LU", "NE", "NW", "OW", "SG", "SH", "SO", "SZ", "TG", "TI", "UR", "VD", "VS", "ZG", "ZH" ], "type": "string", "description": "Two-letter canton code. Used alone it returns every premium region of the canton unless region is set." }, "region": { "title": "Premium region", "minimum": 0, "maximum": 3, "type": "integer", "description": "Premium region within the canton (0 = single region; 1, 2 or 3 in BE, BL, FR, GR, LU, SG, SH, TI, VD, VS, ZH). Ignored when municipalityBfs is given." }, "municipalityBfs": { "title": "Municipality (BFS / OFS number)", "minimum": 1, "maximum": 9999, "type": "integer", "description": "Federal municipality number, e.g. 5586 for Lausanne. The most precise way to select the premium region, since the region is defined by the municipality of residence." }, "ageGroup": { "title": "Age group", "enum": [ "adult", "youngAdult", "child" ], "type": "string", "description": "child = 0-18, youngAdult = 19-25, adult = 26 and over (age reached during the premium year).", "default": "adult" }, "childRank": { "title": "Child rank (children only)", "minimum": 1, "maximum": 5, "type": "integer", "description": "1 for the first child. Some insurers publish sibling discounts (rank 3 and above); use 3 to see them.", "default": 1 }, "deductible": { "title": "Annual deductible (franchise) in CHF", "minimum": 0, "maximum": 2500, "type": "integer", "description": "Adults and young adults: 300, 500, 1000, 1500, 2000 or 2500. Children: 0, 100, 200, 300, 400, 500 or 600. Leave empty to get every deductible." }, "accidentCover": { "title": "Include accident cover", "type": "boolean", "description": "true if the person is NOT covered for accidents by an employer (working fewer than 8 hours a week, self-employed, child, student, retired). Employees working 8+ hours a week are covered by their employer and choose false.", "default": true }, "model": { "title": "Insurance model", "enum": [ "any", "standard", "familyDoctor", "hmo", "telmedOrOther" ], "type": "string", "description": "standard = free choice of doctor; familyDoctor = family doctor model (HAM); hmo = HMO practice; telmedOrOther = telemedicine and other alternative models (DIV); any = all models.", "default": "any" }, "insurers": { "title": "Only these insurers", "type": "array", "description": "Insurer names (case-insensitive substring, e.g. \"Assura\", \"CSS\", \"Helsana\") or FOPH insurer numbers (e.g. 1542). Leave empty for all insurers.", "items": { "type": "string" } }, "limit": { "title": "Maximum number of results", "minimum": 0, "type": "integer", "description": "Results are sorted from cheapest to most expensive; 0 returns all of them. Each result is one billable event.", "default": 0 }, "year": { "title": "Premium year", "minimum": 2026, "maximum": 2027, "type": "integer", "description": "Premium year. Only years shipped with this Actor version are available (see README).", "default": 2026 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }