Dynamical

Dynamical Forecasts API

The Forecasts API from Dynamical — 2 operation(s) for forecasts.

GitHub OpenAPI

Operations 2

GET /v1/forecasts/runs List Forecast Runs #
POST /v1/forecasts Query Forecasts #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/dynamical-org/openapi/dynamical-org-forecasts-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/dynamical-org/json-schema/dynamical-org-forecast-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/dynamical-org/json-schema/dynamical-org-deterministic-analysis-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/dynamical-org/json-schema/dynamical-org-ensemble-analysis-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/dynamical-org/json-schema/dynamical-org-analysis-batch-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/dynamical-org/json-schema/dynamical-org-analysis-batch-schema.json
📊
JSONSchema
https://artifacts.apis.io/dynamical-org/json-schema/dynamical-org-forecast-batch-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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/dynamical-org:dynamical-org-forecasts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

dynamical-org-forecasts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dynamical Forecasts API
  description: Catalog-backed point access to dynamical.org weather data.
  version: 0.1.0
tags:
- name: Forecasts
paths:
  /v1/forecasts/runs:
    get:
      summary: List Forecast Runs
      operationId: list_forecast_runs_v1_forecasts_runs_get
      parameters:
      - name: dataProductId
        in: query
        required: true
        schema:
          type: string
          minLength: 1
          title: Dataproductid
      - name: initTimesAfter
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Inittimesafter
      - name: initTimesBefore
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Inittimesbefore
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 20
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Forecast Runs V1 Forecasts Runs Get
        '429':
          description: Request rate limit exceeded, or too many concurrent requests from this caller while the server is busy; contact feedback@dynamical.org if you need higher limits
          headers:
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '503':
          description: Server busy or catalog unavailable
          headers:
            Retry-After:
              description: Seconds to wait when server busy; may be absent for catalog errors
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '451':
          description: Data product not available in the caller's location
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Invalid or unsupported request
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/ErrorDetail'
                - $ref: '#/components/schemas/ValidationErrorDetail'
                title: Response 422 List Forecast Runs V1 Forecasts Runs Get
      tags:
      - Forecasts
  /v1/forecasts:
    post:
      summary: Query Forecasts
      operationId: query_forecasts_v1_forecasts_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ForecastBatch'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForecastBatchResponse'
        '429':
          description: Request rate limit exceeded, or too many concurrent requests from this caller while the server is busy; contact feedback@dynamical.org if you need higher limits
          headers:
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
                minimum: 1.0
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '503':
          description: Server busy, catalog unavailable, or upstream data read timed out or was throttled
          headers:
            Retry-After:
              description: Seconds to wait when server busy or upstream data timed out or was throttled; may be absent for catalog errors
              schema:
                type: integer
                minimum: 1.0
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '451':
          description: Data product not available in the caller's location
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Invalid or unsupported request
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/ErrorDetail'
                - $ref: '#/components/schemas/ValidationErrorDetail'
                title: Response 422 Query Forecasts V1 Forecasts Post
      tags:
      - Forecasts
components:
  schemas:
    Routing:
      properties:
        requestedDataProduct:
          $ref: '#/components/schemas/DataProductReference'
        requestedSnapshotId:
          type: string
          title: Requestedsnapshotid
        decision:
          type: string
          enum:
          - substituted
          - direct
          - fallback
          title: Decision
        reason:
          type: string
          title: Reason
        fallbackReason:
          anyOf:
          - type: string
            enum:
            - missing
            - timeout
            - throttle
          - type: 'null'
          title: Fallbackreason
        coverage:
          $ref: '#/components/schemas/RoutingCoverage'
        policyRevision:
          type: string
          title: Policyrevision
      additionalProperties: false
      type: object
      required:
      - requestedDataProduct
      - requestedSnapshotId
      - decision
      - reason
      - fallbackReason
      - coverage
      - policyRevision
      title: Routing
    CatalogLink:
      properties:
        catalog:
          type: string
          title: Catalog
      additionalProperties: false
      type: object
      required:
      - catalog
      title: CatalogLink
    Coordinate:
      properties:
        latitude:
          type: number
          title: Latitude
        longitude:
          type: number
          title: Longitude
      additionalProperties: false
      type: object
      required:
      - latitude
      - longitude
      title: Coordinate
    Point:
      properties:
        requested:
          anyOf:
          - $ref: '#/components/schemas/Coordinate'
          - type: 'null'
        selected:
          $ref: '#/components/schemas/SelectedPoint'
        method:
          type: string
          const: nearest
          title: Method
      additionalProperties: false
      type: object
      required:
      - selected
      - method
      title: Point
    EnsembleMember:
      properties:
        member:
          anyOf:
          - type: string
          - type: integer
          - type: number
          title: Member
        data:
          additionalProperties:
            items:
              anyOf:
              - type: number
              - type: integer
              - type: 'null'
            type: array
          type: object
          title: Data
      additionalProperties: false
      type: object
      required:
      - member
      - data
      title: EnsembleMember
    ForecastResult:
      properties:
        queryId:
          anyOf:
          - type: string
            maxLength: 128
            minLength: 1
          - type: 'null'
          title: Queryid
        dataProduct:
          $ref: '#/components/schemas/DataProductReference'
        point:
          $ref: '#/components/schemas/Point'
        forecasts:
          items:
            anyOf:
            - $ref: '#/components/schemas/DeterministicForecastSeries'
            - $ref: '#/components/schemas/EnsembleForecastSeries'
          type: array
          title: Forecasts
        variables:
          additionalProperties:
            $ref: '#/components/schemas/Variable'
          type: object
          title: Variables
        snapshotId:
          type: string
          title: Snapshotid
        links:
          $ref: '#/components/schemas/CatalogLink'
        routing:
          anyOf:
          - $ref: '#/components/schemas/Routing'
          - type: 'null'
          description: Present only when the requested data product has a reviewed equivalent representation; dataProduct, snapshotId and links name the product served.
      additionalProperties: false
      type: object
      required:
      - dataProduct
      - point
      - forecasts
      - variables
      - snapshotId
      - links
      title: ForecastResult
    ErrorDetail:
      properties:
        detail:
          type: string
          title: Detail
        documentationUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Documentationurl
      additionalProperties: false
      type: object
      required:
      - detail
      title: ErrorDetail
    DeterministicForecastSeries:
      properties:
        initTime:
          type: string
          format: date-time
          title: Inittime
        validTimes:
          items:
            type: string
            format: date-time
          type: array
          title: Validtimes
        leadTimeHours:
          items:
            type: number
          type: array
          title: Leadtimehours
        links:
          $ref: '#/components/schemas/CanonicalLink'
        data:
          additionalProperties:
            items:
              anyOf:
              - type: number
              - type: integer
              - type: 'null'
            type: array
          type: object
          title: Data
      additionalProperties: false
      type: object
      required:
      - initTime
      - validTimes
      - leadTimeHours
      - links
      - data
      title: DeterministicForecastSeries
    ForecastQuery:
      properties:
        queryId:
          anyOf:
          - type: string
            maxLength: 128
            minLength: 1
          - type: 'null'
          title: Queryid
        dataProductId:
          type: string
          minLength: 1
          title: Dataproductid
        location:
          $ref: '#/components/schemas/Location'
        variables:
          items:
            type: string
          type: array
          maxItems: 25
          minItems: 1
          title: Variables
        initTime:
          anyOf:
          - type: string
            format: date-time
          - type: string
            const: latest
          - type: 'null'
          title: Inittime
        initTimesAfter:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Inittimesafter
        initTimesBefore:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Inittimesbefore
        validTimeStart:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Validtimestart
        validTimeEnd:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Validtimeend
        maxLeadTimeHours:
          anyOf:
          - type: integer
            minimum: 0.0
          - type: 'null'
          title: Maxleadtimehours
        representation:
          type: string
          enum:
          - auto
          - requested
          title: Representation
          default: auto
      additionalProperties: false
      type: object
      required:
      - dataProductId
      - location
      - variables
      title: ForecastQuery
    ForecastBatchResponse:
      properties:
        results:
          items:
            $ref: '#/components/schemas/ForecastResult'
          type: array
          title: Results
      additionalProperties: false
      type: object
      required:
      - results
      title: ForecastBatchResponse
    ForecastBatch:
      properties:
        queries:
          items:
            $ref: '#/components/schemas/ForecastQuery'
          type: array
          maxItems: 10
          minItems: 1
          title: Queries
      additionalProperties: false
      type: object
      required:
      - queries
      title: ForecastBatch
    RoutingCoverage:
      properties:
        selectedValues:
          type: integer
          title: Selectedvalues
        finiteValues:
          type: integer
          title: Finitevalues
      additionalProperties: false
      type: object
      required:
      - selectedValues
      - finiteValues
      title: RoutingCoverage
    Location:
      properties:
        latitude:
          type: number
          maximum: 90.0
          minimum: -90.0
          title: Latitude
        longitude:
          type: number
          maximum: 180.0
          minimum: -180.0
          title: Longitude
      additionalProperties: false
      type: object
      required:
      - latitude
      - longitude
      title: Location
    SelectedPoint:
      properties:
        latitude:
          type: number
          title: Latitude
        longitude:
          type: number
          title: Longitude
        grid:
          additionalProperties:
            type: integer
          type: object
          title: Grid
      additionalProperties: false
      type: object
      required:
      - latitude
      - longitude
      - grid
      title: SelectedPoint
    ValidationErrorDetail:
      properties:
        detail:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Detail
      additionalProperties: false
      type: object
      required:
      - detail
      title: ValidationErrorDetail
    DataProductReference:
      properties:
        id:
          type: string
          title: Id
        version:
          anyOf:
          - type: string
          - type: 'null'
          title: Version
      additionalProperties: false
      type: object
      required:
      - id
      - version
      title: DataProductReference
    EnsembleForecastSeries:
      properties:
        initTime:
          type: string
          format: date-time
          title: Inittime
        validTimes:
          items:
            type: string
            format: date-time
          type: array
          title: Validtimes
        leadTimeHours:
          items:
            type: number
          type: array
          title: Leadtimehours
        links:
          $ref: '#/components/schemas/CanonicalLink'
        ensembleMembers:
          items:
            $ref: '#/components/schemas/EnsembleMember'
          type: array
          title: Ensemblemembers
      additionalProperties: false
      type: object
      required:
      - initTime
      - validTimes
      - leadTimeHours
      - links
      - ensembleMembers
      title: EnsembleForecastSeries
    Variable:
      properties:
        unit:
          anyOf:
          - type: string
          - type: 'null'
          title: Unit
      additionalProperties: false
      type: object
      required:
      - unit
      title: Variable
    CanonicalLink:
      properties:
        canonical:
          type: string
          title: Canonical
      additionalProperties: false
      type: object
      required:
      - canonical
      title: CanonicalLink