smarterweather-com · Schema

CatalogList

`GET /v1/catalog`: every product on the REST API, sorted by `id`. Complete without `limit` (see the operation description).

CompanyWeatherDataForecastingClimate

Properties

Name Type Description
products array
View JSON Schema on GitHub

JSON Schema

smarterweather-com-catalog-list-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/smarterweather-com/json-schema/smarterweather-com-catalog-list-schema.json",
  "title": "CatalogList",
  "description": "`GET /v1/catalog`: every product on the REST API, sorted by `id`.\nComplete without `limit` (see the operation description).\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/smarterweather-com-meta-api-openapi.yml#/components/schemas/CatalogList",
  "type": "object",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CatalogProductSummary"
      }
    }
  },
  "$defs": {
    "CatalogCredit": {
      "type": "object",
      "description": "One upstream publisher a product credits, with its licence terms.",
      "required": [
        "provider_id",
        "name",
        "attribution",
        "license",
        "terms_url"
      ],
      "properties": {
        "provider_id": {
          "type": "string"
        },
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "attribution": {
          "type": "string"
        },
        "license": {
          "type": "string",
          "description": "Licence token: `public_domain`, `cc_by_4`, `cdla_permissive_2`,\n`odbl_1` or `internal`. New values may be added.\n"
        },
        "terms_url": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "CatalogFreshness": {
      "type": "object",
      "x-stability": "experimental",
      "description": "**Experimental** (`x-stability: experimental`). How current a\nproduct's data is, as the MCP `list_datasets` tool reports it. The\nshape is final; the values' sources are still being completed:\nfreshness checks cover a fixed set of products today, so some\nproducts (for example untracked analyses) have `freshness: null`\nand an untracked forecast has a `latest_run` but no\n`freshness_status`. Values are refreshed at most once a minute;\nwhile the freshness source is unavailable the last values are kept\nfor up to 5 minutes (`data_age_seconds` is computed when the response\nis made, so it still shows how old the data is), then `freshness` is\n`null`.\n",
      "required": [
        "data_age_seconds"
      ],
      "properties": {
        "freshness_status": {
          "type": "string",
          "enum": [
            "fresh",
            "stale",
            "missing"
          ],
          "description": "The platform's freshness check for the product: `fresh` within\nits expected age, `stale` older, `missing` no data found. When\na product is checked in more than one store, the stalest\nresult. Absent when the product is not checked.\n"
        },
        "latest_time": {
          "type": "string",
          "format": "date-time",
          "description": "Valid time of the newest data the freshness check found."
        },
        "latest_run": {
          "type": "string",
          "format": "date-time",
          "description": "Reference time of the latest model run served (forecasts only)."
        },
        "data_age_seconds": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Age of the newest data in seconds: from `latest_run` for a\nforecast, else from `latest_time`. `null` when unknown or when\nthe time is in the future (a forecast valid time says nothing\nabout age).\n"
        }
      }
    },
    "CatalogProductSummary": {
      "type": "object",
      "description": "A data catalog product, as listed by `GET /v1/catalog`.",
      "required": [
        "id",
        "title",
        "family",
        "kind",
        "product_type",
        "domain",
        "coverage",
        "cadence",
        "horizon",
        "step",
        "temporal_type",
        "grid_res_km",
        "stability",
        "cost_class",
        "entitlement",
        "source"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "Product id, the `product` of `/v1/point` and the MCP `dataset_id`."
        },
        "title": {
          "type": "string"
        },
        "family": {
          "type": "string",
          "description": "Product family, e.g. `nbm`, `mrms`, `spc`."
        },
        "kind": {
          "type": "string",
          "description": "Data shape: `grid` (a gridded field over time), `snapshot` (the\nlatest gridded analysis), `feature` (vector features such as\noutlook polygons) or `text` (text products). New kinds may be\nadded.\n"
        },
        "product_type": {
          "type": [
            "string",
            "null"
          ],
          "description": "`forecast`, `analysis` or `climatology`; `null` when the catalog\ndoes not classify the product. New values may be added.\n"
        },
        "domain": {
          "type": "string",
          "description": "Coverage domain, e.g. `conus`, `alaska`, `hawaii`, `global`."
        },
        "coverage": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Domains the product covers."
        },
        "cadence": {
          "type": [
            "string",
            "null"
          ],
          "description": "Nominal update cadence, an ISO 8601 duration."
        },
        "horizon": {
          "type": [
            "string",
            "null"
          ],
          "description": "Forecast horizon, an ISO 8601 duration; `null` for analyses."
        },
        "step": {
          "type": [
            "string",
            "null"
          ],
          "description": "Native frame spacing, an ISO 8601 duration: how far apart the\nproduct's frames are (`PT6H` for a 6-hourly model, `PT2M` for an\nMRMS mosaic, `P1D` for a daily product). Set on every `grid` and\n`snapshot` product; `null` for `feature` and `text` products,\nwhich have no frames. A sub-day step divides 24 h and a longer\none is whole days. A rolling `/v1/series` forecast window starts\nat now floored to it from 00:00Z (a step of a day or more floors\nto UTC midnight), so the frame covering now is in.\n"
        },
        "temporal_type": {
          "type": [
            "string",
            "null"
          ],
          "description": "How the product is stored in time: `now`, `hourly`, `daily` or\n`climatology`. New values may be added.\n"
        },
        "grid_res_km": {
          "type": [
            "number",
            "null"
          ],
          "format": "double",
          "description": "Grid spacing in kilometres; `null` for non-gridded products."
        },
        "stability": {
          "type": "string",
          "description": "Catalog stability of the product, `stable`, `beta` or `experimental`."
        },
        "cost_class": {
          "type": "string",
          "description": "Cost class of the product's data calls."
        },
        "entitlement": {
          "type": [
            "string",
            "null"
          ],
          "description": "Entitlement label the product requires; `null` when none."
        },
        "source": {
          "$ref": "#/$defs/CatalogSource"
        },
        "freshness": {
          "description": "**Experimental** (`x-stability: experimental`). Present only with\n`include=freshness`. `null` when the platform has neither a\nfreshness check nor a model run for the product, or when\nfreshness has been unavailable for more than 5 minutes (the\ncatalog still answers).\n",
          "x-stability": "experimental",
          "oneOf": [
            {
              "$ref": "#/$defs/CatalogFreshness"
            },
            {
              "type": "null"
            }
          ]
        }
      }
    },
    "CatalogSource": {
      "type": "object",
      "description": "The product's data source and attribution terms.",
      "required": [
        "id",
        "name",
        "provider_id",
        "attribution",
        "license",
        "terms_url",
        "credits"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "provider_id": {
          "type": "string"
        },
        "attribution": {
          "type": "string",
          "description": "Attribution text to display with the data."
        },
        "license": {
          "type": "string"
        },
        "terms_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "credits": {
          "type": "array",
          "description": "Every upstream the product credits, one element each; the fields\nabove equal the first. Display each element's `attribution`.\n",
          "items": {
            "$ref": "#/$defs/CatalogCredit"
          }
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/smarterweather-com-catalog-list"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.

A second provider on the same verified email joins the account you already have.