IPGeolocation.io · Schema

TwilightPhase

Twilight phase times for either the morning (pre-sunrise) or evening (post-sunset) period. Includes astronomical, nautical, and civil twilight windows, as well as blue hour and golden hour windows commonly used in photography. All times are in `HH:mm` format by default. When the `time_zone` parameter is provided, times are returned as full date-time values in `yyyy-MM-dd HH:mm` format.

GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

Properties

Name	Type	Description
astronomical_twilight_begin	string	Start of astronomical twilight. In the morning, this marks the end of night; in the evening, this marks the start of night sky.
astronomical_twilight_end	string	End of astronomical twilight.
nautical_twilight_begin	string	Start of nautical twilight, when the horizon first becomes visible.
nautical_twilight_end	string	End of nautical twilight.
civil_twilight_begin	string	Start of civil twilight, when there is enough light for outdoor activities without artificial lighting.
civil_twilight_end	string	End of civil twilight.
blue_hour_begin	string	Start of the blue hour, a period of soft diffused light with a blue color tone.
blue_hour_end	string	End of the blue hour.
golden_hour_begin	string	Start of the golden hour, a period of warm low-angle light favored by photographers.
golden_hour_end	string	End of the golden hour.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-schema/astronomy-twilight-phase-schema.json",
  "title": "TwilightPhase",
  "description": "Twilight phase times for either the morning (pre-sunrise) or evening\n(post-sunset) period.\n\nIncludes astronomical, nautical, and civil twilight windows, as well\nas blue hour and golden hour windows commonly used in photography.\n\nAll times are in `HH:mm` format by default. When the `time_zone`\nparameter is provided, times are returned as full date-time values\nin `yyyy-MM-dd HH:mm` format.\n",
  "type": "object",
  "properties": {
    "astronomical_twilight_begin": {
      "type": "string",
      "description": "Start of astronomical twilight. In the morning, this marks the\nend of night; in the evening, this marks the start of night sky.\n",
      "example": "04:49"
    },
    "astronomical_twilight_end": {
      "type": "string",
      "description": "End of astronomical twilight.",
      "example": "05:21"
    },
    "nautical_twilight_begin": {
      "type": "string",
      "description": "Start of nautical twilight, when the horizon first becomes visible.\n",
      "example": "05:21"
    },
    "nautical_twilight_end": {
      "type": "string",
      "description": "End of nautical twilight.",
      "example": "05:53"
    },
    "civil_twilight_begin": {
      "type": "string",
      "description": "Start of civil twilight, when there is enough light for outdoor\nactivities without artificial lighting.\n",
      "example": "05:53"
    },
    "civil_twilight_end": {
      "type": "string",
      "description": "End of civil twilight.",
      "example": "06:20"
    },
    "blue_hour_begin": {
      "type": "string",
      "description": "Start of the blue hour, a period of soft diffused light with a\nblue color tone.\n",
      "example": "05:42"
    },
    "blue_hour_end": {
      "type": "string",
      "description": "End of the blue hour.",
      "example": "06:03"
    },
    "golden_hour_begin": {
      "type": "string",
      "description": "Start of the golden hour, a period of warm low-angle light\nfavored by photographers.\n",
      "example": "06:03"
    },
    "golden_hour_end": {
      "type": "string",
      "description": "End of the golden hour.",
      "example": "06:57"
    }
  }
}