# Request Parameters

Requests to the `body-position` end point are made as follows:

{% code overflow="wrap" %}

```
GET https://api.radiantdrift.com/body-position/[DATE_TIME_FROM][/DATE_TIME_TO]/?[body=BODIES|ra-decl=RA_DECL][&obs=OBSERVER][&alg=ALGORITHM][&extras=EXTRAS][&interval=INTERVAL]
```

{% endcode %}

### Request Parameters

<table><thead><tr><th width="198">Parameter</th><th width="121">Default</th><th>Description</th></tr></thead><tbody><tr><td>DATE_TIME_FROM</td><td>none</td><td>The desired start date/time in Universal Time, or the desired instant if DATE_TIME_TO is omitted</td></tr><tr><td>DATE_TIME_TO</td><td>none</td><td>The desired end date/time in Universal Time</td></tr><tr><td>BODIES</td><td>none</td><td>A comma-separated list of bodies. Allowed values are <code>sun</code>, <code>moon</code>, <code>gc</code>, where <code>gc</code> denotes the <a href="https://en.wikipedia.org/wiki/Galactic_Center">Galactic Centre</a>. Required if <code>ra_decl</code> is omitted.</td></tr><tr><td>RA_DECL</td><td>none</td><td>Comma-separated values for right ascension and declination in decimal degrees. Required if <code>bodies</code> is omitted.</td></tr><tr><td>OBSERVER</td><td>none</td><td>Comma-separated values for latitude, longitude (negative west), and elevation above mean sea level in meters; latitude/longitude values are in decimal degrees. Optional - if provided, local horizontal coordinates are included in the response</td></tr><tr><td>ALGORITHM</td><td><code>standard</code></td><td>Algorithm used to calculate positions. Allowed values are <code>standard</code>, <code>vsop-87a-tr</code> (truncated <a href="https://en.wikipedia.org/wiki/VSOP_model">VSOP87</a>, applicable only to the Sun, other bodies always use <code>standard</code>). <code>vsop-87a-tr</code> provides higher accuracy.</td></tr><tr><td>EXTRAS</td><td>none</td><td>Comma-separated list of optional extras to include in response. Allowed values are <code>distance-to-earth</code> or <code>d</code> (Sun and Moon), <code>illuminated-fraction</code> or <code>ill</code> (Moon only), <code>waxing</code> or <code>w</code> (Moon), or <code>all</code>. Either the verbose or abbreviated extra name may be used. Calculating this values may result in a (small) increase in call response time.</td></tr><tr><td>INTERVAL</td><td>60s</td><td>Interval in seconds (optional). When both <code>DATE_TIME_FROM</code> and <code>DATE_TIME_TO</code> are given, the interval determines the interval time in seconds for which positions are calculated. The minimum value is 1s.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.radiantdrift.com/body-position/request-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
