AstroJson logostroJson

Error Handling

The API returns standard HTTP status codes. On error, the response body includes a detail field with a human-readable message.

401Missing or invalid API key

The X-API-KEY header is missing, empty, or does not match a valid user.

400Invalid parameters

Invalid sign (must be a valid zodiac sign), unsupported language for your tier, invalid period, or invalid date format (use YYYY-MM-DD).

403Tier restriction

The requested date or period is not available for your subscription tier. Upgrade to access historical data or additional periods.

429Rate limit exceeded

You have exceeded your request limit for the current period. The response includes a detail message such as: 'Request limit exceeded (500 for free tier this period). Upgrade for more.'