Dynamical

Dynamical Analyses API

The Analyses API from Dynamical — 1 operation(s) for analyses.

Documentation GitHub OpenAPI

Operations 1

POST /v1/analyses Query Analyses #

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-analyses-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

openapi: 3.2.0
info:
  title: Dynamical Analyses API
  description: Catalog-backed point access to dynamical.org weather data.
  version: 0.1.0
tags:
- name: Analyses
paths:
  /v1/analyses:
    post:
      summary: Query Analyses
      operationId: query_analyses_v1_analyses_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AnalysisBatch'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalysisBatchResponse'
        '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 Analyses V1 Analyses Post
      tags:
      - Analyses
components:
  schemas:
    AnalysisQuery:
      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
        startTime:
          type: string
          format: date-time
          title: Starttime
        endTime:
          type: string
          format: date-time
          title: Endtime
      additionalProperties: false
      type: object
      required:
      - dataProductId
      - location
      - variables
      - startTime
      - endTime
      title: AnalysisQuery
    ErrorDetail:
      properties:
        detail:
          type: string
          title: Detail
        documentationUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Documentationurl
      additionalProperties: false
      type: object
      required:
      - detail
      title: ErrorDetail
    AnalysisBatchResponse:
      properties:
        results:
          items:
            anyOf:
            - $ref: '#/components/schemas/DeterministicAnalysisResult'
            - $ref: '#/components/schemas/EnsembleAnalysisResult'
          type: array
          title: Results
      additionalProperties: false
      type: object
      required:
      - results
      title: AnalysisBatchResponse
    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
    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
    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
    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
    AnalysisBatch:
      properties:
        queries:
          items:
            $ref: '#/components/schemas/AnalysisQuery'
          type: array
          maxItems: 10
          minItems: 1
          title: Queries
      additionalProperties: false
      type: object
      required:
      - queries
      title: AnalysisBatch
    DataProductReference:
      properties:
        id:
          type: string
          title: Id
        version:
          anyOf:
          - type: string
          - type: 'null'
          title: Version
      additionalProperties: false
      type: object
      required:
      - id
      - version
      title: DataProductReference
    AnalysisLinks:
      properties:
        canonical:
          type: string
          title: Canonical
        catalog:
          type: string
          title: Catalog
      additionalProperties: false
      type: object
      required:
      - canonical
      - catalog
      title: AnalysisLinks
    Variable:
      properties:
        unit:
          anyOf:
          - type: string
          - type: 'null'
          title: Unit
      additionalProperties: false
      type: object
      required:
      - unit
      title: Variable