# 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>
