Dynamical

Dynamical Data API

The Data API from Dynamical — 1 operation(s) for data.

GitHub OpenAPI

Operations 1

GET /v1/data/{dataProductId}/{snapshotId}/points/{gridIndices} Query Canonical Point #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/dynamical-org/openapi/dynamical-org-data-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-data-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-data-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dynamical Data API
  description: Catalog-backed point access to dynamical.org weather data.
  version: 0.1.0
tags:
- name: Data
paths:
  /v1/data/{dataProductId}/{snapshotId}/points/{gridIndices}:
    get:
      summary: Query Canonical Point
      operationId: query_canonical_point_v1_data__dataProductId___snapshotId__points__gridIndices__get
      parameters:
      - name: dataProductId
        in: path
        required: true
        schema:
          type: string
          title: Dataproductid
      - name: snapshotId
        in: path
        required: true
        schema:
          type: string
          title: Snapshotid
      - name: gridIndices
        in: path
        required: true
        schema:
          type: string
          title: Gridindices
      - name: variables
        in: query
        required: true
        schema:
          type: string
          minLength: 1
          title: Variables
      - name: initTime
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Inittime
      - name: maxLeadTimeHours
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            minimum: 0
          - type: 'null'
          title: Maxleadtimehours
      - name: validTimeStart
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Validtimestart
      - name: validTimeEnd
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Validtimeend
      - name: startTime
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Starttime
      - name: endTime
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Endtime
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/ForecastResult'
                - $ref: '#/components/schemas/DeterministicAnalysisResult'
                - $ref: '#/components/schemas/EnsembleAnalysisResult'
                title: Response Query Canonical Point V1 Data  Dataproductid   Snapshotid  Points  Gridindices  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, 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
          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 Canonical Point V1 Data  Dataproductid   Snapshotid  Points  Gridindices  Get
      tags:
      - Data
components:
  schemas:
    ErrorDetail:
      properties:
        detail:
          type: string
          title: Detail
        documentationUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Documentationurl
      additionalProperties: false
      type: object
      required:
      - detail
      title: ErrorDetail
    AnalysisLinks:
      properties:
        canonical:
          type: string
          title: Canonical
        catalog:
          type: string
          title: Catalog
      additionalProperties: false
      type: object
      required:
      - canonical
      - catalog
      title: AnalysisLinks
    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
    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
    DeterministicAnalysisResult:
      properties:
        queryId:
          anyOf:
          - type: string
            maxLength: 128
            minLength: 1
          - type: 'null'
          title: Queryid
        dataProduct:
          $ref: '#/components/schemas/DataProductReference'
        point:
          $ref: '#/components/schemas/Point'
        analysisTimes:
          items:
            type: string
            format: date-time
          type: array
          title: Analysistimes
        variables:
          additionalProperties:
            $ref: '#/components/schemas/Variable'
          type: object
          title: Variables
        snapshotId:
          type: string
          title: Snapshotid
        links:
          $ref: '#/components/schemas/AnalysisLinks'
        data:
          additionalProperties:
            items:
              anyOf:
              - type: number
              - type: integer
              - type: 'null'
            type: array
          type: object
          title: Data
      additionalProperties: false
      type: object
      required:
      - dataProduct
      - point
      - analysisTimes
      - variables
      - snapshotId
      - links
      - data
      title: DeterministicAnalysisResult
    EnsembleAnalysisResult:
      properties:
        queryId:
          anyOf:
          - type: string
            maxLength: 128
            minLength: 1
          - type: 'null'
          title: Queryid
        dataProduct:
          $ref: '#/components/schemas/DataProductReference'
        point:
          $ref: '#/components/schemas/Point'
        analysisTimes:
          items:
            type: string
            format: date-time
          type: array
          title: Analysistimes
        variables:
          additionalProperties:
            $ref: '#/components/schemas/Variable'
          type: object
          title: Variables
        snapshotId:
          type: string
          title: Snapshotid
        links:
          $ref: '#/components/schemas/AnalysisLinks'
        ensembleMembers:
          items:
            $ref: '#/components/schemas/EnsembleMember'
          type: array
          title: Ensemblemembers
      additionalProperties: false
      type: object
      required:
      - dataProduct
      - point
      - analysisTimes
      - variables
      - snapshotId
      - links
      - ensembleMembers
      title: EnsembleAnalysisResult
    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
    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
    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
    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
    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
    RoutingCoverage:
      properties:
        selectedValues:
          type: integer
          title: Selectedvalues
        finiteValues:
          type: integer
          title: Finitevalues
      additionalProperties: false
      type: object
      required:
      - selectedValues
      - finiteValues
      title: RoutingCoverage
    CanonicalLink:
      properties:
        canonical:
          type: string
          title: Canonical
      additionalProperties: false
      type: object
      required:
      - canonical
      title: CanonicalLink