The discovery document: every endpoint, parameter, convention and limit

The discovery document: every endpoint, parameter, convention and limit. Formats: json. Example: GET /v2

get/v2

Request

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

Query parameters

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.

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.