Japan Weather Forecast Archive (JMA, as issued)

List the tools of this server with prices, data sources, licensing, daily limits and data freshness.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "server": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "version": {
          "type": "string"
        },
        "stage": {
          "type": "string"
        }
      },
      "required": [
        "name",
        "version",
        "stage"
      ],
      "additionalProperties": {}
    },
    "payment": {
      "type": "object",
      "properties": {
        "protocol": {
          "type": "string"
        },
        "network": {
          "type": "string"
        },
        "asset": {
          "type": "string"
        },
        "enabled": {
          "type": "boolean"
        }
      },
      "required": [
        "protocol",
        "network",
        "asset",
        "enabled"
      ],
      "additionalProperties": {}
    },
    "daily_limits": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "Daily limits of paid calls (calls, usd, timezone) or a misconfiguration notice."
    },
    "paused": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "boolean"
      },
      "description": "Operator pause flags (true = paused)."
    },
    "tools": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "price_usd": {
            "type": "number",
            "description": "Price per call in USD (0 = free)."
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "price_usd",
          "description"
        ],
        "additionalProperties": {}
      },
      "description": "Every tool of this server with its price."
    },
    "legal": {
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "fetch_status_values": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "object",
            "properties": {
              "publisher": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "publisher",
              "url"
            ],
            "additionalProperties": {},
            "description": "Publisher and URL of the upstream document or dataset."
          },
          "upstream_updated_at": {
            "description": "Update time stated by the upstream, or null when it states none.",
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "description": "When this service retrieved the upstream data (null if unknown).",
            "type": [
              "string",
              "null"
            ]
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "fetch_status": {
            "type": "string",
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "additionalProperties": {},
        "description": "Freshness receipt for one upstream source."
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    }
  },
  "required": [
    "server",
    "payment",
    "daily_limits",
    "paused",
    "tools",
    "legal",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Archived JMA prefectural weather forecast as issued. Give an area and at (forecast in effect then) or issued_at (exact JMA issue time). Returns JMA's bulletin as published (Japanese weather text, wind, waves, 6-hour rain probability, temperatures) with report_datetime (JMA's issue time) apart from fetched_at (ours). Status found, not_archived (before this archive started), unknown or no_issuance_at_that_time. Not the current forecast: check JMA.

{
  "type": "object",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 40,
      "description": "JMA forecast office code (130000), sub-area code (130010), prefecture (Tokyo, 東京都, 13) or JMA area name (Kushiro Nemuro). Prefectures with several offices (Hokkaido, Kagoshima, Okinawa) need the office or sub-area"
    },
    "at": {
      "description": "ISO 8601 date-time with time zone: return the issuance in effect at this time, e.g. 2026-10-12T09:00:00+09:00",
      "type": "string",
      "maxLength": 40
    },
    "issued_at": {
      "description": "ISO 8601 date-time with time zone: return the issuance with exactly this JMA issue time, e.g. 2026-10-12T05:00:00+09:00",
      "type": "string",
      "maxLength": 40
    }
  },
  "required": [
    "area"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "official_check": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string"
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "message",
        "urls"
      ],
      "additionalProperties": {},
      "description": "Read first: this is an archive of what JMA issued; for current forecasts check the JMA pages listed here."
    },
    "archive_notice": {
      "type": "string",
      "description": "Every answer is an archived issuance, not the current forecast and not a forecast made by this service."
    },
    "query": {
      "type": "object",
      "properties": {
        "office": {
          "type": "string"
        }
      },
      "required": [
        "office"
      ],
      "additionalProperties": {}
    },
    "status": {
      "type": "string",
      "enum": [
        "found",
        "not_archived",
        "unknown",
        "no_issuance_at_that_time"
      ],
      "description": "found = the archived issuance; not_archived = before this archive's start (JMA does not publish past forecasts); unknown = the feed was not read for part of the period or the bulletin could not be read; no_issuance_at_that_time = feed read, no issuance with exactly that issue time."
    },
    "status_note": {
      "type": "string"
    },
    "issuance": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "office": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "name_ja": {
                  "type": "string"
                },
                "name_en": {
                  "type": "string"
                }
              },
              "required": [
                "code",
                "name_ja",
                "name_en"
              ],
              "additionalProperties": {}
            },
            "report_datetime": {
              "type": "string",
              "description": "JMA's issue time as published (Head/ReportDateTime, +09:00)."
            },
            "report_datetime_utc": {
              "type": "string"
            },
            "published_at": {
              "type": "string",
              "description": "When JMA transmitted the bulletin (Control/DateTime)."
            },
            "fetched_at": {
              "type": "string",
              "description": "When this service retrieved the bulletin. Not JMA's time."
            },
            "issuance_type": {
              "type": "string",
              "enum": [
                "scheduled",
                "unscheduled",
                "correction",
                "cancellation"
              ]
            },
            "areas": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name_ja": {
                    "type": "string"
                  },
                  "name_en": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "elements": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {}
                  }
                },
                "required": [
                  "code",
                  "name_ja",
                  "name_en",
                  "elements"
                ],
                "additionalProperties": {}
              }
            },
            "stations": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name_ja": {
                    "type": "string"
                  },
                  "elements": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {}
                  }
                },
                "required": [
                  "code",
                  "name_ja",
                  "elements"
                ],
                "additionalProperties": {}
              }
            },
            "source": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string"
                },
                "doc_key": {
                  "type": "string"
                },
                "raw_sha256": {
                  "type": "string"
                }
              },
              "required": [
                "url",
                "doc_key",
                "raw_sha256"
              ],
              "additionalProperties": {}
            }
          },
          "required": [
            "office",
            "report_datetime",
            "report_datetime_utc",
            "published_at",
            "fetched_at",
            "issuance_type",
            "areas",
            "stations",
            "source"
          ],
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "archive": {
      "type": "object",
      "properties": {
        "office_archive_start": {
          "description": "First issuance held for this office (JMA issue time, Japan time).",
          "type": [
            "string",
            "null"
          ]
        },
        "tracking_since": {
          "description": "Start of the period this service has read JMA's feed (UTC).",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "office_archive_start",
        "tracking_since"
      ],
      "additionalProperties": {}
    },
    "legal_notice": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "properties": {
        "source_ja": {
          "type": "string"
        },
        "processed_ja": {
          "type": "string"
        },
        "source_en": {
          "type": "string"
        },
        "license_note": {
          "type": "string"
        }
      },
      "required": [
        "source_ja",
        "processed_ja",
        "source_en",
        "license_note"
      ],
      "additionalProperties": {}
    },
    "answered_at": {
      "type": "string"
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "object",
            "properties": {
              "publisher": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "publisher",
              "url"
            ],
            "additionalProperties": {},
            "description": "Publisher and URL of the upstream document or dataset."
          },
          "upstream_updated_at": {
            "description": "Update time stated by the upstream, or null when it states none.",
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "description": "When this service retrieved the upstream data (null if unknown).",
            "type": [
              "string",
              "null"
            ]
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "fetch_status": {
            "type": "string",
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "additionalProperties": {},
        "description": "Freshness receipt for one upstream source."
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    }
  },
  "required": [
    "official_check",
    "archive_notice",
    "query",
    "status",
    "status_note",
    "issuance",
    "archive",
    "legal_notice",
    "attribution",
    "answered_at",
    "provenance",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Which prefectural weather forecasts did JMA issue for an area between two times? Lists each archived issuance (JMA issue time, transmission time, our fetch time, scheduled/unscheduled/correction/cancellation, bulletin URL and SHA-256) with coverage gaps where JMA's feed could not be read. Free window: last 30 days (an earlier since is clamped; see history_window). Use forecast_as_issued for the content. An archive, not a forecast service.

{
  "type": "object",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 40,
      "description": "JMA forecast office code (130000), sub-area code (130010), prefecture (Tokyo, 東京都, 13) or JMA area name (Kushiro Nemuro). Prefectures with several offices (Hokkaido, Kagoshima, Okinawa) need the office or sub-area"
    },
    "since": {
      "type": "string",
      "maxLength": 40,
      "description": "Issuances after this: ISO 8601 date (00:00 Japan time) or date-time with time zone, e.g. 2026-10-12 or 2026-10-12T05:00:00+09:00"
    },
    "until": {
      "description": "Optional end: ISO 8601 date (00:00 Japan time) or date-time with time zone (default now)",
      "type": "string",
      "maxLength": 40
    },
    "limit": {
      "description": "Maximum number of issuances, 1-500 (default 100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "area",
    "since"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "official_check": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string"
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "message",
        "urls"
      ],
      "additionalProperties": {},
      "description": "Read first: this is an archive of what JMA issued; for current forecasts check the JMA pages listed here."
    },
    "archive_notice": {
      "type": "string",
      "description": "Every answer is an archived issuance, not the current forecast and not a forecast made by this service."
    },
    "query": {
      "type": "object",
      "properties": {
        "office": {
          "type": "string"
        },
        "since": {
          "type": "string"
        },
        "until": {
          "type": "string"
        }
      },
      "required": [
        "office",
        "since",
        "until"
      ],
      "additionalProperties": {}
    },
    "history_window": {
      "type": "object",
      "properties": {
        "free_days": {
          "type": "number",
          "description": "Days of recorded history served free of charge."
        },
        "requested_since": {
          "type": "string",
          "description": "The since you asked for (normalized to ISO 8601)."
        },
        "served_since": {
          "type": "string",
          "description": "The since actually applied: requested_since, or the start of the free window if requested_since was earlier."
        },
        "clamped": {
          "type": "boolean",
          "description": "true when requested_since was earlier than the free window and the answer covers only the window."
        },
        "older_history": {
          "type": "string",
          "description": "Status of recorded history older than the free window."
        }
      },
      "required": [
        "free_days",
        "requested_since",
        "served_since",
        "clamped",
        "older_history"
      ],
      "additionalProperties": {},
      "description": "Free history window applied to this answer."
    },
    "archive": {
      "type": "object",
      "properties": {
        "office_archive_start": {
          "description": "First issuance held for this office (JMA issue time, Japan time).",
          "type": [
            "string",
            "null"
          ]
        },
        "tracking_since": {
          "description": "Start of the period this service has read JMA's feed (UTC).",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "office_archive_start",
        "tracking_since"
      ],
      "additionalProperties": {}
    },
    "coverage": {
      "type": "object",
      "properties": {
        "complete": {
          "type": "boolean"
        },
        "since_before_tracking": {
          "type": "boolean"
        },
        "gaps": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "from": {
                "type": "string"
              },
              "to": {
                "type": "string"
              }
            },
            "required": [
              "from",
              "to"
            ],
            "additionalProperties": {}
          }
        },
        "note": {
          "type": "string"
        }
      },
      "required": [
        "complete",
        "since_before_tracking",
        "gaps",
        "note"
      ],
      "additionalProperties": {}
    },
    "issuances": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "report_datetime": {
            "type": "string"
          },
          "published_at": {
            "type": "string"
          },
          "fetched_at": {
            "type": "string"
          },
          "issuance_type": {
            "type": "string",
            "enum": [
              "scheduled",
              "unscheduled",
              "correction",
              "cancellation",
              "unknown"
            ]
          },
          "record_status": {
            "type": "string",
            "enum": [
              "readable",
              "unreadable"
            ]
          },
          "source": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string"
              },
              "raw_sha256": {
                "type": "string"
              }
            },
            "required": [
              "url",
              "raw_sha256"
            ],
            "additionalProperties": {}
          }
        },
        "required": [
          "report_datetime",
          "published_at",
          "fetched_at",
          "issuance_type",
          "record_status",
          "source"
        ],
        "additionalProperties": {}
      },
      "description": "JMA issuances held for this office, oldest first."
    },
    "truncated": {
      "type": "boolean"
    },
    "legal_notice": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "properties": {
        "source_ja": {
          "type": "string"
        },
        "processed_ja": {
          "type": "string"
        },
        "source_en": {
          "type": "string"
        },
        "license_note": {
          "type": "string"
        }
      },
      "required": [
        "source_ja",
        "processed_ja",
        "source_en",
        "license_note"
      ],
      "additionalProperties": {}
    },
    "answered_at": {
      "type": "string"
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "object",
            "properties": {
              "publisher": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "publisher",
              "url"
            ],
            "additionalProperties": {},
            "description": "Publisher and URL of the upstream document or dataset."
          },
          "upstream_updated_at": {
            "description": "Update time stated by the upstream, or null when it states none.",
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "description": "When this service retrieved the upstream data (null if unknown).",
            "type": [
              "string",
              "null"
            ]
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "fetch_status": {
            "type": "string",
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "additionalProperties": {},
        "description": "Freshness receipt for one upstream source."
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    }
  },
  "required": [
    "official_check",
    "archive_notice",
    "query",
    "history_window",
    "archive",
    "coverage",
    "issuances",
    "truncated",
    "legal_notice",
    "attribution",
    "answered_at",
    "provenance",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Re-fetch the stored result of a settled paid call by its receipt_id, for when the response was lost after payment. Free. Unknown or unsettled receipt ids return RECEIPT_NOT_FOUND. Results are kept for 90 days after settlement.

{
  "type": "object",
  "properties": {
    "receipt_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "The receipt_id returned with a paid result (\"rcpt_\" + 64 hex characters)."
    }
  },
  "required": [
    "receipt_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "receipt_id": {
      "type": "string",
      "description": "Receipt id of the settled paid call (\"rcpt_\" + 64 hex). Use with get_receipt."
    },
    "tool": {
      "type": "string",
      "description": "Name of the paid tool that produced the result."
    },
    "settled_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "payment": {
      "type": "object",
      "properties": {
        "network": {
          "type": [
            "string",
            "null"
          ]
        },
        "transaction": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "network",
        "transaction"
      ],
      "additionalProperties": {}
    },
    "result": {
      "description": "The stored result, exactly as returned by the paid call."
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "object",
            "properties": {
              "publisher": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "publisher",
              "url"
            ],
            "additionalProperties": {},
            "description": "Publisher and URL of the upstream document or dataset."
          },
          "upstream_updated_at": {
            "description": "Update time stated by the upstream, or null when it states none.",
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "description": "When this service retrieved the upstream data (null if unknown).",
            "type": [
              "string",
              "null"
            ]
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "fetch_status": {
            "type": "string",
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "additionalProperties": {},
        "description": "Freshness receipt for one upstream source."
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    }
  },
  "required": [
    "receipt_id",
    "tool",
    "settled_at",
    "payment",
    "result",
    "provenance",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}