Meteoblue API

openapi: 3.1.0
info:
  title: Meteoblue API
  version: '2026-10-28'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-28: 6 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Meteoblue has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 4
    pages-with-code: 2
    pages-read: 3
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-28'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.meteoblue.com/en/weather-apis/dataset-api
  - https://docs.meteoblue.com/en/weather-apis/maps-api/time-api
  - https://docs.meteoblue.com/en/weather-apis/further-apis/location-search-api
servers:
- url: https://my.meteoblue.com
paths:
  /DD7F947B-C11E-48A2-92DC-1A4A5E77DE8C:
    get:
      operationId: get_DD7F947B_C11E_48A2_92DC_1A4A5E77DE8C
      tags:
      - Dd7F947B C11E 48A2 92Dc 1A4A5E77De8C
      summary: GET /DD7F947B-C11E-48A2-92DC-1A4A5E77DE8C
      x-source: https://docs.meteoblue.com/en/weather-apis/dataset-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"http://queueresults.meteoblue.com/DD7F947B-C11E-48A2-92DC-1A4A5E77DE8C\" \n Job States ​ \n Jobs can have the following\
          \ state: \n waiting : A job is queued but has not yet been started. It should start within a couple of seconds, unless the queues are\
          \ highly utilized. \n running : The job is currently running. Each job is checked every couple of seconds if it is actually running.\
          \ \n finished : Job"
  /dataset/query:
    get:
      operationId: get_dataset_query
      tags:
      - Dataset
      summary: Dataset API
      description: Execute a dataset query using a JSON body supplied via the `json` query parameter or via POST (example shown).
      x-source: https://docs.meteoblue.com/en/weather-apis/dataset-api
      parameters:
      - name: apikey
        in: query
        required: true
        schema:
          type: string
        description: Valid API key
      - name: json
        in: query
        required: false
        schema:
          type: string
        description: URL‑encoded JSON query body
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_dataset_query
      tags:
      - Dataset
      summary: POST /dataset/query
      x-source: https://docs.meteoblue.com/en/weather-apis/dataset-api
      parameters:
      - name: apikey
        in: query
        required: false
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDatasetQueryRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://my.meteoblue.com/dataset/query/?apikey=123456789" -H "Content-Type: application/json" -d ''{"runOnJobQueue":true,"geometry":{"type":"MultiPoint","coordinates":[[7.57327,47.558399,279]],"locationNames":["Basel"]},"format":"csv","timeIntervals":["2017-01-01T+00:00/2017-12-31T+00:00"],"queries":[{"domain":"ERA5","gapFillDomain":null,"timeResolution":"hourly","codes":[{"code":75,"level":"'
  /dataset/query/:
    get:
      operationId: get_dataset_query
      tags:
      - Dataset
      summary: Dataset API
      description: Same as `/dataset/query` but with a trailing slash.
      x-source: https://docs.meteoblue.com/en/weather-apis/dataset-api
      parameters:
      - name: apikey
        in: query
        required: true
        schema:
          type: string
        description: Valid API key
      - name: json
        in: query
        required: false
        schema:
          type: string
        description: URL‑encoded JSON query body
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /en/server/search/query3:
    get:
      operationId: get_en_server_search_query3
      tags:
      - En
      summary: Retrieve Location Information
      description: The meteoblue Location Search API resolves location names, postal codes, ICAO and IATA codes to standardized WGS84 latitude
        and longitude coordinates.
      x-source: https://docs.meteoblue.com/en/weather-apis/further-apis/location-search-api
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
        description: The search term.
      - name: iso2
        in: query
        required: false
        schema:
          type: string
        description: Language is defined in the URL prefix; ISO2 country code.
      - name: callback
        in: query
        required: false
        schema:
          type: string
        description: Enables JSONP output with the specified callback function.
      - name: apikey
        in: query
        required: true
        schema:
          type: string
        description: Required to call the Location Search API.
      - name: sig
        in: query
        required: false
        schema:
          type: string
        description: Signature, required if the API key is protected with a shared secret.
      - name: orderBy
        in: query
        required: false
        schema:
          type: string
        description: Sorting order, default "ranker DESC".
      - name: page
        in: query
        required: false
        schema:
          type: integer
        description: Page number, default 1.
      - name: itemsPerPage
        in: query
        required: false
        schema:
          type: integer
        description: Number of items per page, default 10, max 100.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEnServerSearchQuery3Response'
      x-evidence:
        kind: documentation
  /v1/time/{mode}/{domain}:
    get:
      operationId: get_v1_time_mode_domain
      tags:
      - Time
      summary: The Time API provides information about the available timesteps of a domain.
      x-source: https://docs.meteoblue.com/en/weather-apis/maps-api/time-api
      parameters:
      - name: mode
        in: path
        required: true
        schema:
          type: string
      - name: domain
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1TimeModeDomainResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostDatasetQueryRequest:
      type: object
      properties:
        runOnJobQueue:
          type: boolean
        geometry:
          type: object
          properties:
            type:
              type: string
            coordinates:
              type: array
              items:
                type: array
                items:
                  type: number
            locationNames:
              type: array
              items:
                type: string
        format:
          type: string
        timeIntervals:
          type: array
          items:
            type: string
            format: date-time
        queries:
          type: array
          items:
            type: object
            properties:
              domain:
                type: string
              gapFillDomain:
                type:
                - string
                - 'null'
              timeResolution:
                type: string
              codes:
                type: array
                items:
                  type: object
                  properties:
                    code:
                      type: integer
                    level:
                      type: string
    GetEnServerSearchQuery3Response:
      type: object
      properties:
        type:
          type: string
          description: Detected call type, e.g., "Name" or "Coord".
        iso2:
          type: string
          description: ISO2 country code.
        query:
          type: string
          description: The search term.
        orderBy:
          type: string
          description: Sorting column and direction used.
        lat:
          type: number
          description: Latitude for coordinate searches.
        lon:
          type: number
          description: Longitude for coordinate searches.
        radius:
          type: number
          description: Radius in km for coordinate searches.
        count:
          type: integer
          description: Total number of results.
        pages:
          type: integer
          description: Total number of result pages.
        itemsPerPage:
          type: integer
          description: Maximum amount of results per page.
        currentPage:
          type: integer
          description: Number of the current page.
        results:
          type: array
          description: Array of location items.
    GetV1TimeModeDomainResponse:
      type: object
      properties:
        type:
          type: string
          description: either regular, categories or timesteps
        expires:
          type: string
          description: optional iso8601 timestamp. At this point in time the map should be reloaded.
        lastUpdate:
          type: string
          description: optional iso8601 timestamp of the last update. This can be used for cache invalidation.
        first:
          type: string
          description: iso8601 timestamp of the first available timestep (present when type is regular).
        last:
          type: string
          description: iso8601 timestamp of the last available timestep (present when type is regular).
        interval:
          type: number
          description: the interval between two timesteps in seconds (present when type is regular).
        current:
          type: string
          description: iso8601 timestamp of the current timestep (present when type is regular).
        categories:
          type: array
          description: A list of available categories (present when type is categories). Each object contains a name and a value.
        format:
          type: string
          description: format string for timesteps (present when type is timesteps).
        timesteps:
          type: array
          description: A list of available timesteps (present when type is timesteps). Each object contains a timestep and a value.
        ranges:
          type: array
          description: Optional list of ranges (present when type is timesteps). Each object contains a label and a numsteps.
tags:
- name: Dataset
- name: Dd7F947B C11E 48A2 92Dc 1A4A5E77De8C
- name: En
- name: Time