---
title: "Solar Events (Sunrise/Sunset/Transit)"
method: GET
path: "/time/solar-event"
tags: ["Time Conversion"]
---

# Solar Events (Sunrise/Sunset/Transit)

`GET /time/solar-event`

## Request

- Base URL: `https://api.openephemeris.com`
- URL: `https://api.openephemeris.com/time/solar-event`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-OpenEphemeris-API-Key`
  - API key in header `X-API-Key`
  - API key in header `X-Service-Key`

Compute exact times for sunrise, sunset, and solar transit for a given day and location.

## Query parameters

- `date` string, required: Date (YYYY-MM-DD)
- `latitude` number, required: Observer latitude
- `longitude` number, required: Observer longitude
- `elev` number: Observer elevation in metres above sea level. Lowers the visible horizon (dip ~ 1.76 arcmin * sqrt(metres)), which moves sunrise/sunset and moonrise/moonset earlier and later respectively - about 6 minutes per event at 1600 m. Default 0 reproduces the sea-level result exactly.

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable
- `X-OpenEphemeris-API-Key` string, nullable
- `apikey` string, nullable

## Response `200`

Successful Response

- SolarEventResponse
  - `date` string, required: The requested date
  - `events` SolarEventDetail[], required: List of solar events found for the day
    - `altitude_deg` number: Altitude in degrees (positive above horizon)
    - `azimuth_deg` number: Azimuth in degrees (0=North, 90=East)
    - `jd` number, double, required: Exact time as a Julian Day number
    - `time_iso` string, required: Exact time in ISO 8601 format
    - `type` string, required: Type of event (sunrise, sunset, transit, etc.)
  - `information` object: Metadata about the calculation engine
  - `latitude` number, required: Observer latitude
  - `longitude` number, required: Observer longitude

## Other responses

- `400`: Bad Request
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openephemeris/apis/open-ephemeris-api.md) · [All operations](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/revisions/d195a769cb89?raw)