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 |
JSON Schema
{
"$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.
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.