find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/swisstopo:swisstopo-wmts-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Swisstopo WMTS API
  version: 1.6.2
  description: 'Operations tagged WMTS across 2 of this provider''s published API definitions: swissgeol-lexic-webmap-api.yaml, swisstopo-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://webmap-api.swissgeol.ch
  description: Swisstopo Production Server
- url: https://int-webmap-api.swissgeol.ch
  description: Swisstopo INT Server
- url: https://dev-webmap-api.swissgeol.ch
  description: Swisstopo DEV Server
security:
- ApiKeyAuth: []
tags:
- name: WMTS
  description: Endpoints to obtain WMTS layer source data
paths:
  /wmts:
    get:
      tags:
      - WMTS
      summary: Get WMTS source data for a layer
      description: WMTS endpoint that complies with the OGC WMTS standard, see at https://www.ogc.org/it/standards/wmts/. Returns WMTS source values for loading the configured layer in a map.
      parameters:
      - in: query
        name: layerId
        required: true
        schema:
          type: string
        description: Configured WebMap layer identifier.
        example: gc_bedrock
      responses:
        '200':
          description: WMTS layer source data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WmtsResponse'
              example:
                layerId: gc_bedrock
                source:
                  urlWMTS: https://dev-ogcservices.swissgeol.ch/geoserver/swisstopo/gc_bedrock/gwc/service/wmts?SERVICE=WMTS&VERSION=1.0.0&REQUEST=GetCapabilities
                  paramsWMTS:
                    layer: gc_bedrock
                    style: swisstopo:gc_bedrock
                    matrixSet: EPSG:2056
                    format: image/png
                  serverType: geoserver
                  crossOrigin: anonymous
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      operationId: getWmts
      x-operation-id-source: derived
    servers:
    - url: https://webmap-api.swissgeol.ch
      description: Swisstopo Production Server
    - url: https://int-webmap-api.swissgeol.ch
      description: Swisstopo INT Server
    - url: https://dev-webmap-api.swissgeol.ch
      description: Swisstopo DEV Server
components:
  schemas:
    WmtsParameters:
      type: object
      required:
      - layer
      - matrixSet
      - format
      properties:
        layer:
          type: string
          description: WMTS layer identifier passed to OpenLayers optionsFromCapabilities.
          example: gc_bedrock
        style:
          type: string
          description: WMTS style identifier passed to OpenLayers optionsFromCapabilities.
          example: swisstopo:gc_bedrock
        matrixSet:
          type: string
          description: Tile matrix set identifier.
          example: EPSG:2056
        format:
          type: string
          enum:
          - image/png
          - image/jpeg
          example: image/png
    Error:
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
    WmtsResponse:
      type: object
      required:
      - layerId
      - source
      properties:
        layerId:
          type: string
          description: Configured WebMap layer identifier.
          example: gc_bedrock
        source:
          $ref: '#/components/schemas/WmtsSource'
    WmtsSource:
      type: object
      required:
      - urlWMTS
      - paramsWMTS
      - serverType
      - crossOrigin
      properties:
        urlWMTS:
          type: string
          format: uri
          description: WMTS capabilities URL used by clients before creating the OpenLayers source.
          example: https://dev-ogcservices.swissgeol.ch/geoserver/swisstopo/gc_bedrock/gwc/service/wmts?SERVICE=WMTS&VERSION=1.0.0&REQUEST=GetCapabilities
        paramsWMTS:
          $ref: '#/components/schemas/WmtsParameters'
        serverType:
          type: string
          enum:
          - geoserver
          example: geoserver
        crossOrigin:
          type: string
          example: anonymous
  responses:
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: 500
            message: Internal server error
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: X-API-Key
      in: header
      description: 'API key required to access all endpoints of the SwissTopo WebMap Semantic Filtering API.

        '
externalDocs:
  description: WebMap semantic filter architecture and usage
  url: https://virtserver.swaggerhub.com/epsilonitalia/SwissTopoWebmapAPI/1.0.1
x-refined-from:
- swissgeol-lexic-webmap-api.yaml
- swisstopo-openapi.yml