venus-cycles

Range-based Venus conjunctions

Find every Sun-Venus conjunction (inferior and superior) in a date range, each computed from the ephemeris to about one second. The range may span up to 36525 days (100 years); a longer range is rejected with 422 rather than silently cut short. Inferior conjunctions are followed by a Morning Star phase, superior by an Evening Star phase (visibility). 🤖 AI-optimized output available — add format=llm to reduce payload ~60%.

post/ephemeris/venus-star-points/conjunctions

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/ephemeris/venus-star-points/conjunctions
  • 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

Query parameters

formatstring nullable

Response format: json | llm.

Headers

authorizationstring nullable
X-API-Keystring nullable
X-OpenEphemeris-API-Keystring nullable
apikeystring nullable

Request body

beams_orbnumber

Orb for under beams (default 17 degrees)

combust_orbnumber

Orb for combustion (default 8.5 degrees)

end_datestring required

ISO-8601 end date or datetime. A clock time must carry its own zone ('Z' or ±HH:MM); a zone-less clock time is rejected with 400 ambiguous_datetime. A date-only value resolves to 12:00 UTC.

start_datestring required

ISO-8601 start date or datetime. A clock time must carry its own zone ('Z' or ±HH:MM); a zone-less clock time is rejected with 400 ambiguous_datetime. A date-only value resolves to 12:00 UTC.

Response

Successful Response

successboolean

Status of the calculation

Example response

{
  "calculation_metadata": {
    "technique_id": "natal",
    "technique_label": "Composite (Davison)",
    "technique_method": "davidson",
    "technique_version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.