Every enumerated value the API can emit or accept, as data

Every enumerated value the API can emit or accept, as data. Formats: json. Some fields are currently withheld: The meteor_showers set is withheld until the meteor catalog reduction clears its license review. Example: GET /v2/enums?set=moon_phase_names

get/v2/enums

Request

  • Base URL: https://www.cyclecalcs.com
  • URL: https://www.cyclecalcs.com/v2/enums
  • Auth: one of:
    • none
    • API key in header X-RapidAPI-Key

Query parameters

set'ambiguous' | 'bodies' | 'body_aliases_refused' | 'cache_classes' | 'catalogs' | 'compass_points' | 'constellations' | 'cycle_families' | 'cycle_keys' | 'cycle_kinds' | 'day_anchors' | 'eclipse_kinds' | 'error_codes' | 'event_kinds' | 'formats' | 'frame_origin' | 'frames_parameter' | 'hemisphere' | 'include_tokens' | 'interval_kinds' | 'interval_reasons' | 'libration_favoured_limbs' | 'meteor_showers' | 'moon_phase_names' | 'moon_phase_names_south' | 'non_goals' | 'nonexistent' | 'position_origins' | 'query_modes' | 'refraction' | 'rights' | 'rise_set_event_kinds' | 'rise_set_special' | 'rise_set_statuses' | 'shape' | 'stars' | 'style' | 'sun_position_bases' | 'time_format' | 'timezone_sources' | 'verbosity' | 'visibility_phrases' | 'warning_codes' | 'zodiac_signs'

Which /v2/enums set to return. Mutually exclusive with endpoint. Omit both for every set.

endpoint'/v2' | '/v2/conventions' | '/v2/enums' | '/v2/attribution' | '/v2/positions' | '/v2/rise-set' | '/v2/sun' | '/v2/moon' | '/v2/time' | '/v2/seasons' | '/v2/apsides' | '/v2/moon-nodes' | '/v2/eclipses' | '/v2/planet-board' | '/v2/retrogrades' | '/v2/conjunctions' | '/v2/separation' | '/v2/rarity' | '/v2/cycles' | '/v2/twilight' | '/v2/dark-window' | '/v2/sidereal-time' | '/v2/equation-of-time' | '/v2/libration' | '/v2/jupiter-moons' | '/v2/sky-quality' | '/v2/places' | '/v2/phases' | '/v2/planet-events' | '/v2/today'

A v2 endpoint path (or its bare slug), to scope the response to that one endpoint.

formatstring

Response representation. Each endpoint serves a subset of json, csv and txt; see that operation's description for the exact list, or GET /v2 for every endpoint's formats array. An unsupported value is 400 BAD_FORMAT with the accepted list in supported.

precisioninteger

Decimal places for numeric fields.

pretty0 | 1

Whether the JSON body is indented (1) or compact (0). Has no effect on csv or txt.

verbosity'full' | 'compact'

full includes prose notes, frame definitions and withheld-field reasons in meta. compact keeps every value and every machine-readable name and drops the prose.

Response

The answer. Some fields are withheld; see meta.not_computed.

endpointstring required

The endpoint path that produced this response.

computed_atstring date-time required

A revision stamp, never a wall clock: identical requests return identical bytes, so a fixed_instant or reference response can be cached for a year and 304 stays reachable.

queryobject required

The request as understood: every resolved input (instant, location, presentation options) plus ignored, in the order spec-00 13.2 defines. Shape is endpoint-specific.

dataunknown required
linksobject required

Related URLs. self reproduces this exact response; docs is always present; others (page, spec, next, first, explain) appear where relevant.

metaobject required

Provenance: engine version, rights and attribution, cache class, accuracy statement, tzdb version, and endpoint-specific conventions (refraction model, horizon definitions, time scales, and so on). Never subject to fields projection.

attributionstring required

The credit line, byte-identical to meta.attribution.text.

docsstring uri required

The human-readable reference section for this endpoint.

Example response

{
  "endpoint": "/v2/sun",
  "computed_at": "2026-08-01T00:00:00.000Z",
  "links": {
    "self": "https://www.cyclecalcs.com/v2/sun?at=2026-06-21&lat=51.4778&lon=-0.0015",
    "docs": "https://www.cyclecalcs.com/api/reference.html#sun",
    "spec": "https://www.cyclecalcs.com/v2/openapi.json",
    "page": "https://www.cyclecalcs.com/sunrise-sunset-calculator.html",
    "explain": "https://www.cyclecalcs.com/learn/seasons.html"
  },
  "attribution": "Computed by CycleCalcs (cyclecalcs.com) with the MIT-licensed Astronomy Engine. Positional astronomy only.",
  "docs": "https://www.cyclecalcs.com/api/reference.html#sun"
}

Changes

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