AstroAsk Docs
API referenceWestern astrologyV1WesternRetrogrades

GET /v1/western/retrogrades

Retrograde calendar: exact station-retrograde and station-direct moments (with the turning degree) for one planet or all retrogradable planets in a date range.

GET
/v1/western/retrogrades

Authorization

ApiKeyAuth
X-API-Key<token>

In: header

Query Parameters

from*string

Range start (ISO 8601 date, e.g. 2026-01-01)

to*string

Range end (ISO 8601 date). At most 400 days after from.

lang?string

Language code for translation

planet?string

Restrict to one planet (Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Chiron). Default: all.

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/western/retrogrades?from=string&to=string"
{  "success": true,  "data": {    "from": "2026-01-01T00:00:00.000Z",    "to": "2026-06-30T00:00:00.000Z",    "planets": [      "Mercury"    ],    "periods": [      {        "planet": "Mercury",        "start": {          "planet": "Mercury",          "type": "retrograde",          "date": "2026-02-26T06:48:07.000Z",          "longitude": 352.56532539205887,          "sign": 11,          "signName": "Pisces",          "degreeInSign": 22.565325392058867        },        "end": {          "planet": "Mercury",          "type": "direct",          "date": "2026-03-20T19:32:47.000Z",          "longitude": 338.49075726119327,          "sign": 11,          "signName": "Pisces",          "degreeInSign": 8.490757261193266        }      },      {        "planet": "Mercury",        "start": {          "planet": "Mercury",          "type": "retrograde",          "date": "2026-06-29T17:35:52.000Z",          "longitude": 116.25735914717694,          "sign": 3,          "signName": "Cancer",          "degreeInSign": 26.257359147176942        },        "end": null      }    ]  }}