Weather.gov · Schema
AstronomicalData
An object representing sunrise, sunset, and twilight information for a location.
WeatherGovernmentUnited StatesForecastingAlertsOpen Data
Properties
| Name | Type | Description |
|---|---|---|
| sunrise | string | The timestamp of sunrise, defined as when the sun angle is 90°35' from vertical. |
| sunset | string | The timestamp of sunset, defined as when the sun angle is 90°35' from vertical. |
| transit | string | The timestamp when the sun reaches its zenith. |
| civilTwilightBegin | string | The timestamp of the onset of civil twilight, defined as when the sun angle is 96° from vertical. This is the beginning of civil dawn and lasts until sunrise. |
| civilTwilightEnd | string | The timestamp of the end of civil twilight, defined as when the sun angle is 96° from vertical. This is the end of civil dusk, which begins at sunset. |
| nauticalTwilightBegin | string | The timestamp of the onset of nautical twilight, defined as when the sun angle is 102° from vertical. This is the beginning of nautical dawn and lasts until the civil dawn. |
| nauticalTwilightEnd | string | The timestamp of the end of nautical twilight, defined as when the sun angle is 102° from vertical. This is the end of nautical dusk, which begins at the end of civil twilight. |
| astronomicalTwilightBegin | string | The timestamp of the onset of astronomical twilight, defined as when the sun angle is 108° from vertical. This is the beginning of astronomical dawn and lasts until the nautical dawn. |
| astronomicalTwilightEnd | string | The timestamp of the end of astronomical twilight, defined as when the sun angle is 108° from vertical. This is the end of astronomical dusk, which begins at the end of nautical twilight. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/weather-gov/refs/heads/main/json-schema/weather-gov-astronomical-data-schema.json",
"title": "AstronomicalData",
"description": "An object representing sunrise, sunset, and twilight information for a location.\n",
"type": "object",
"properties": {
"sunrise": {
"type": "string",
"description": "The timestamp of sunrise, defined as when the sun angle is 90\u00b035' from vertical.\n",
"format": "date-time"
},
"sunset": {
"type": "string",
"description": "The timestamp of sunset, defined as when the sun angle is 90\u00b035' from vertical.\n",
"format": "date-time"
},
"transit": {
"type": "string",
"description": "The timestamp when the sun reaches its zenith.\n",
"format": "date-time"
},
"civilTwilightBegin": {
"type": "string",
"description": "The timestamp of the onset of civil twilight, defined as when the sun angle is 96\u00b0 from vertical. This is the beginning of civil dawn and lasts until sunrise.\n",
"format": "date-time"
},
"civilTwilightEnd": {
"type": "string",
"description": "The timestamp of the end of civil twilight, defined as when the sun angle is 96\u00b0 from vertical. This is the end of civil dusk, which begins at sunset.\n",
"format": "date-time"
},
"nauticalTwilightBegin": {
"type": "string",
"description": "The timestamp of the onset of nautical twilight, defined as when the sun angle is 102\u00b0 from vertical. This is the beginning of nautical dawn and lasts until the civil dawn.\n",
"format": "date-time"
},
"nauticalTwilightEnd": {
"type": "string",
"description": "The timestamp of the end of nautical twilight, defined as when the sun angle is 102\u00b0 from vertical. This is the end of nautical dusk, which begins at the end of civil twilight.\n",
"format": "date-time"
},
"astronomicalTwilightBegin": {
"type": "string",
"description": "The timestamp of the onset of astronomical twilight, defined as when the sun angle is 108\u00b0 from vertical. This is the beginning of astronomical dawn and lasts until the nautical dawn.\n",
"format": "date-time"
},
"astronomicalTwilightEnd": {
"type": "string",
"description": "The timestamp of the end of astronomical twilight, defined as when the sun angle is 108\u00b0 from vertical. This is the end of astronomical dusk, which begins at the end of nautical twilight.\n",
"format": "date-time"
}
}
}
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/weather-gov-astronomical-data"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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.